If you were wondering what a bored Xman does in their free time, this might give you an indication…..
You should know by now that mXrap is very flexible and apps can be developed to perform a very wide range of functions. If you were doubting that, this might change your mind :)
Ever played the puzzle game known as 2048? Well now there is an mXrap version!
The mXrap version has buttons for each of the four moves ( Up, Down, Left, Right ) which controls the game board in the 3D view.
If 2048 is not your cup of tea, how about a spot of Backgammon? This is two player and each player rolls the dice and selects where to go from the list of possible moves.
Both of these games were built using the Beta version of mXrap so we can’t send them to you just yet. Once the Beta version is stable we’ll upload the games to mXsync for you to play around with. It will be good motivation for you to learn mXsync :).
Some things you see in mXrap are properties of the software, while other things are properties of the root folder.
We often use the software Excel as an analogy. Excel has many built-in capabilities with endless possibilities for creating specific calculations. The software has powerful capabilities, but without a user constructing the spreadsheet, the power and value are not fully utilised. An Excel user can set up a spreadsheet which, with the required inputs, will provide you with results. This user can then provide you with that spreadsheet, which you can then use to perform the same calculations with other inputs.
mXrap is like the software Excel that provides the basic tools and the applications are like spreadsheets that can be used to perform specific tasks. Anybody with enough understanding of the software can build their own app which can be shared with others.
For example, when you make a chart in Excel, the “add chart function” is a property of Excel. What’s in the chart, what’s on each axis, what colour are the lines etc are properties of the spreadsheet.
mXrap is the same, there is an “Add Chart” function. Every chart in mXrap uses the same tool, but the application configures what’s actually displayed in the chart.
mXrap software level changes are things that affect the “Add Chart” function itself. For example the current mXrap charts only plot data on four axes; top, bottom, left and right. If we were to add more possible axes, like a secondary left axis, this would require a change to the software. It isn’t related to the root folder. Another example is the image capturing tool. This is a feature of every chart, 3D view and table at the software level.
If you want an updated Hazard Assessment application, this is like getting an updated spreadsheet. The root folder is essentially a library of data and applications, like a folder full of different spreadsheets and their associated data.
To summarise, if it seems like its a common feature across many areas in mXrap, its probably a property of the mXrap software. If it seems to be something related to a specific app or chart etc, it’s probably a setting in the root folder.
Updating the mXrap software is easy, just download the installer from the website.
Updating the root folder is what we use mXsync for and it’s actually more complicated to manage the root folder than the software. A bit like trying to manage a lot of interconnected spreadsheets. We normally rely on sites to request root updates. If you read about a feature on the blog or watch a training video that seems different to your current version. You probably need a root update. It’s a fairly quick process, we just need a brief connection with teamviewer / webex or goto meeting to perform the update. Contact us at firstname.lastname@example.org.
If you notice that you are not getting updated events in mXrap, there are a few possible explanations. In order to troubleshoot the problem, it is good to know exactly how your events are transferred from your seismic database, into mXrap.
The first thing to check is if the events are just being filtered out. In the events table, there is a “Show All Rows” option that will disable all filters and show you every event in the database. Sort by descending time and “Reload Data” and check the latest event time. Cross-check with your seismic processing software to confirm you are definitely missing events. Remember there is a short delay (~ 5 mins) from events being recorded to appearing in mXrap.
If showing all rows unveils your missing events, it’s a filtering issue. Look through the event filters to make sure everything is turned off. It might also be the quality filter. To see what quality settings are applied at your site, refer to the “Event Quality Settings” video here.
If you have confirmed the events are not updating, go to your root folder and open the #Events Import folder. Inside there will be an all_events and a recent_events evp file (exact folder, name, extension varies slightly between sites). These are the event files that are read by mXrap. Check the time-stamp of the recent_events file, it normally updates within 5 minutes of the latest event recorded. Try opening the file using notepad, it will be sorted by time so check what the latest event is.
If the EVP files in the root folder have the updated events, mXrap is not reading the files correctly. Contact email@example.com for assistance.
EVP files are generated by querying the seismic event database. The recent_events evp is normally updated every 5 minutes and contains the events from the start of the previous month, up to the present. The all_events evp is normally updated every 24 hours and contains all events up until the start of the current month. So there is always up to one month of overlapping events between the all_events and recent_events EVP’s. The EVP file only changes if there is something to change, i.e. the all_events EVP may be checked for updates every 24 hours, but the file may not have any changes for several days or weeks if none of the processing has changed.
If the evp files in the root folder have not been updated, the problem lies in how these files are copied into the root folder from your seismic database. This process varies by site, depending on whether you use IMS or ESG as your seismic service provider.
IMS generate the all_events and recent_events EVP files and normally store them on the seismic server share drive (often a Linux samba drive). Hitting “Reload Data” in mXrap will copy those EVP files (if they’ve changed) into the #Events Import folder in the root. You need to specify the location of the EVP files on the network. This setting is in the “Config Events Import” app, usually at the top of the app list (log in as Admin or Super User). In this app you should see the file paths to the all_events and recent_events files.
Make sure these file paths are correct and try navigating to the files in windows explorer. If you can’t access the files through windows explorer, you will need to ask your IT department for help to get access to the network location. There might also be a password required.
If you are able to access the EVP files on the seismic server, again, check the timestamps and open the recent_events file to see what the latest event is. If these files are up-to-date, it is a problem with the copy-action from the seismic server to the root. Double check the file path in mXrap is correct and try to “Reload Data” again. Contact firstname.lastname@example.org for assistance if mXrap events are still not updated.
If the EVP files on the seismic server are not updated, it is a problem with the IMS query and you will need to contact IMS for assistance.
We have a purpose built program for querying the ESG seismic database and dumping the EVP files into the root folder. The mXrap Export ESG program normally runs on the ESG computer. Check that this is still running. There should be an icon in the system tray. The ESG Exporter needs to know the location of the seismic database .mdb file and the location of the #Events Import folder in the root. Try manually running the query from the Exporter window and look for error messages and report to email@example.com. Common problems are not being able to write files in the root folder (user permissions), ESG Exporter is out-of-date, or the seismic database .mdb has moved or changed format.
There is a forum topic to discuss any issues relating to Events Import. The flowchart below summarises the troubleshooting process when your events are not updating in mXrap (PDF version).
If you are interested in learning a bit more about the structure of mXrap that underlies the main application windows, we have uploaded a series of videos that are a great place to start.
1. The first three videos introduce the root folder and discuss the Settings and Analysis windows where new tools are created and configured.
1.1. Introduction to the Root Folder
1.2. Introduction to the Settings Window
1.3. Introduction to the Analysis Window
2. This next series show you how to create your own Apparent Stress range filter for Events and add it to General Analysis
2.1. Create New Variables
2.2. Create New Range Filter
2.3. Add New Events Range Filter
2.4. Add Variables to General Analysis
3. Create your own Event marker style for Corner Frequency
3.1. Create New Marker Style
3.2. Add New Event Marker Style
4. Import data into mXrap and plot in a new 3D View and Chart
4.1. Import Data
4.2. Create New 3D View
4.3. Create New Chart
5. How to add your own tools to the General Analysis application
For those feeling extra adventurous, we have also uploaded some app building tutorials.
There is a forum to discuss any issues related to the advanced training material. Also feel free to contact firstname.lastname@example.org for assistance.
There are many reasons you might want to store a short snippet of text associated with an event. There are two ways to do this in mXrap; event tags and event comments.
Event tags can be used to group events into categories. Example tags might be “suspected blast”, “damage occurred”, “suspect location”, “outlier” or “likely crusher noise”. These tags can be used in event filters to quickly show or hide particular categories.
Event comments are a second option to assign user text to events. Each event comment can be unique and about anything. They have no effect on event filters.
You can find videos on “Event tags” and “Event comments” at the training video page below. Both event tags and comments are shown in the main events table in General Analysis.
The event tags system has been modified recently. If your mXrap looks different to the video, you might need a root update. This process is now quick and easy with mXsync. We just need 5-10 minutes to connect via teamviewer / webex / gotomeeting.
Comment in the forum or contact email@example.com for assistance.
In early versions of MS-RAP the “Omori” chart included the cumulative energy as a function of time after blasting. You won’t find that line anymore in the default Omori Analysis Tools application.
Although the total energy released has a value, the shape of the cumulative Energy graph inherently has no meaning. The accumulation of a logarithmic parameter is dominated by the largest events and results in a curve with a somewhat arbitrary, random shape. The total energy released is included in the blast table in the Omori Analysis Tools app but the cumulative energy line has no diagnostic value (in fact could be misleading) and does not represent the underlying stochastic process.
To illustrate further, the video below shows a repeated generation of synthetic seismic data where each sample has the same number of events, the same b-value, and the same Omori relationship.
Feel free to discuss further in the forum.
You can capture or save any 3D view, chart or table using the “Clip” or “File” options at the top-right of the mXrap window. There are additional image capturing controls available to increase the quality and to adjust what is captured in the image. For capturing charts for example, you can turn on/off the header/footer, axis titles, axis ticks or grid lines. In table views, you can capture as an image or csv file, all rows or selected, with or without column headers. High quality images can be really handy for reports, papers or website publishing.
People often notice that the local magnitude of an event in mXrap is different from the magnitude shown in their other seismic software. This is usually because the local magnitude equations do not match.
Local magnitude is a calculated (derived) parameter. Normally its either based on Seismic Energy, Moment/Potency, or a combination of both. You should be able to find the relevant details for your site local magnitude in your seismic waveform processing software (eg WaveVis, Trace), otherwise contact your seismic service provider.
In mXrap, local magnitude can be imported along with the other event details from your seismic service provider although this does have low precision which can effect some of the charts and calculations. The reason for the “stepping” sometimes seen in the frequency-magnitude chart is due to an imported local magnitude of only 1dp precision.
The limited precision is why we usually recalculate the local magnitude from the source parameters according to the following equation.
ML = CE x log10(Energy) + CM x log10(Moment) + C
CE, CM and C are the input parameters required. The most common local magnitude scales are below.
CE = 0, CM = 2/3, C = -6 (Moment magnitude, Hanks Kanamori)
CE = 0.272, CM = 0.392, C = -4.63 (IMS scale)
ESG have a few other local magnitude options depending on whether they use uniaxial and/or triaxial sensors. These settings are in the ESG Events Import app. The other settings for local magnitude are in the General Setup app under the Magnitude tab. The “Local magnitude settings” video on this page runs through how to change these settings in mXrap.
Comment in the forum or contact us at firstname.lastname@example.org for assistance.
You can use selections to filter events in General Analysis. This gives you a lot more freedom than being restricted to the traditional min/max range filters. Follow the steps below to see how you can use this feature to plot the Frequency-Magnitude chart for events occurring during periods of high apparent stress.
You can also check out this page to watch the “Selection boxes” and “How to use selections in the base filter” videos.
Step 1 – Create a new selection on the Apparent Stress Time History chart. Note that selections can be made in any 3D view, chart or table in a similar way.
Step 2 – To apply the selected events to the filter, go to the Events Ranges panel, hit “Copy selections to Base filter” and switch on the selection filter below. Now only the selected events will be used in the Frequency-Magnitude chart.
Step 3 – To turn off the blue selection icons, go to the Events series and turn off the “Highlight selected” option.
Note that if you adjust the selection box or make another selection, you need to hit the “Copy selections” button again to apply the changes. Use the switch to turn off the selection filter and return to original filter.
In the case of the Apparent Stress Time History chart, selection boxes are applied to the frequency line rather than the events in the background. The series that is active for selection can be modified. Look for the “Select” option in the series controls on the right-hand panel.
Did you know that any 3D survey or surface can be displayed in Solid or Wireframe mode?
Hit “W” in the 3D view to switch to wireframes, hit “S” to switch back to solids!
Remember there is a Quick Reference guide in the cheat sheets for all the shortcuts in mXrap.
By now most of you have probably heard of mXsync. It has been installed at all the current sponsor sites and we did explain briefly as we went but there might still be some uncertainty about it.
mXsync is a piece of software installed separately to mXrap that facilitates the backup, restore and upgrading of the site root folder. We hope this new root folder management system will allow new and improved apps to flow more easily and more quickly to sites.
Right now we would like at least one person at each site to get to the point where they have mXsync setup on their computer and they are familiar with how to perform a backup. We’ve uploaded a video that gives a quick intro into mXsync and how to do a default backup. There are a few other videos on mXsync that show you some more operations that sites may need to do at some point.
For a few more details on mXsync, and some things that might be of importance for IT, please refer to the About mXsync page.
Please comment in the forum or contact us at email@example.com if you have any problems.
There are a number of quality filters applied to the event database before they are displayed in mXrap. This does sometimes cause confusion because a particular event is visible in your other software, but not in mXrap.
The most common cause is the location filter but there may be other reasons. Have a look at the “Event quality settings” video at the page below. It goes through all the quality filters applied at your site and how to change them.
As always, comment in the forum or email firstname.lastname@example.org for assistance.
The default event local magnitude marker might not suit everyone. After all, a ML+1.0 might mean something completely different to you compared with the site next door.
The “Change event marker style” video at the page below will run you through how to make a site specific event marker. There are a couple of other marker styles you can adjust too :)
If the video isn’t clear, please contact email@example.com or leave a comment in the forum.
We previously created a Basic Seismic Monitoring app but it didn’t get widely used. We’ve taken another swing at a new version released late in 2017.
The new app is intended for mine control room operators to monitor the latest seismicity and communicate event alerts and exclusion areas depending on site specific rules. Each site can setup their own event alert and exclusion settings in the Basic Seismic Monitoring (Admin) application and then the main application is a simplified interface for the viewer.
Key features include:
- Automatic events updating (no need to keep pressing “Reload Data”!).
- Popup event alert notifications (to alert user when window is hidden/minimised).
- Popup system alert notifications (triggered from threshold time without new events).
- Plot exclusion areas and isolate single mine areas (e.g. single level plans).
- Automatic View – quick zoom/rotate to the exclusion areas on screen.
- Distance measurement – get the distance from any survey point to the nearest event alert.
There are two videos uploaded at the page below; one to show you how to do the initial setup in the Admin window and another for the basic user in the main monitoring window. If your root looks different to the video, you might need a root update. The process is quick! Just contact support.
We are also working on a few more features for the app and will hopefully release another update soon in 2018. Additions should include:
- 3D text from DXFs
- Non-spherical exclusions (cylinder or box)
- Alternate event marker style
- Improved data reload speed
- Popup event query window (for source parameters)
- Enable/disable auto-clipping
- Event comments included in the table
If you have any questions or comments, feel free to email firstname.lastname@example.org or post in the forum.
The distance to survey filter has been around for a while but now we have added a couple of new charts to further investigate the relationship between seismicity and your input surveys. The charts have been added to the General Analysis application, under the Charts menu, look for Distance to surveys.
There is a training video to explain a few things about the charts, find it here: https://mxrap.com/training-videos/dist-surveys/
The example below shows how you can compare your seismicity around your geological structures. Of course, sometimes a structure will have a lot of seismicity nearby because you happen to do a lot of blasting nearby. You can also plot blasts as a function of distance to survey!
If you can’t see the charts in your mXrap, you might need a quick root update, ping us an email at email@example.com and we’ll sort it out. Now we’ve setup everyone with mXsync, updates are very easy, will probably only take 10 minutes on teamviewer/webex :)
What do you think of the new charts? Any ideas for additions or improvements? Comment on it in the forum or contact support!
If you want to learn more about mXrap, we don’t have a user manual to read. Who would want to read through one of those! We have been writing “cheat sheets” to show new users the main features of mXrap.
We’re still going to try and keep the cheat sheets updated, but we are going to focus more on our new training videos platform!
This is where we will post short tutorial videos to show and tell all the features of mXrap. Things like modifying clipping volumes, calculating hazards, using the gridding app will all be included. In time we will add more FAQ content and even some more advanced training material for those who want to play around with the guts of mXrap.
There is a link to the training videos from the mxrap.com website, look for the training tab. This is the direct address: https://mxrap.com/training-videos/
The training videos are password protected, ping us a quick email at firstname.lastname@example.org and we’ll send you the password. Please don’t share the training videos outside of the mXrap sponsor network.
Feel free to discuss in the forum, let us know what you think of the new page, any problems watching the videos and ideas for new or modified content.
Welcome to the mXrap noticeboard. As many of you noticed this last year, there is a lot going on in the mXrap offices. Many new members, and many changes to old software and the addition of the mXsync software. We know this can be a bit overwhelming, and that is why we decided to try this platform to record and communicate all these changes. We will update this noticeboard as much as possible, so if you want to know what is going on in our offices, just head over here and you will see the latest and greatest developments.
Also, there is a forum option here as well, so you will be able to ask questions and see questions from other users as well.
The mXrap Team