Site Configuration Options
Site configuration menu allow administrators to configure the workings of MaterialMRT, from system behaviours to metrics and other global ;attributes. They include the following:
- Site Parameters. Define the modelling behaviour, and attributes of your zones, stockpiles, and event processing.
- Preferences. Configure how site-related information is handled by MaterialMRT.
- Material Properties. Review and manage material properties from various sources, such as the FMS and other databases.
- Resource Model Explorer. View, import, or manage geological and grade control blocks within your stockpiles and zones.
- Rules editor. Execute rules on selected data to validate the results as required.
- Zone Maintenance. Manage, import and create new zones.
Site Parameters
Adjust the attributes of the mine such as materials, zones and the behaviours to be modelled from this panel, these are listed in the following table:
Parameter | Description |
---|---|
Global |
Cuboid Length and Width: A cuboid is similar to a block model element except that its vertical size is variable. To set the length and width of the cuboid, enter its value in this field. Note: Cuboid length and width can only be changed if no materials have yet been modelled in the system. |
Typical Material Density |
The typical material density can be set in this section. Typical materials can be categorised as non-specific material such as waste or run-of-mine (ROM) material. In here, you can do the following:
|
Zone Category |
Zone categories allows you to determine whether a zone has a static or dynamic boundary. Use the checkboxes to enable or disable static boundaries. |
Rule |
Rules are scripts (TypeScript) used to validate data associated with the movement of material. Choose which rules are enabled for MaterialMRT to use. Grey checkboxes indicate mandatory rules. |
The cuboid stack modeller adjusts the behaviour of material that is added or removed from a stockpile. The settings are as follows:
|
|
Stockpile Boundary Modeller |
The stockpile boundary modeller is allows you to adjust the vertical modelling behaviour around a stockpile. The settings are as follows:
|
Domain Event Dispatcher |
The domain event dispatcher allows you to set the threshold of the number of events logged before they are dispatched to the system, and the lag time before a replay is triggered. The settings are as follows: Expedite Event Dispatch Threshold. Use the drop-down list to set the number of pending domain events required before events are dispatched without waiting. Example: When this value is 1, the event is immediately dispatched to the system for processing. When the value is set to 5, four additional events are buffered before they are dispatched. Real Time Lag Window Duration. Set a time range where event processing is delayed. When the an event reaches the lag time threshold, it is immediately dispatched. The following effects apply when setting the real time window duration:
To change the values for H, M, and S (hours, minutes, and seconds), you can enter the value directly into each field, or use the and buttons to increase or decrease the current value. |
Stockpiling |
Stockpiling allows you to set the age waste dump material reaches before being archived. You can select any of the following:
|
Preferences
Preferences allows an administrator to define the technical and operational characteristics of the mine site. To select a configuration category, click on a sidebar tab. To save your settings click the button.The preferences categories are as follows:
Preference tab | Description |
---|---|
Site Metadata |
Site metadata identifies the MaterialMRT web site instance, and can synchronise schedules with Evolution Epoch. The settings in this tab include the following:
|
CRS and Local Transformations |
Control how your terrain coordinate data is mapped. The parameters are as follows:
|
Units |
Set standard units for all metrics. Click the drop-down arrow to expand and choose the required unit of measure. |
Stockpile Status |
Choose the colour for undefined materials using the colour picker. |
Cesium Default Viewer Assets |
Add or remove viewer terrain (assets) Click to add a new viewer asset and enter required information in the following fields:
|
Zone Categories |
Review and manage the zone categories that are listed in this panel. Information is divided into the following columns:
|
Enter your language and regional settings in this tab. The following fields apply:
Tip: For each of the above, begin a typing your keyword to narrow the search. For example, if you type “US” into the Culture field, matches such as chr-US, en-US appear. You can do the same to find the correct Time Zone. Alternatively, open the entire list by clicking in any of these fields while it is blank. |
|
Shift Calendars |
Select the shift regime that is used at the site. Use the drop-down list and select the appropriate shift calendar. A shift schedule includes the Name (such as night shift), the Start, and End time of each shift. |
Viewer |
Use Viewer to control the amount of padding around the extents of all the combined zones. The unpadded extents will be a rectangle that is sized to fit the outermost extents of zones within the terrain. You can be easily visualise this by applying the following settings are used in the viewer:
Example
The following example shows the white boundary conforming to the yellow zone boundaries when they have no padding.
To set padding uniformly, do the following:
Example
The padding between the yellow zone borders and the white extents border. In this example, the padding value is 200 m. You can also define explicit minimum and maximum x- and y-axis (mine grid) coordinates as follows:
Example
Note the padding effect (particularly the vertical extents when custom settings are applied: To save your settings, click . |
Built-in Metric Colouring |
Manage the colour schemes for the following metrics. The following default metrics are included in MaterialMRT:
To edit any of these metrics, do either of the following:
|
Material Properties
The Material Properties Schema is where the information for each property is defined. Material properties describe the attributes or characteristics of a substance, material, or process to define its, composition, behaviour, or function. Many material properties are derived from the FMS or database. You can also add or modify material properties, see Adding a new material property. Material properties are shown in the list pane. In here, the Property, Type, and Source are itemised. Click on an item in the list to show its details in the properties editor.
The property types are defined in the table below:
Property type | Description |
---|---|
Numeric properties |
They are values which typically describe the following:
|
Text |
These are values, usually a character string, label or arbitrary items made up of child values with associated percentages, such as ‘Seam: {80% laa1, 20% bar1a}’. |
Lists |
These are to text but they do not have values associated with percentages. Trips is an example of a list property. |
Time |
This property is a label with an associated unit of duration. Disturbed is an example of a time property. |
Default system properties |
The following properties are built into MaterialMRT: Trips: A trip lists the trip keys/ids that are associated with a parcel of material. Note: Once there are more than 5 trips in this list it is emptied as tracking the material this way becomes more speculative. Movements : A movement tracks how many times a parcel of material has been relocated. Example: 1 movement from pit to ROM stockpiles, 2 movements then from ROM stockpile to sink. Disturbed: This is a time stamp for material when it was first loaded from the pit or stockpile. Tip Status: This is associated with the Dump Location Validation typescript rule. It can be any text value defined by the rule. |
Adding a new material property
To add a property, click on the at the top-right corner of the list pane, the New Material Property panel is displayed on the right-hand pane. Enter or select the required values as follows:
- Select the material property Type. This is either a List, Numeric, Text, or Time material property.
- Enable the Is trip only checkbox if the property will not be carried through to cuboid stacks, stockpiles, or outflows. The information is only retained in the trip for use in downstream systems that don’t reference MaterialMRT.
- Enter the Id in this field to make the material property identifiable to the system.
- Enter the Source System Key. This is the string used by the source system (such as Vulcan).
- Enter the name which is the verbose description of the material property in the Name field.
- Use the optional Tags field for adding additional descriptors to the property.
- In the Source field, open the drop-down list and select where the information is referenced from. If no source is chosen, it is assumed to be MaterialMRT. The options are as follows:
- From FMS
- From Geological Model
- From Grade Control Model
- From On Belt Analyser
- From Lab Result
- Complete the remaining fields. The required information depends on the material schema type. Refer to the tables below describe the relevant fields used in each material type.
- After completing the information in the material properties schema editor, click on the button at the bottom of the page to add it to the system.
Note: Fields marked with an asterisk (*) are mandatory.
Time attributes table | |
---|---|
Duration Display Unit |
Select the required time unit for this property. |
Colour Map |
The current colour map is displayed in this section. To change or edit the colour map, click on the button to open the colour map editor. To use the colour map editor refer to the colour map instructions in the Numeric attributes table. |
Resource Model Explorer
The Resource Model Explorer is an administrative tool that displays and lists grade control and geological block models within a zone. To open the resource model explorer click on () in the system management bar, and select Resource Model Explorer.On the Resource Model Explorer page, you can perform the following tasks:
- Edit existing geological and grade control model properties.
- Delete properties, blocks or models.
- Add new models by creating a new label and import associated geological and grade control blocks.
- View and query the properties and associated values within a geological or grade control block.
Source data is organised into blocks that contain the following information:
- Material properties contained within the block (numeric text or list property).
- The original volume of that block .
- The remaining volume of that block.
Importing geological and grade control models
Data updates are supplied the by importation of csv files and their accompanying blocks in dxf or obj file formats. To import a resource or geological block model, follow these steps:
-
Click on the Import tab, to open its panel. If you are importing files directly from an external source, proceed to step 3.
-
To create your own resource model, click on the button to open its form. Enter the Model , Type (geological or grade control blocks), Owner, Version, and Priorityinformation, and enable the Is Active checkbox if required.
-
In the Import panel, do either of the following:
- Click within the Drop CSV and triangulation files here drop target to open a file manager instance and select your files.
- Open your file manager manually, navigate to the source; drag and drop files directly into the drop target. The selected files are displayed in the drop target.
Note: Models are only imported if the blocks (.obj or .dxf) and .csv files are present. The data pair must have the same file name preceding the file extension. If a required file is missing, a notification is displayed under the drop target.
- When all the required files have been selected, click . A list of blocks is displayed.
- Click the checkboxes to deselect any unwanted blocks, then click on to finalise the import . A confirmation dialog appears after completion.
Visualising blocks and their properties
The resource model explorer uses a viewer that displays the following features:
- The boundary containing grade control models (shown in light blue).
- The boundary containing the geological block models (shown in light green).
- The grade block (resource) models.
- The geological block (reserve) models (See Revealing geological blocks.)
Changing your camera angle and perspective
Change your camera angle and the field of view using the mouse. You can perform pan, tilt, and zoom actions using the appropriate mouse or keyboard buttons.
Follow these links to learn how to use the viewer:
- To enable or disable features in the viewer, see Viewer controls.
- To learn how to change the orientation of your view, see View manipulation (panning, rotating, and zooming).
- To create a polygon to select an area of interest, see Making polygons to create an area or zone.
Selecting block models to view
Block models from all imported resource models appear in the view. To quickly centre your view to a specific resource model, select it from the Resource Models drop-down list under the Explore tab.
Tip: Blocks can also be selected by moving around in the view, however, when you select a resource model from the list pane, it is centred and scaled into your view.
Revealing geological blocks
Geological blocks are not automatically shown in the view. The quantity of blocks can be vast, impacting on the time taken to present the data. To view geological blocks, create a polygon over the area of interest, following these steps:
- Select the explore tab in the list pane.
- In the Resource Models drop-down list, select an item containing the suffix - Geological. The viewer will show a transparent green area in a green border.
- Click on the button and form your polygon. For more information, see Making a polygon to select an area.
- Click on in the viewer to complete the polygon (Click on to cancel). The blocks within your selection are displayed, and the list pane is populated with corresponding Block id, Centroid (coordinates), Size (block dimensions) , and their Properties.
Querying material properties of blocks
Each block has material properties assigned to it, including the colour scheme indicating the grade of that property. There are two ways to view material properties:
- Pop-up view: This method is best suited for have a quick view of a selected item. A pop-up can be achieved in the following ways:
- Click on a grade control block in the viewer to display to display the properties in that block. (The mouse must remain over the block.)
- Hover over an item in the Properties column in the list pane. This works for graded control and geological blocks.
- Property editor: This method is ideal for examining and editing the contents of a grade control block. To open the property editor do the following:
- Double-click on a grade control block to open this panel. This panel also allow for properties to added, removed, or altered.
- In the list pane, click to open the property editor.
You can easily locate a block from the list, or locate a listed item using the viewer by doing any of the following:
- Hover over a grade control block to highlight that block.
- Click on a grade control, or geological block to find it in the explore tab list. If you are viewing geological blocks, If you are viewing geological blocks,you may need to change the viewing angle to see and select a specific block.
- Click on a grade control, or geological block in the explorer tab to locate the block in the viewer. If you are viewing geological blocks, you may need to change the viewing angle to see highlighted block.
Managing existing geological and grade control models
Click on the Manage tab to view its contents. From the Manage tab you can:
- Search for a model by entering the name into the search field.
- View the list of all the models.
- Add a new model ). See Importing resource models.
- Edit the (Model) name, Version, and Ownerof the model.
- Set the reserve status as being Active (or disable it).
- Delete the model from the system.
Editing a model’s basic information.
To change the model’s name, version, or owner information, click directly into its field and begin typing. Click to save your changes.
To set the Active status, enable its checkbox . Click on to save the setting.
To delete a model (and its associated blocks), click . When the confirmation dialog appears, click .
Rules Editor
Rules are script-controlled automations that perform data evaluation and validation using specific datasets, such as trips, resource models, and other properties. The TypeScipt editor allows you to modify your rules as needed, then you can run the script to validate the test.
Selecting a rule to edit
Click the drop-down list to reveal the list of rule and tap on an item to select it. The script is shown in the editor. The standard rules are listed in the following table:
Script Name | Function |
---|---|
Trip Validation |
The rule is run when viewing trips on the Trip Editor page. This script performs the following functions:
If trips return error or warning validation results, the applicable column is coloured in red or orange respectively. |
Payload Auto Correction |
This rule is used by the Trip Editor . When user selects the Auto Correct option to batch modify payload masses, it takes the current haul truck trip. :todo: what does “it take the current haul trip...” |
Trip Auto Correction |
This rule is run every time a truck trip is processed. This rule is able to modify any value available on the HaulTruckTrip model used by the rule such that it does the following:
|
Resource Model Property Setter |
This rule is run by the engine every time a truck trip is processed. This rule is used when selecting a grade control or geological model block to associate with a load event that a truck. |
Dump Location Validation |
This rule is associated with the Tip Status material property. It is run every time a trip is processed and determines if the material was deposited in correct location. |
Using the rules editor
Edit scripts in the editor pane following TypeScript convention. The following steps are recommended when you edit a script:
- Make the required changes to your script.
- Test your script in the Testing panel. See Testing your script. Note: an error message is displayed if an attempt to save the script is carried out before testing.
- When the script is successfully validated, click .
Testing your script
Testing your script is mandatory, it prevents possible widespread errors from infiltrating the system. To run your test, do the following after making changes to a script:
- Decide whether to run a Bulk or Single iteration by selecting the Bulk or Single radio button. A bulk test runs the script from a selected date range or shift. A single test is applied to a particular trip or instance.
- Follow the step for the selected test type:
- If you are performing a bulk test, open the calendar picker () and select a custom time range. You can also select preset periods by expanding the drop-down list control ( ) .
- If you are performing a single instance test, enter the Trip id.
- Click to execute the test. The results are displayed in the report window . An example is shown below.
- Click to save your script.
Tip: You can use a light or dark theme for the editor pane. To do this, click open the Editor Settings panel and enable the radio button matching your choice.
Zone Maintenance
Zone Maintenance allows you to add, modify, or remove zones within the site. You can also export all your zones as a .kml, .json, or .dxf file. To open the zone maintenance page, expand the site configuration menu () and click on . Zones are organised in the list pane and displayed in the viewer as blue polygons, when selected.
Managing your zones
Existing zones are listed under the Manage tab. In here you can do the following:
- Search Name. Search for items by entering a keyword into the search field. The search looks for matches in the Name column.
- Select a zone. To make a selection, click on a listed item. When a zone is selected this way, the zone’s Name, Category, and File Units are shown in the zone editor next to the list. You can also use the viewer to identify and select the listed zone.
- Edit existing information for an existing zone. To do this, select the zone from the list or using the viewer. In the zone editor, you can change the name, category, and file units used by that zone.
- Create a zone manually. Create a polygon over the intended area. To learn how to do this, see Creating a new zone.
- Import a single zone. Import a .kml, .json, or .dxf file containing the zone into MaterialMRT. To learn how to do this, see Importing a zone.
- Delete a zone. To delete a zone, select it from the list and click the button. A warning dialog appears to confirm your request.
Creating a new zone
To create a new zone from scratch, do the following:
-
Click to open a blank form in the information pane, then enter the following information:
-
Zone Name: Enter the name of the zone
-
Category: Select the appropriate category from the drop-down list. If the category type is a sink, additional field open requesting the following information:
-
Conveyor speed: Enter the speed in this field.
-
Flow rate: Enter the flow rated in this field.
-
Distance to analyser: Enter the distance from the zone to the analyser.
-
Distance to lab sampler: Enter the distance from the zone to the lab sampler.
-
-
File Units: Select your preferred unit of measure from the drop-down list.
-
-
Click on the add polygon button () and plot the area. Press Space to complete the polygon.
Tip: For details on creating an area, refer to Making polygons to create an area or a zone in General Concepts > Viewer controls.
-
Click to the save the zone. The zone becomes light blue with a solid blue border.
Tip: If you need to adjust or reposition the polygon, click on to enable editing. After you finish editing, click on to save your changes. For information on editing controls, see Modifying an area polygon in General Concepts > Viewer controls.
-
Click the button located at the bottom of the zone editor to finalise the newly created zone. The new zone is added to the Zones list.
Importing a single zone
Another method of adding
Importing multiple zones
Zones can be imported from an external source. The supported file formats are .kml (Keyhole Mark-up Language), .json (JavaScript Object Notation) or, .dxf files. Navigate to the source file by clicking on the drop-zone or dragging files into the drop-zone and clicking . The new zones will appear in the Zones list.
Note: If a file containing multiple zones is used, only the first zone is imported, all the others are disregarded. To import zones in bulk, use the Bulk Add New Zones function.
Importing zones
Import Individual (.kml, .json and .dxf) files containing multiple zones by following these steps:
-
In the import stockpile surfaces page, add your files using either of these methods:
-
Drag and drop your files into the drop-target directly from a file manger.
-
Click inside the drop target to open a file manager instance, then navigate to, and select your files.
-
-
Once you have selected your files, they will appear inside the drop-target and also in a list below it. You then have the following options:
-
Use the checkboxes to individually select or exclude files to import, or use the top checkbox to select or deselect all files.
Tip: You can also individually remove files by hovering over a file in the drop-target and clicking on the button.
-
Remove selected files from the list using the button.
-
Remove all files from the list using the button.
-
Set the As of time that the ground surface comes into effect using the calendar picker().
-
Search for files using the Search File Name field.
-
-
To import your files, click on the button.
- Click on Bulk Add New Zones hyperlink. A new tab is opened on your browser called Bulk Zone Import.
- Drag the file containing your zones into the drop-zone (rectangle with dashed border) or click inside the drop zone to open the file explorer, then navigate to the file and select it.
Note: Once a file is dragged into the drop-zone, a list of zones are presented below the drop zone. You can search for file names in by typing in the Search File Name field. To remove unwanted files you may use and buttons to remove selected files or all files from the list respectively.
- Select the zones to be imported using the check box (or selecting all) and click .
Tip: If you want to ground scan data to set the zone elevations, check Ignore the kml/json heights check box.
Control | Description |
---|---|
Search Name |
Search for items by character matching your search criteria. The search looks for matches in the Name column. |
Zones |
Lists current zones by name and category. This list has the following functions
|
Sort order | In the Zones list, click on the column header for Name or Category to change its alphanumeric sort order The upwards pointing arrow being A-Z (and numerical equivalent) and downwards pointing arrow indicating Z-A and 9-0. |
Zone Name |
This field allows you to edit or add a name for the zone. |
Category |
Click the drop-down arrow to expand and select from the following options:
|
Capacity |
Enter a value for capacity for the unit of mass used. |
Drop-target |
Use the drop-zone to import .kml, .json, or .dxf files (your zones). You can drag and drop files directly or click in the drop zone and navigate to the file location. See importing a zone. |
|
The selected zone in the Zones list is deleted. A confirmation dialog appears before deleting. |
|
Click to cancel importing a new zone file. |
|
Click to save a newly-created or imported zone file. |
|
Add polygon button. Starts the in-viewer polygon editor. Refer to Making polygons to create an area or a zone |
|
Edit polygon button. Click on it to continue editing an existing polygon after it has been saved. |
|
Save polygon button. |
|
Cancel polygon button. The polygon is not saved. |
Show Stockpile Boundaries |
Toggle the switch to show or hide the boundaries of existing stockpiles.
|
|
Go to position. Enter the coordinates in the dialog box and click Go. |
Bulk Add New Zones |
Click Bulk Add New Zones to open the Bulk Zone Import page. Refer to Importing zones in bulk. |
|
Click this button to export your current zones. A drop-down list allows you to choose between .kml, .json or .dxf file formats. |