MSO Manual - Mine Solutionsminesolutions.com/wp-content/uploads/2015/10/MSO_Manual.pdf · MSO...

vComp Pty Ltd (ABN 39 103 040 311) PO Box 7356 Cloisters Square Perth WA 6850 Australia

of 38

MSO Manual

4th July 2015

Overview

The Mine Survey Office (MSO) application is used to process and create raw files from the Leica Geosystems range of survey equipment. The application will read data from the GRE3/GRE4, TPS1000, TPS1100, TPS1200, TS15, and also supports GPS1200 instruments. The application will also create data files ready for use on these instruments from a Surpac string file or from a survey station database. The application can read and write directly to the Leica system DBX database, this eliminates any requirement to convert data onboard the instrument.

The application uses a FLD (Field) file to process data. The FLD file is generated from the GSI or DBX file. This file makes it very easy to view edit and interpret observations. The FLD file is explained in detail later.

Mine Survey Office Product Manual V2.04 4 July 2015

of 38

User Interface All functions are available from the Mine Survey Office toolbar and menu (found under the Applications menu in Surpac)


of 38

MSO Icon Description

Download from instrument

Upload to instrument

View instrument collimation log

View processed job log

MSO configuration editor

File processor utility

CSV Submenu

Export stations to csv file

Import stations from csv file

Export strings to csv file

Import strings from csv file

Administration Submenu

Create MSO share point

Remote support client

View license details

Get site code

Register license


of 38

MSO supports the 3 different icon sizes that are available in Surpac V6.3 and later. By default Surpac will use medium size icons for the toolbars. You can change this setting in the Surpac default preferences editor as shown below using menu option Customise � Default preferences.


of 38

Form Defaults Management The user interface includes linking into to the Surpac defaults management system. This is active on all forms for all MSO functions. If you right click in the active field on a form you are now presented with the following popup menu.

At the top of this menu you will be presented with the last 5 values that have been previously entered into this form which you can quickly select. (Note the example above only has 2 previous values shown) You can also select the Last value for all fields option which will set all fields on the form the their last entered values You also have access to help via the Form Help and Field Help items The last 4 options on the menu allow you to set the default behaviour for the active field. This will be persistent for the form on all future runs.

• Last value if blank defaults this field to its last value when the input field is blank (ie MSO hasn’t put a particular value into this field)

• Last value defaults this field to its last value all the time

• Constant allows you specify a value that will always be the default for this field

• Application has no effect in MSO forms


of 38

MSO Configuration The configuration editor allows you to easily setup and maintain surveyor and mine information along with MSO default options and settings. MSO Version 1 defaults can also be imported using the import button on the initial screen.


of 38

Surveyor Details The Surveyor details are presented in a tree view. To add a surveyor, press the New Surveyor button in the right hand pane as shown below. A new tree leaf will be created where you can enter the new surveyor information. To delete a surveyor from the configuration, highlight the surveyors name in the tree so their details are displayed. Once the surveyor information is displayed, press the Remove Surveyor button to delete this surveyor.

Surveyor Name - the surveyors full name for display in MSO reports and surveyor selection lists Initials - the surveyor’s initials, used in MSO reports Authorisation / Registration Status - the surveyor’s authorisations level as per the available options in the drop down list Auth / Reg No - Enter the surveyor’s authorisation number, used in MSO reports. Acting Under - Enter the initials or the surveyor in charge


of 38

Mine Area Details The Mine Area details are presented in a tree view. To add a mine area, press the New Mine button in the right hand pane as shown below. A new tree leaf will be created where you can enter the new mine area information. To delete a mine area from the configuration, highlight the mine area name in the tree so their details are displayed. Once the mine information is displayed, press the Remove Mine button to delete this surveyor.

