WipFrag 4 Manual
WipFrag 4 Manual
WipFrag 4 Manual
Operating Manual
With Online System User Interface
Page 1 of 42
Disclaimer
WipWare image analysis software is the end product of more than ten years of research and has been
developed and tested in a broad range of applications. Every effort is made to supply a reliable product
backed by prompt and efficient customer support. WipWare Inc. makes no representations or
warranties with respect to the contents of this document or the performance or results of this software,
and specifically disclaims any implied warranties, of any kind, oral or written. In the event any
warranties are deemed to apply, the sole remedy for breach of such warranty and the sole obligation of
WipWare Inc. is the repair or replacement of the document and/or software, at the discretion of
WipWare Inc.
Copyright
WipFrag©, BlastCast©, Delta© (Solo, Reflex, Momentum, Vertex) are all the property of WipWare Inc®.
Page 2 of 42
Table of Contents
1.0 Introduction ............................................................................................................................................ 7
1.1 Fragmentation Measurement ............................................................................................................. 7
1.2 The WipFrag Method .......................................................................................................................... 7
2.0 Analyses Page.......................................................................................................................................... 8
2.1 Add New Item ..................................................................................................................................... 8
2.1.1 Snap Image from Camera............................................................................................................. 8
2.1.2 Open Existing Image..................................................................................................................... 8
2.1.3 Open UAV Image .......................................................................................................................... 8
2.1.4 Open Demo Image ....................................................................................................................... 8
2.1.5 Download MailFrag Studies ......................................................................................................... 8
2.1.6 Create Project .............................................................................................................................. 8
2.2 GIS ....................................................................................................................................................... 9
2.2.1 UAV Analysis List .......................................................................................................................... 9
2.2.2 Map View Options........................................................................................................................ 9
2.2.3 Heat Map ................................................................................................................................... 10
2.2.4 Creating a UAV Analysis ............................................................................................................. 10
2.3 Connect to System ............................................................................................................................ 10
2.4 About WipFrag .................................................................................................................................. 11
2.4.1 Registration ................................................................................................................................ 11
2.4.2 Release Notes............................................................................................................................. 11
2.4.3 Contact Us .................................................................................................................................. 11
2.4.4 Resource Library ........................................................................................................................ 11
2.5 Analysis Cards ................................................................................................................................... 11
2.6 Projects ............................................................................................................................................. 12
2.7 Selecting Multiple ............................................................................................................................. 12
2.7.1 Share Selected............................................................................................................................ 12
2.7.2 Delete Selected .......................................................................................................................... 12
3.0 Opened Analysis Page ........................................................................................................................... 12
3.1 Rename Analysis ............................................................................................................................... 12
3.2 Image Info ......................................................................................................................................... 12
3.3 Scale .................................................................................................................................................. 13
3.3.1 Drawing the Scale Reference Line.............................................................................................. 13
Page 3 of 42
3.4 Edge Detection Parameters (EDP) .................................................................................................... 14
3.4.1 The EDP Strategy ........................................................................................................................ 14
3.4.2 Best Fit ....................................................................................................................................... 15
3.5 Edit Tools ........................................................................................................................................... 15
3.5.1 Edit Assist ................................................................................................................................... 16
3.5.2 Hidden Gestures......................................................................................................................... 17
3.6 Color ID ............................................................................................................................................. 17
3.7 Create Chart ...................................................................................................................................... 17
4.0 Chart Page ............................................................................................................................................. 18
4.1 Chart Titles ........................................................................................................................................ 18
4.2 Chart Data Box .................................................................................................................................. 18
4.3 Chart Statistics .................................................................................................................................. 18
4.4 Chart Graph Area .............................................................................................................................. 19
4.5 Chart Size Classes .............................................................................................................................. 19
4.6 BlastCast............................................................................................................................................ 20
4.6.1 General BlastCast Usage ............................................................................................................ 20
4.7 Share Chart Data ............................................................................................................................... 21
4.8 Calibration ......................................................................................................................................... 21
5.0 Auto Scale (iOS Only) ............................................................................................................................ 22
6.0 Connect to System Page ....................................................................................................................... 22
6.1 Add System ....................................................................................................................................... 23
6.2 Connecting to a System .................................................................................................................... 23
7.0 Delta System Page................................................................................................................................. 23
7.1 Delta Image View .............................................................................................................................. 23
7.2 Delta Chart View ............................................................................................................................... 24
7.3 Delta Time Graph View ..................................................................................................................... 24
7.3.1 Time Graph Settings ................................................................................................................... 24
7.3.2 Time Graph Time Selection ........................................................................................................ 25
7.4 Night Mode ....................................................................................................................................... 25
7.5 System Settings ................................................................................................................................. 25
8.0 System Synchronization Settings Page ................................................................................................. 26
8.1 General Use ....................................................................................................................................... 26
8.1.1 Locked Items .............................................................................................................................. 26
Page 4 of 42
8.1.2 Pending Changes ........................................................................................................................ 26
8.2 System Settings ................................................................................................................................. 27
8.2.1 System ........................................................................................................................................ 27
8.2.2 Security ...................................................................................................................................... 27
8.2.3 Network ..................................................................................................................................... 27
8.2.4 Email........................................................................................................................................... 28
8.2.5 Modbus ...................................................................................................................................... 28
8.3 Camera Settings ................................................................................................................................ 29
8.3.1 Camera Name ............................................................................................................................ 29
8.3.2 Camera ....................................................................................................................................... 29
8.3.3 Conditional Trigger..................................................................................................................... 29
8.3.4 Sensor......................................................................................................................................... 30
8.3.5 Scale ........................................................................................................................................... 30
8.3.6 Sizes............................................................................................................................................ 31
8.4 Material Profile Settings ................................................................................................................... 31
8.4.1 Profile Name .............................................................................................................................. 31
8.4.2 Active Profile .............................................................................................................................. 31
8.4.3 EDP ............................................................................................................................................. 31
8.4.4 Calibration .................................................................................................................................. 31
8.4.5 Data Box ..................................................................................................................................... 31
8.4.6 Filter ........................................................................................................................................... 32
8.4.7 Color ID....................................................................................................................................... 32
9.0 Vertex-S Controls .................................................................................................................................. 33
9.1 Conditional Trigger............................................................................................................................ 33
9.2 Vertex-S Chart ................................................................................................................................... 33
10.0 Vertex-C Controls ................................................................................................................................ 34
10.1 Conditional Trigger.......................................................................................................................... 34
10.2 Vertex-C Chart ................................................................................................................................. 34
Appendix 1: Rock Pile Sampling and Photography ..................................................................................... 35
1.0 Rock Pile Sampling ............................................................................................................................ 35
1.1 Lighting and Photography ................................................................................................................. 36
1.2 FAQs .................................................................................................................................................. 37
Appendix 2: WipFrag “Fines” Strategies ..................................................................................................... 38
Page 5 of 42
2.0 Engineering Solution ......................................................................................................................... 38
2.1 Empirically Calibrated Solution (Long term studies) ......................................................................... 38
2.2 Zoom-Merge Solution ....................................................................................................................... 38
Appendix 3: Calibration Samples and Techniques ...................................................................................... 39
Appendix 4: WipFrag Licenses .................................................................................................................... 40
4.0 WipFrag 3 for Windows .................................................................................................................... 40
4.1 WipFrag 3 for iOS .............................................................................................................................. 40
4.2 Lost or Damaged Security Keys ......................................................................................................... 40
Appendix 5: Modbus Register / OPC Tag List.............................................................................................. 41
Page 6 of 42
1.0 Introduction
For decades, small particles could only be measured in the laboratory by sieving, centrifugation,
sedimentation, or optical microscopy. It is now possible to analyze practically anything using
photoanalysis software, assuming you can take a picture of it, provide a scale and delineate the particle
with the naked eye; the software will be able to analyze the particles in question.
Medium sized particles have been mainly measured through a time consuming and disruptive method;
sieving. Photo analysis on the other hand can be performed in only a few seconds; without disruption to
the process.
Only digital optical (photoanalysis) methods are of any practical value when the fragments are much
larger, as in blasting. Sieving of a muck pile is an impossible task but can quickly be quantified using
photoanalysis systems.
Image acquisition is a very important aspect of photoanalysis. Images must be clear, evenly lit and must
be acquired systematically in order to minimize editing and to optimize results. Simply put, good images
yield good results. See our Sampling and Analysis Guide on our website.
Page 7 of 42
2.0 Analyses Page
The Analyses Page is the first page you are presented with after opening WipFrag. From here you can
create new analyses or open existing ones.
Note: A WipFrag license is required in order to snap an image or open a non-demo image. If you
do not have a WipFrag license you will see a red shopping cart icon over the blocked functions.
Page 8 of 42
2.2 GIS
Opens map to view GIS information for analyses with location information.
Note: Non-UAV analyses containing location data will display as a pin icon and only show up in the
analysis list described below.
Page 9 of 42
2.2.3 Heat Map
The heat map is calculated using all analyses currently in the view. The data from a UAV analysis will be
split into sections based on the selected grid size. Data from non-UAV analyses will simply be added to
the grid they are within.
The color of each grid indicates good areas (cold colors) vs bad
areas (hot colors).
1. Use WipFrag for Windows to open a GeoTIFF image created by DroneDeploy or Pix4D.
a. GeoTIFF images have their location, scale and rotation information embedded in them.
b. Currently only WipFrag for Windows can read in this information.
2. Open any image with embedded location information and manually provide the scale and
rotation.
a. Once a valid image is selected, you will be presented with the image on
the map.
i. In most cases the location will already be correct based on the
center of the image.
b. Use the controls in the top-right to position, rotate and scale the image
until it is correctly positioned on the map.
c. Select Done in the top-right to complete the wizard and create the
analysis.
Page 10 of 42
2.4 About WipFrag
Selecting this icon will present you with the following options.
2.4.1 Registration
Allows you to change the registered name/company and interface language.
2.4.3 Contact Us
Allows you to submit feedback or report a bug.
1. Name
2. Tags indiciating presence of BlastCast or GPS data
3. Image thumbnail
Page 11 of 42
2.6 Projects
Projects are indicated by blue text and can contain any number of analyses.
• iOS
o Pinch your fingers to zoom the image.
o Two-finger pan to move around a zoomed in image.
• Windows
o Mouse wheel to zoom the image.
o Click and hold the mouse wheel to move around a zoomed in image.
Page 12 of 42
3.3 Scale
Allows you to specify the scale reference in the image.
Page 13 of 42
3.4 Edge Detection Parameters (EDP)
Allows you to specify the parameters used to automatically delineate particles in the image.
Page 14 of 42
3.4.2 Best Fit
Best Fit can be used to find the best set of EDPs for an image or set of similar images.
• ie, same material, lighting, zoom, sample strategy.
1. Generate the best possible net using the EDP slider as a starting point.
a. You can also manually delineate all particles for minimum bias towards an auto net.
2. Spend a significant amount of time editing the net to make it as ideal as possible.
3. Select Best Fit from the advanced section.
4. Select a Best Fit mode:
a. Quick – Can take several minutes.
b. Standard – Can take up to an hour. More thorough than Quick.
c. Thorough – Can take several hours. More thorough than Standard.
5. Once started, a progress bar will display the current best match percentage, iterations
remaining and time remaining.
6. Once completed the final match percentage will be displayed along with the advanced EDP
values. The net will also be automatically generated using these values.
a. At any point you may Stop the process and the current best match will be displayed.
b. As long as no changes to the net are made, you may resume a stopped process by
following steps 3-4, making sure to select the same mode (noted by a ).
When a Best Fit net has been generated a new icon will appear in the top-left of the image view.
Free Draw
Touch and drag to add net freely.
Draw Line
Touch and drag to add a straight line from the starting point to where you release.
Block Delete
Touch and drag to remove net within the drawn rectangle upon release.
Lasso Delete
Touch and drag to remove net within the free drawn polygon upon release.
Page 15 of 42
Ignore Block
Touch a delineated particle to mark it to be ignored from the result.
Mark as Fines
Touch a delineated particle to mark the area as fines.
• The size of marked fines will be the size of 1 pixel based on the scale factor.
Area of Interest
Enables editing of the area of interest.
• Tap to add points and create an area within the image that contains analyzable material.
Two points create a rectangle. Three or more create a polygon.
• Areas marked in red will not have net generated and delineated blocks in the area will
be excluded from the results.
Undo
Undo the last action of one of the above edit tools.
• When editing the Area of Interest, the last point will be removed.
Edit assist has three modes. Tapping will toggle through the following modes in order:
Note: Making changes to the net while edit assist is active will cause this icon to appear. Tapping
the edit assist button will perform a recalculation for an accurate representation.
Page 16 of 42
3.5.2 Hidden Gestures
Below are the hidden gestures that can be used to help edit.
• Block Leak Test – Fills the block under the touch point and displays the size. Can move
around without lifting once mode is enabled.
o iOS: Tap and hold without moving until the progress bar fills.
o Windows: Right click and hold.
• Block Colors – Fills all the blocks in the entire image with hot/cold colors based on the size.
The hotter the color the larger the particle, true red being the largest particle.
o iOS: Double tap and hold until the colors appear. Slide finger up/down to change
opacity of colors.
o Windows: Double right-click and hold until the colors appear. Move cursor up/down
to change opacity of colors.
3.6 Color ID
Allows definition of up to 2 color IDs to identify particles based on color.
Clear Definition
Will clear the color definitions for this ID.
Configure Definition
Will display controls to add/remove colors to the lookup table for this ID.
Note: Color ID information is only available on the chart (see next section).
Page 17 of 42
4.0 Chart Page
There are 4 areas of the chart that can be configured by tapping and holding on the area.
Page 18 of 42
4.4 Chart Graph Area
Below items are only visible if the option is toggled on.
Note: You cannot make changes to the bottom 4 preset profiles. To make changes to these lists you
must first select and copy all of the sizes, switch to the analysis profile or profiles 1-4 and then paste.
Page 19 of 42
4.6 BlastCast
Tap to enter BlastCast, a tool used for blast prediction.
You start by entering the parameters of a particular blast. BlastCast will predict the resulting
fragmentation in a particle size distribution graph. Use the ‘Auto Rock Factor’ function to align the
prediction with the WipFrag data.
Now that you have calibrated the model, you can experiment with other blast parameter sliders to see
how changing each parameter might affect fragmentation.
Page 20 of 42
4.7 Share Chart Data
Tapping this will allow you to save or send the chart data as PDF, PNG or CSV. You may also save
or send the analysis file from here.
• Select the file types you wish to save and hit OK.
o On iOS you will have the option of sending to
iCloud Drive, AirDrop, etc…
o On Windows you will have the option to save to
a location on your computer or emailing.
Note: The ANA option will not be available for projects containing more than one analysis file.
4.8 Calibration
You can use calibration to adjust the WipFrag curve to match an expected output (sieve results).
• Please see our Calibration Document for detailed information on when to calibrate and the differences
between Rossin-Ramler and Swebrec.
Accurate calibration requires sieve results in order to be performed as well as the WipFrag analysis of
the same material that was sieved.
Page 21 of 42
5.0 Auto Scale (iOS Only)
Take a photo of material without the need for a physical scale reference.
o The camera within WipFrag can be used with a physical scale as well.
You can see the following information about each system, from left to right:
Page 22 of 42
6.1 Add System
Allows you to add a system by IP Address and TCP Port if it is not auto discovered.
• If connected to a Momentum system with multiple cameras, you can toggle the currently visible
camera by tapping on the numbered camera icon ( ) in the top left of this view.
• The scale line at the bottom of the image displays the real-world length equal to 2/3rd of the
image width.
• Double tap the image to view it in full screen.
o When in full screen, you can click the button to create and open the image as a
WipFrag analysis file.
Page 23 of 42
7.2 Delta Chart View
This is the chart data for the latest data point for the selected camera.
• Hit the tab above the time graph to show the status of each camera over the course of
the selected time range.
o Each status is color coded as follows:
▪ Untriggered (grey) – No material is present to analyze.
▪ Triggered (green) – Successfully analyzing material.
▪ Mean Filter (red) – Triggered but rejecting images due to brightness.
▪ Block Filter (magenta) – Triggered but rejecting analysis due to block count.
▪ Coverage Filter (orange) – Triggered but rejecting analysis due to coverage.
• Double tap the time graph to view it in full screen.
o When in full screen, you can tap and hold on the graph to view the time graph settings.
Note: Color order is locked and moving items in the list is how to change their colors.
Page 24 of 42
7.3.2 Time Graph Time Selection
Select a time range to view the averaged result in the chart view.
1. When the time graph is not full screen, tap and drag to make a selection.
2. Tap on the yellow area to manually enter a start and end time.
3. Tap outside of the yellow area to clear the selection.
a. If you do not clear the selection the chart view will remain as the merged result and will
no longer update as data is pulled from the system.
Page 25 of 42
8.0 System Synchronization Settings Page
Changes to system, camera and profile settings can be made on this page. No changes are applied until
synchronized with the system. This page is broken down into three main sections, each with its own sub
sections:
1. System Settings
2. Camera Settings (up to 6)
3. Material Profile Settings (up to 4 per camera)
Page 26 of 42
8.2 System Settings
These settings are global changes to the system and are not camera specific.
8.2.1 System
8.2.2 Security
• Read Password – Password required to connect to
the system.
• Write Pin – The 4-digit pin code required to make
changes to locked settings.
• User/Company – The registered name and company
that shows up on all chart outputs.
• System Type – Select system type (Momentum,
Reflex, Solo, Vertex-S, Vertex-C).
• Customer Key – Unique system ID required for activation.
• Activation Key – Activation key for the system required to run.
▪ All systems shipped from WipWare will be pre-activated.
▪ If this is blank for a system you purchased, send WipWare the Customer Key requesting activation.
8.2.3 Network
• Computer Name – Name of computer on network.
• IP Address – Network address of the adapter.
• Subnet Mask – Subnet mask of the adapter.
• Default Gateway – Gateway of the adapter.
• Primary DNS – DNS of the adapter.
Note: LAN 2 is only available on Momentum systems.
• NTP Server – IP Address of a time server on the same network as the system.
Page 27 of 42
8.2.4 Email
• Logfile Recipients – List of email addresses that will
receive the daily email containing the logfile for
each camera.
o Multiple email addresses must be separated
by a comma ( , ).
• Send Test Email – The system will attempt to send a
test email to the addresses in the lists above.
o Changes to email addresses or SMPT
options must be synchronized before
sending a testing email.
• SMTP (Optional) – SMTP server used to send emails.
o Server – Name or IP Address of server.
o Port – TCP port of server.
o Username – Username for authentication.
o Password – Password for authentication.
o Sender – The email address the email report will appear to come from.
o # Retries – How many attempts to send the email in case of failure. Can be useful on
systems with spotty internet.
8.2.5 Modbus
Items on the left are available via Modbus TCP (up to 64). Items on the right are all possible
values. All registers are floating point type (4 bytes).
Page 28 of 42
8.3 Camera Settings
These settings are camera specific.
8.3.2 Camera
This item is always locked and requires taking the system offline to view the live image view.
Changes are automatically synchronized to the system and take effect immediately.
Page 29 of 42
8.3.4 Sensor
This view will display a live image as well as live distance reading. Use this view to set the trigger
distance such that the system will only be triggered when material is present.
8.3.5 Scale
Use a snapped image from the camera to set the scale.
Note: See 3.3.1 Drawing the Scale Reference Line for more info.
Page 30 of 42
8.3.6 Sizes
Set the size classes (up to 25) and the material specification envelopes for each profile.
8.4.3 EDP
Set the parameters used to automatically delineate particles in the image. See section 3.4 Edge
Detection Parameters (EDP).
8.4.4 Calibration
Set the calibration adjust factors. See section 4.8 Calibration.
Page 31 of 42
8.4.6 Filter
Set ranges to only save data when certain image requirements are met.
8.4.7 Color ID
Allows deletion and renaming of Color ID. Must snap a picture to an analysis file to adjust the
color lookup table. See section 3.6 Color ID.
Page 32 of 42
9.0 Vertex-S Controls
Vertex-S is a special system type for crusher gap control that only reports the maximum particle size. As
a result, some controls are different or disabled altogether.
Page 33 of 42
10.0 Vertex-C Controls
Vertex-C is a special system type for sorting that only reports the amount of colored material in the
image. As a result, some controls are different or disabled altogether.
Page 34 of 42
Appendix 1: Rock Pile Sampling and Photography
The 2 most important questions to ask yourself while obtaining your images are simply 1) can I delineate
all of the particles within these images and 2) when done, will I have gathered an adequate statistical
representation of the material in question?
To adequately compensate for rock pile segregation and heterogeneity, each image must contain a
sufficient number of fragments, and the results from dozens of images per blast must be merged and
averaged. Accurate estimation of larger blocks, in particular, requires merged data because of the
scarcity of such blocks. High-fidelity and high-speed automatic edge detection is essential - methods that
rely on tracing or manual editing are incapable of processing sufficient data and so are prone to large
sampling errors.
• Fill the field of view with fragmented rock, preferably at least 400 particles.
• Still images greatly improve when a tripod is used. Hand-held shots are seldom sharp,
particularly telephoto shots where the slightest movement causes image blur.
• Include all sizes. No single block should occupy more than 20% of the width of image. For
improved resolution of fines, use WipFrag's zoom-merge capability to combine images at
different scales of magnification.
• Take several shots, preferably at least five at random locations on a large rockpile, or of several
truckloads or draw points. For improved estimates of oversize, increase the number of full-scale
shots to at least ten.
• Beware of rockpile segregation. Large blocks tend to roll to the outer edges and fines may cover
the surface or become hidden as a result of gravity or rainfall. The effects can be minimized by
increasing the number of images per sample but only with careful selection of image locations.
• 1280x960 is recommended for digital pictures to find an EDP easily. Good clarity and contrast is
better than size (although, any size picture can be used).
• Wide angle lenses have edge distortion. Try to avoid them.
• Digital Zooming results in interpolated pixels and should not be used.
• You should try to use a suitable size scale for each picture. Avoid using balls as they are
dimensionally unstable (i.e. air-filled balls expand/contract, softballs are two small, etc. Range
rods, yard/meter sticks, hula-hoops work well.)
• Don’t waste an image. Get images of the particles in question, not the sky and area around it.
• WipFrag measures what it can see. If your pictures are far away, fines will not be resolved. If the
image is taken too close, oversize may be missed. Get a good mix of images of the sample in
question.
Page 35 of 42
1.1 Lighting and Photography
You can only measure what you can see; so reliable results call for some basic precautions in selecting
suitable viewpoints and lighting.
• Develop a sampling strategy. Taking images is like taking samples for sieving or other tests. The
results must statistically represent the product as a whole.
• Take several shots, preferably at least five at random locations on a large rock pile, or of several
truckloads or draw points. WipFrag allows the results for several images to be merged and
averaged as a single data sample.
• Beware of rock pile segregation. Large blocks tend to roll to the outer edges and fines may cover
the surface or become hidden as a result of gravity or rainfall. The effects can be minimized by
increasing the number of images per sample but only with careful selection of image locations.
For example, take slices through the pile, or photograph the rock during loading or in trucks.
However, segregation usually increases with digging and other forms of materials handling.
• Provide uniform indirect or diffuse lighting without excessive sharp or one-sided shadows and
"hot spots". WipFrag works best when each fragment is equally bright and surrounded by a thin,
uniform shadow.
• Position the scale near the edge of the image so as not to obscure the rock you are trying to
measure.
• Avoid wide-angle close-up photography and oblique shots that distort the scale. If the rock pile
surface is oblique to the camera, place identical scaling objects at the nearest and furthest
points that can be averaged or used in auto-tilt correction.
• For underground photography, choose area illumination with several medium-power lamps in
preference to direct flash or spotlight. The use of tri-pods and time lapse photography is usually
mandatory for underground (low light) images.
• For outdoor work, choose dull days in preference to bright sunlight.
• Maintain cameras and lamps in good working condition. Clean lenses using compressed air to
avoid scratching.
Page 36 of 42
1.2 FAQs
• Fines can be delineated easier with larger images and tend to get fused together with smaller
images.
• Oversize is usually analyzed properly with smaller images but tends to get slightly disintegrated
in larger images.
WipWare always recommends taking the original images at a high resolution. It is always possible to
downsize the image without distortion, but nearly impossible to make an image larger while keeping
clarity and definition. As a rule of thumb, if you cannot delineate the particle with your eye, the software
will be unable to as well.
In order to finish the study, some information should be recorded while acquiring images. This
information is needed for the actual results, and for the analysis:
• Title of Project
• Date of Project
• Size of the scaling device(s) in each image (most important).
For multiple samples, keep track of the images you have taken so you know which analysis to merge
together.
Page 37 of 42
Appendix 2: WipFrag “Fines” Strategies
WipFrag uses geometric probability theory to unfold a 3-D distribution. This accounts for partially
overlapped fragments, as well as missing fines to some extent. However, since the number of fines in a
distribution, which are too small to be identified on the image, are highly variable, impossible to
measure, and difficult to predict, one of the following solutions is suggested:
This solution works well for comparative purposes and for narrow (poorly graded) distributions. For
wide distributions (well graded) it must be recognized that the missing fines will result in a
measurement bias toward the larger sizes.
The appropriate calibration factor, (factors determined by laboratory sieving) is selected calculating
various aspects of the R-R or Swebrec curve of the actual distribution. Where appropriate, calibration
factors can be determined by a full-scale sieving trial by the user under the conditions and rock types
appropriate to the measurement. Please contact WipWare Technical Support for more information
regarding calculating calibration factors based on Sieve analysis.
This method is much more accurate than the engineering solution. Analysis is quick and simple, but a
one-time investment must be made for calibration, prior to the start of analysis.
This, quite often the most accurate of solutions requires multiple images to be analyzed, at different
scales of observation. By varying image size, zoom and location it is possible to acquire and analyze
images that represent all particle sizes. Fines can be acquired by simply zooming into an area.
Page 38 of 42
Appendix 3: Calibration Samples and Techniques
WipFrag inherently converts the measurements of 2-D net segment areas into 3-D fragment volumes
and weights using a mathematical unfolding function. This accounts for fragment overlap, shape effects
and missing fines (i.e. particles too small to be seen in a full-scale image) to some extent.
Calibration can be done quite quickly using sieve data (3+ samples) along with the WipFrag analysis of
each of the sieve samples.
To calibrate the WipFrag system, sieving of a muck pile after analyzing with WipFrag results in the best
values. However, because of the effort required, alternatively scaled down laboratory crushed rock
calibration samples with linear R-R size distribution and uniformity coefficients covering the full range
anticipated in the mine can be used. The samples should have similar color, sphericity and general
appearance to the typical rock to be analyzed. Crush sufficient rock, about twice the total quantity
required per sample. Separate into size fractions using a nest of sieves of different mesh sizes. Use an
automatic shaker for ten minutes. Weigh and record the weight fractions to determine the true Xc and n
values. Re-mix the sample, and run analyses about ten times per sample, shaking and re-mixing the
sample between each run. Merge the data and obtain uncorrected Xc and n. Divide true values by raw
values to obtain a new set of correction factors. Repeat for other n values. Compare the results with the
defaults in WipFrag and if required, make changes to the calibration settings.
The R-R empirical correction in WipFrag uses factors Fn and Fxc to rotate and translate a Rosin-Rammler
straight line fitted to the WipFrag data in log-log co-ordinates. The R-R parameters n and Xc for the raw
data are multiplied by Fn and Fxc to obtain the "true" values that would be measured by sieving a muck
pile or a crushed rock calibration standard, or by a zoom-merge procedure. The values of Fn and Fxc will
range between 3.0 for good images with narrow size distributions (well sorted), to as low as 0.5 for
poorer images with wide size distributions (well graded).
The Swebrec empirical correction in WipFrag uses adjustment factors for b, X50 and Xmax to shift and
undulate the raw WipFrag output to obtain the “true” values that would be measured by sieving a muck
pile or a crushed rock calibration standard, or by a zoom-merge procedure.
Page 39 of 42
Appendix 4: WipFrag Licenses
A WipFrag license is required in order to open your own images for analysis. However, once the
WipFrag analysis file is created a license is no longer required. Therefore, the demo version of WipFrag
can open and edit a pre-existing analysis file that was created with a licensed version of WipFrag.
Hardware License
The hardware license must be attached to the computer when attempting to open a non-demo image.
The software may be copied onto more than one computer, however because of the need for the
physical presence of the key; WipFrag can only be run on one computer at a time.
Software License
The software license can only be installed on one computer. Since this license type cannot be moved to
a different computer it can instead be shared over the network (on the same subnetwork). However,
just like the hardware license version, only one computer at a time can ‘borrow’ the license.
It is strongly recommended that newly created Apple IDs should wait 24 hours before purchasing
WipFrag 3 from the App Store. Making a large purchase immediately after creating a new account
highly increased the chance that your purchase will be blocked (for your protection) and your account
will become flagged.
Contacting Apple directly is the only way to resolve this issue if it happens. You can find a list of Apple
support phone numbers at https://support.apple.com/en-us/HT201232
Damaged security keys can be returned and replaced at a nominal cost, at the discretion of WipWare
Inc. Keys that have been tampered with will not be replaced.
Computers which hold a software license that are lost, damaged or replaced can have up to 2 additional
product key activations on a different computer, at the discretion of WipWare Inc (for a total of 3
activations).
Page 40 of 42
Appendix 5: Modbus Register / OPC Tag List
• Items that start with ‘CX_’ indicate camera specific registers that are available for all cameras
(up to 6 on Momentum). Simply replace ‘X’ with the camera number (ie, C1, C2, C3, C4, C5, C6).
• Modbus register numbers vary depending on the order defined in WipFrag.
Read/
Name Description
Write
YEAR r Year of the last data point.
MONTH r Month of the last data point.
DAY r Day of the last data point.
HOUR r Hour of the last data point.
MINUTE r Minute of the last data point.
SECOND r Second of the last data point.
CX_UPTIME r Percent uptime for the day.
CX_ONLINE rw Camera ready to analyze. 1 = yes, 0 = no. Still observes
trigger dist.
0 = untriggered, 1 = triggered, 2 = data, 3 = Failed image
CX_STATUS r mean filter, 4 = failed block count filter, 5 = failed coverage
filter.
CX_MATERIAL_PROFILE rw Current active material profile.
CX_BELT_SPEED rw Current belt speed.
CX_D01 r 1% of material is smaller than this value.
CX_D05 r 5% of material is smaller than this value.
CX_D10 r 10% of material is smaller than this value.
CX_D20 r 20% of material is smaller than this value.
CX_D25 r 25% of material is smaller than this value.
CX_D50 r 50% of material is smaller than this value.
CX_D75 r 75% of material is smaller than this value.
CX_D80 r 80% of material is smaller than this value.
CX_D90 r 90% of material is smaller than this value.
CX_D95 r 95% of material is smaller than this value.
CX_D99 r 99% of material is smaller than this value.
CX_SIZE_CLASS_1 r Cumulative percent passing for size class 1 (smallest).
… … …
CX_SIZE_CLASS_25 r Cumulative percent passing for size class 25 (largest).
CX_IN_SPEC r 0 = under spec, 1 = on spec, 2 = over spec for all.
CX_SPHERICITY_1 r Sphericity for size class 1.
… … …
CX_SPHERICITY_25 r Sphericity for size class 25.
CX_SPHERICITY r Sphericity for all.
CX_COLORID1 r Percent color for all.
CX_COLORID2 r Percent color for all.
CX_N r Rosin-Rammler raw n value (uniformity).
CX_XC r Rosin-Rammler raw Xc value (D63.2).
Page 41 of 42
CX_B r Swebrec raw b value (curve undulation).
CX_XMAX r Swebrec raw Xmax value (max size).
CX_X50 r Swebrec raw X50 value (D50).
CX_BLOCKS r Number of particles.
CX_COVERAGE r Percent image coverage.
CX_VOLUME r Volume (m^3).
CX_DAILY_VOLUME r Daily Volume (m^3).
CX_VOLUME_RATE r Volume Rate (m^3/hour).
CX_MASS r Mass (metric tons).
CX_DAILY_MASS r Daily Mass (metric tons).
CX_MASS_RATE r Mass Rate (metric tons/hour).
CX_TRIGGER_DISTANCE r Trigger distance.
CX_CONDITIONAL_TRIGGER_1 r Conditional trigger value for slot 1 (0 = false, 1 = true).
…
CX_CONDITIONAL_TRIGGER_4 r Conditional trigger value for slot 4 (0 = false, 1 = true).
Page 42 of 42