Mine/Area Name – the identifying name for the mine / area. Used in selection lists through MSO Stations Database 1 – the primary database used to find referenced survey station data. Station Database 2 – an optional second database to be searched for station data when processing Log File Name and Location – The full pathname to a log file to record all processed jobs for this mine area. If left blank no logging is performed


of 38

Backup Directories – after processing files can be copied in backup directories for data management. Enter the directory (folder) names where the files should be copied. Note that you can use special symbols in the directory name that will be substituted at run time. These symbols are:

%m – substitutes to the month number (01 - 12) %b – substitutes to a short month name (Jan, Feb, Mar, ...) %B – substitutes to a full month name (January, February, ...) %d – substitutes to the day of month (01 - 31) %y - substitutes to year in short format (00 - 99)) %Y - substitutes to year in long format (eg 2013))

Examples:

X:/Mining/Survey/Pickups/%Y/%B would become X:/Mining/Survey/Pickups/2013/July

S:/Production/SurveyJobs/%Y-%m-%d would become S:/Production/Survey/Jobs/2013-04-22


of 38

Download Options

The Download options are where you setup defaults and settings for processing a job. The options are the same as was used in MSO V1 with the exception of a new default setting which allows you to specify the name of the Surpac styles file to set into the header of the created pickup string file. By default it will use SSI_STYLES:sysles.ssi but if you have a customised style set then use this option to set it as the default.

Default Settings

Input Format – this sets the default input format to be used when processing a job. DBX Type – when processing DBX data this sets the default more of either TPS or GPS GPS Height – the default height method for processing GPS data. Method – the default processing method to use Default Styles File - the Surpac styles file to set into the header of the created string files. If blank it will use SSI_STYLES:sysles.ssi.


of 38

Processing & Reporting

Offset point - select rules for offset codes as follows

- next only - will use the offset information for the next observation line only

- for all following - will use the offset information for all following observations.

Note offsets are only used for TPS observations when processed using polar or polar cartesian method. Display resection results – select to display a window showing the resection station name and the results. Note the resection results are always displayed in the message window. Display back measure – select to display a window showing the back measure station name and the results. Note the back measure results are always displayed in the message window. Display FLD file during processing – select to display the FLD file in a text editor for viewing or editing. Changes can be made to the FLD file and saved. This modified file will then be processed.


of 38

Display DAT file after processing – select to display the DAT file in a text editor for viewing. String File Settings

Display Strings Method - select which method to used load strings into the graphics window, either append or replace. Display stations – select to display the referenced stations in graphics Station string number - the string number used to display stations Display DDH collars – select to display the DDH's in the string file. DDH string number - the string number used to display DDH's Assign Description fields – when generating a string file MSO can populate the first 8 description fields of the string file with a number of pieces of information from the processed job. Selections are

• Point number – the point number from the job

• Job name – name of the job

• Surveyed Date – the date of the actual survey


of 38

• Process date – the date the job was processed in MSO

• Survey by – name of the surveyor who completed the survey

• Process by – name of the surveyor who processed the job in MSO

• Instr name – the instrument name

• Instr number – the instrument number

• Point description – use the point description table to assign a value Point_description Lookup Table – if a description field is set as “Point description” then the point description lookup table is used to assign a value into the description field. The lookup will match the string number from the job and then assign the corresponding description value into that field. If the is no matching string number the field is left blank.


of 38

Upload Options

The upload options tree allows you to set defaults and settings when you process data to be uploaded to the instrument card. Default Settings

Output Format - the default output format for uploading data Default output directory - the default output directory. This can be changed if required when uploading Use job name as directory – instruments using the Viva operating system can write jobs onto the card and organise them into folders under the DBX directory. Select this check box if you wish to use this facility


of 38

RefSet Defaults

DBX file to card – select if you use an SD card to transfer data to the instrument. Set the default drive and directory to copy DBX files too. GSI file to card – select if you use an SD card to transfer data to the instrument. Set the default drive and directory to copy GSI files too. STR file to card – select if you use an SD card to transfer data to the instrument. Set the default drive and directory to copy string files too. GSI file to PDA – select if you use RefSet on a PDA device. Set the default drive and directory to copy GSI files onto the PDA. GSI file to PDA – select if you use RefSet on a PDA device. Set the default drive and directory to copy string files onto the PDA. Note that if you use a PDA device files can only be copied if you have ActivSync or Windows Mobile Device Centre installed.


of 38

Upload Styles

When uploading line colours to the instrument be aware that if you use a black background in Surpac and elect the 'use colours specified in string styles file' option that the colours may not appear as clear on the white instrument screen. You may need to setup different colours in the table shown below Line Styles – select the method to use for line styles.

• Use styles specified in the string styles file – if the string file to upload has a specific Surpac styles file associated with it line styles from that file will be used otherwise SSI_STYLES:styles.ssi is used.

Note that patterns styles may vary because the instrument does not support as many line patterns as is supported in Surpac therefore approximations are made.

• Use custom styles table – a custom styles map can be created to define colours, line types, and thickness, etc. (see over)

• Do not use line styles – do not use any special line styles. Lines will be solid and black.


of 38

Custom Styles Table – setup line styles for specific string number of string ranges. To add a line to the colour table right click the mouse over the table and elect to 'Add'

• String Range – enter the string number or string range that this line in the table applies to

• Colour – enter the line colour to use for this string number or range

• Pattern – enter the line pattern to use for this string number or range

• Width – enter the line width to use for this string number or range


of 38

Create MSO Share Point If you have multiple MSO users and wish to share the configuration file between all users you need to create a MSO Share Point. This is simply a directory on a common network drive that is visible to all MSO users. To create the share point, execute the Function and nominate the share point folder. This needs to be done on all computers. Note that the configuration (previous section) only needs to be setup on one computer. Once the share point is created simply run the configuration editor and then apply. This will automatically save the configuration to the share point so all users can now use it.


of 38

Download from Instrument (Process Job)

The processing method used is to convert a raw instrument file into a standard format file. This file has the extension FLD, short for Field file. The FLD file can then be reviewed and modified before the final stage of processing. This gives several advantages, including better quality assurance as the raw files does not need to be modified, and one standard format that is easy to interpret, giving the surveyor processing the file a good understanding of what was recorded in the field.


of 38

Input Format - select the input format to be processed. This can be the Leica DBX format, Lieca GSI format, or the MSO FLD format if reprocessing a modified job. DBX Type - when processing Lieca DBX data you must specify whether it is TPS or GSI format. GPS Height - when processing GSI data you must also specify the height method used, either orthometric or ellipsiodal. Method - select the method of processing

• Polar & Cartesian – use a combination of both observations and coordinates to calulate reults

• Polar – use observed angles and distances and ignore all coordinate values used on the TPS. Note that this may result is small differences between solutions

• Cartesian – use only TPS calculated coordinates and will ignore all other measurments

Surveyor - select the Surveyor name from the available list. Note that the surveyor details are setup using the MSO Configuration Editor Mine Area - select the mine area from the available list. Note that the the mine area details are setup using the MSO Configuration Editor Job Filename - use the brwoser button to select the job filename to process.


of 38

Upload to Instrument

Output Format - select the output format that you want to use. Options are:

• Leica DBX – use this format for the TS15 and 1200 series instruments that support the on board database

• Leica GSI – use this for older instruments that only support the lagcy GSI format’

• FLD – use this opton to create a MSO format field file

• DXF – use this option to upload a DXF file direct to the card. The DXF file can then be attached as a CAD file to your job on the instrument.


of 38

Input Data Type - select the type of input data to be uploaded to the instrument. Options are

• String File – use this option to upload points from a Surpac string file. Uploaded points are organised into lines in the DBX files. This permits you to select lines of points in the various onboard applications.

• Station Database – use this option to upload survey station coordinates.

• Digital Terrane Model – use this option to upload surface (DTM) data for use in the stakeout DTM and stakeout DTM & points on board programs.

Input Filename - select the input file as per the selected input type. This will either be a Surpac String file, Surpac Survey Station Database, or Surpac DTM file. In the case of uploading a DXF file you will be prompted to enter any number of Surpac string files and optionally a range of strings file these files, Output Directory - select the output directory for the uploaded job. This would usually be the SD card reader attached to the computer. Job Name - enter an identifying name for the uploaded data Use Job Name as a Directory - when uploading data to the DBX format the job name can be used as a folder name under the DBX directory on the card. Note that this option only works with the TS15 and not the 1200 series instruments. Note Uploaded lines can have presentation styles associated with them. Lines can carry colour, pattern, and width data in the DBX files. The styles either come directly from the Surpac styles file associated with the data being uploaded, or you can set up a custom styles table. See the Configuration editor description in this document for further information.


of 38

DXF Interface You can upload dxf files to the instrument selecting the DXF output format.

String filename – enter or select the string file or files that you wish to convert to dxf for uploading String range – You can specify a valid string range so that only certain strings in the nominate file are processed to DXF. DXF output filename – name the DXF output file to be created on the card including the full path to the Data directory


of 38

RefSet Interface You can create data suitable for use with the RefSet on board program by selecting the RefSet output format

Input filename – select the string file containing your set out information. String range – you can enter a valid string range to only process certain strings from your input file or leave blank to process all strings in the file. Point Id from – Select the string description field that contains the point Id’s. You can select PTNo to have sequentially numbered point Id’s generated for you. Upload name – enter the name to identify the job to be created


of 38

DBX file to card – select if you use an SD card to transfer data to the instrument. Set the default drive and directory to copy DBX files too. GSI file to card – select if you use an SD card to transfer data to the instrument. Set the default drive and directory to copy GSI files too. STR file to card – select if you use an SD card to transfer data to the instrument. Set the default drive and directory to copy string files too. GSI file to PDA – select if you use RefSet on a PDA device. Set the default drive and directory to copy GSI files onto the PDA. GSI file to PDA – select if you use RefSet on a PDA device. Set the default drive and directory to copy string files onto the PDA. Note that if you use a PDA device files can only be copied if you have ActivSync or Windows Mobile Device Centre installed.


of 38

View Collimation Log

The view collimation log allows you to view the collimation reports for the various instruments you use on site.


of 38

View Survey Log

The view survey log allows you to view the processed job reports for a particular mine area.

.


of 38

File Processor Utility A general purpose file processing tool has been included into MSO. This utility function allows you to easily browse and select files from a given base directory and then have them displayed in a tree view. Files selected from the tree view will then be processed by your nominated function, which can include a custom macro. See below:

File search start point defines the base directory from which files will be searched, including subdirectories File type describes the type of files that you wish to search for. This includes All Files, Surpac String Files, Surpac Plot Files, etc. You can also enter any file mask you like, i.e. *.lf Special match criteria allows you to further restrict the searched files by specifying a standard string match expression. This maybe blank or can include special characters such as:

* Matches any sequence of characters in string, including a null string

? Matches any single character in string

[chars] Matches any character in the set given by chars. If a sequence of the form x-y appears in chars, then any character between x and y, inclusive, will match. To match all characters try [A-Za-z]

Once the Select Directory form is applied the Process Files form is shown which allows you to select and deselect files from the tree as required. On this form you nominate the process to perform on the files once the form is applied.


of 38

Why Use the File Processor? Some example usages for process files:

1. Load a number of large CMS files into graphics in one step 2. Load a number of selected plot files into plot preview 3. Search and load all files for a particular level 4. Set a styles file into the header of a number of string files 5. Copy a set of files to another location maintaining the directory

structure 6. Easily clean up files that are scattered over a number of directories 7. Create your own macro to process the files to solve a site specific issue


of 38

Custom Tcl Macro You can create your own macro and tell the file processor to run it when the form is applied. You macro will have access to two variables:

1. baseDir � this contains the name of the base directory were your file search began

2. fileList � this is a Tcl list of all the files that were selected on the file process form. The code example below shows how to process the list.

foreach fileName $fileList {

puts “Processing $fileName”

# Your custom code goes hear

}

CSV Tools

A suit of functions has been introduced into MSO for importing and exporting string and station data to and from CSV files. These are available from the MSO Menu or from the CSV drop down menu on the MSO toolbar.

Export Stations from CSV

Data can be exported from the Survey database (both old and new formats) according to a range of criteria. You can constrain the export by the following means

a. By level or area name (ie 3500 level) b. By matching station Id’s (ie ST40*) c. Between station Id’s (ie ST0220 and ST0280) d. By a database field value (ie RL = 2500) e. Export all stations


of 38

You then nominate the order of output to the CSV file and wether you wish to include a header record.


of 38

Import Stations from CSV

Data can be imported to a Survey database from a CSV file that may or may not contain a header record. You can elect to update the date stamp and also recalculate the reverse bearing between stations on the upload. An easy field mapping system to assign CSV columns to string fields is then shown.

You are asked to confirm details for each station prior to it being inserted or updated in the database


of 38

Export Strings from CSV

String data can also be easily dumped to a CSV file. You have full control over what string information is exported and whether you want a CVS header record created. An easy to use field mapping system to assign CSV columns to string fields is then presented where you also customise the CSV column headings.


of 38

Import Strings from CSV

Data can be quickly and easily imported from a CSV file to a String file. The function handles CSV files with or without a column header. This function differs from other CSV import functions because it allows you to organise the import by sorting data on up to three fields as well as providing a column to determine if and when a string segment should be started.


of 38

MSO Administration Tools

The License and Utilities menu provides access to MSO administration tools.

The Create share point option was discussed earlier in this document. It is used to share the MSO configuration between users on a network folder.

Remote Support Option You can access the new remote support option from the Mine Solutions submenu (found on the Surpac Applications menu);

or the Mine Survey Office toolbar;


of 38

Selecting this option will permit Mine Solutions support to remotely log onto your computer to assist with problem detection and resolution. As this is an internet link you will need to give the program permission to run. Once you have done this the remote client will display as follows

All that is required from here is for you to email the 9 digit ID number and 4 digit Password to [email protected]. Please note the password is session specific and that the remote client must be running to permit access to your computer.


of 38

New MSO License System

MSO V2 now uses the standard Mine Solutions licensing system. Your old MSO V1 activation keys are not valid in V2. License documents and tokens files will be distributed once company purchase orders are received for the upgrade fee. The new license mechanism works on both standalone Surpac licenses and also the Surpac License Manager (SSIlm). When using a Surpac network license the MSO token maybe registered on as many computers as required but only the licensed number of users can run at any one instance. For example if it is a 1 user license of MSO then only one user can run (be active) at any given moment, even if the license is registered on 3 computers.

View License Details The view license details option displays the current status of your MSO License.


of 38

Get Site Code MSO is licensed to a particular site code which is embedded in the Surpac sentinel. This option will retrieve that code. The code can be written to a file that can be emailed to Mine Solutions for generation of a license token.

Register License This option allows you to register the MSO license token. Normally tokens are distributed in a Mine Solutions token file (.tok). If the file is copied into the base Mine Solutions directory then the license information will automatically be searched and the form should be pre-filled. Note that you need computer administration privileges to register a license.

MSO Manual - Mine Solutionsminesolutions.com/wp-content/uploads/2015/10/MSO_Manual.pdf · MSO...

Documents

Transcript of MSO Manual - Mine Solutionsminesolutions.com/wp-content/uploads/2015/10/MSO_Manual.pdf · MSO...