Professional Documents
Culture Documents
Split Desktop Manual
Split Desktop Manual
Version 3.1
Help Manual
Copyright
This documentation copyright 2011 Split Engineering, LLC. All rights reserved.
Split-Desktop software copyright 2011 by Split Engineering, LLC
Split-Desktop is the registered trademark of Split Engineering, LLC
Split-Online is the registered trademark of Split Engineering, LLC
Excel is registered by Microsoft Corporation
Windows is a registered trademark of Microsoft Corporation
Quick Start.......................................................................................................................... 3
1. Install ...................................................................................................................................... 3
2. Get a License.......................................................................................................................... 3
3. Run Split-Desktop ................................................................................................................. 3
4. Start Fresh ............................................................................................................................. 3
5. Open an Image ...................................................................................................................... 4
6. Delineate................................................................................................................................. 5
7. Scale ........................................................................................................................................ 6
8. Edit Delineations ................................................................................................................... 7
9. Estimate Fines ....................................................................................................................... 8
10. Get Results!.......................................................................................................................... 9
11. Export Results ................................................................................................................... 10
12. Save the Project ................................................................................................................. 11
13. Enjoy Automation ............................................................................................................. 11
How to Contact Us
On the Web
www.spliteng.com
Quick Start
1. Install
Install the latest version of Split-Desktop from the CD or over the Web.
Split-Desktop Installer
2. Get a License
If you have already purchased a hardware key (dongle) for Split-Desktop 3.1, insert it
now and skip to the next step. Otherwise, contact Split Engineering to purchase a full
license or to request a free temporary demo license. Without a license, Split-Desktop will
run as a viewer which does not allow you access to most of the features covered in this
Quick Start.
3. Run Split-Desktop
Start Split-Desktop from any of the shortcuts created by the installer. You will find them
on the Windows desktop and on the Start Menu under Programs | Split Engineering.
Shortcut Icon
4. Start Fresh
If you have already been using Split-Desktop, you may have changed some of the
options. For the benefit of this Quick Start reset the software by doing the following:
5. Open an Image
A sample image is installed in the Samples folder, beneath the Split-Desktop installation
folder. If you already have your own images of muck piles or other appropriate images,
you can start with one of those instead.
Open the image by dragging it into Split-Desktop, or from one the menu options.
6. Delineate
Select Image | Delineate from the menu. When the Delineation Settings dialog
appears, press OK.
Delineation Settings
View Delineations
Right-click on the image to toggle the delineation display. You can also use the comma
and period keys to toggle.
Display Delineations
7. Scale
If you are using a sample image, or any other image with red scaling balls, you can use
automatic scaling to locate the scales. If thats not the case, skip below and use manual
scaling.
Automatic Scaling
For automatic scaling. select Image | Find scales from the menu. When the Find
Scales Settings dialog appears, press OK.
When the scales have been located, they will appear as shown here with a length
indicator and circular masks. Carefully inspect the location of the scales, and make any
adjustments necessary.
Manual Scaling
With the scale tool you can insert one to three scales anywhere on your image where
there is an object of known length. From the toolbar
or from the menu with Tools |
Scale tool and use the mouse to locate the two ends of the scale. You can modify the
position of the scale at any time by selecting it.
Scaled Manually
* You can change an images scales at any time. The results will be automatically updated after changes.
8. Edit Delineations
Use the eraser and brush tools to manually edit the delineations. The automatic
delineations from step 7 are a good start, but you will usually want to improve your
results by manually editing the delineations.
9. Estimate Fines
Preview the section on estimating fines in an image. To change the images Fines Factor
from the default of Medium, select Image | Properties from the menu and move the
slider bar to the desired amount.
* You can change an images Fines Factor at any time. The results will be automatically updated after
changes.
Results Display
To modify the way results are displayed, select the menu item Results | Results
options. There are too many options to cover here, so see the section on Results for
more information.
10
Automation Options
11
Scaling
Scaling requires at least one identifiable object of known size in each image. Most
images should have at least two scaling objects to account for the slope of the rock pile,
and as many as three scaling objects can be used to more accurately define the average
planar orientation of the image.
Fines Estimation
Particles smaller than a certain size can no longer be reliably delineated in an image. For
the automated delineation, this size is approximately 16 square pixels. Particles below
this size are lumped together as fines. Measuring the fraction of fines in an image can be
an intractable problem so Split-Desktop uses a user-defined fines estimation value.
12
Acquire
Images
Scale
Add images
to project
Edit
Delineations
Reduce
Resolution
Fines
Estimation
Crop
Image
Show
Results
Delineate
Export
Results
Required
Optional
13
Image Resolution
In most cases you should use the highest resolution offered by your camera, and then
reduce the resolution to more reasonable values if required. See the section of limiting
image resolution.
14
Good Image. slope angle is clear, even light with few shadows, and nice range in size
Not so good image... The one large rock leads to a biased sample
15
Sampling Methodology
It is important to capture your images in a systematic manner so that the calculated
results truly represent the size distribution of the material of interest. Consistent methods
should be applied to all samples that you collect so that you can make valid comparisons
between sites of interest. Try to develop (and Split Engineering will assist you) a
consistent method for acquiring images at various scales and various locations and adhere
to it in order to avoid introducing artificial bias or scatter in the size information.
You should make an attempt to capture images over the entire exposed surface of the pile
or one continuous section of the pile with minimal overlap so that the results are not
biased by omission or by repetition. Remember that only what is visible can be sized,
and that the surface may hide variations of the material beneath.
The outside surface of a muck pile before digging should not be used to represent the
material within the pile but may be important by itself. The surface of an unexcavated
muck pile may be quite different from the material within the pile that is exposed while
digging. It is recommended for muck piles to let the shovel advance to about the middle
of the shot before acquiring images that can be deemed representative of the blasted
material. If you are only able to obtain images from the exposed surface before digging,
make sure you only compare those to similar sets of data. It is probably not good practice
to compare the distribution of the outside of an unexcavated pile to the inside of a
partially excavated pile.
The amount of fines is determined by the images at the largest scale. The distribution of
fines is calculated from the zoomed in images of fines. Make sure that the largest scale
images include the patches of fines that are actually visible and not just the largest
boulders or your results may be in error.
You should be careful of changes in geology within the area of interest, since most
investigators are interested in the size distribution within a geology.
Image Scale
For material piles, you may need to take images of different scale in order to obtain a
decent sample of the material:
1) Large scale including boulders and areas of fines. The horizontal length of the image
should be about 20 ft (7 m). These images will contain the topsize material and will
adequately sample the coarse material as well as provide indications of the large areas of
fines.
2) Medium scale of typical regions of 2 to 10 inch (5 to 25 cm) material. The horizontal
length of the image should be about 8 ft (3 m). These images will provide a closer look
at the medium size material (material in size between the topsize and the fines) and will
16
lower the fines cutoff value (the value at which the software stops measuring and begins
to estimate).
3) Small scale which are zoomed in images of representative samples of the finer
material. The horizontal length of the image should be about 1.5 ft (0.5 m). These
images will try to measure the fine material to give an indication of the size distribution
within the large areas of fines that may be present on the surface of the large scale
images. Many zoomed-in fines images would need to be acquired to change the
distribution of the entire sample, but these images can help with measuring the fines and
lowering the fines cutoff value as opposed to using the fines estimation equation in the
software.
Take approximately equal numbers of images at each scale although if you are not
interested in the size distribution of the smallest scale of material and are happy to accept
a Schumann or Rosin-Rammler curve in this range, you may omit taking the zoomed-in
images.
17
18
Image Lighting
Be conscious that shadows and direct sunlight do not interfere with the overall image
appearance as heavy shadows mask particle edges.
Images with uneven light (i.e. bright sunlight on one portion with a shadow cast across it)
will not delineate well and may require heavy editing later. The wide range of pixel
values hinders the effectiveness of the edge detection algorithms.
Overcast days actually provide more consistent lighting due to fewer shadows.
EXAMPLES
The following grayscale image has distinct areas of intense light and heavy shadowing.
This image will most likely not delineate well and will require more manual editing.
Poor Lighting
19
The following image is better than the image above, but still has areas of uneven light.
Notice the darkness below the lower scaling ball as compared to the very light looking
particles in the center of the image.
Better Lighting
The image below has even light throughout the image.
Good Lighting
20
21
Depending on the scale of the image, the fines estimation may be for fairly large
particles, not only the size of what is normally considered to be fines. The fines are
distributed below the cutoff using a Schumann or Rosin-Rammler distribution, the slope
of the curve below the cutoff is calculated from slope of the curve just above the cutoff
point.
Basically, if estimation is not acceptable for smaller size fractions, acquire the medium
and small scale images. The Split software will merge the entire sample together as one
size distribution curve and the size cutoff and fines estimation will be lower.
In the above image: Very large particles in this medium range image. There is no need
to zoom further in and acquire another image as the particles are clear and distinguishable
in the image. This image would have a rather large fines cutoff size. The image is also
taken rather close to the pile, you can tell by the large change in apparent size of the two
10" balls. A better image would have been collected had the photographer, stepped
further back and zoomed in.
22
In the above image, far range picture captures largest particles, but loses resolution on the
finer particles, particularly between the scaling balls. A medium scale image, as shown
below, can be acquired without moving the scaling balls to obtain better resolution on the
smaller particles. Zoom even further in to achieve resolution on the smaller particles to
the bottom left of the top scaling ball. If you are happy to accept an estimation of those
particles based on the slope of the curve using the large scale and medium scale images,
than omit acquiring the small scale zoom-in image
23
Hardware
Required hardware
CD/DVD drive or Internet connection for installation
Free USB port for the protection key (required for the full version)
Recommended hardware
2 gigabytes RAM
Installing
Split-Desktop can be installed with the Split-Desktop CD or with the online installer
available from the company website at www.spliteng.com. To keep the online installer
small for faster downloads, it does not include all of the features and pre-requisites that
are available on the CD version.
If you need assistance obtaining a CD or downloading from our website, please contact
one of our offices.
24
Installation Options
Your first interaction with the installer will be your opportunity to select the language.
The language selected affects both the installer program and the Split-Desktop software.
Currently we support English and Spanish language options. The language of the SplitDesktop interface can be changed at any time with this option.
25
26
Licensing
A license is required to use all of the features of Split-Desktop. Without a license, SplitDesktop will run in the limited viewer mode where many of the features are disabled.
To purchase a license or to request an evaluation demo, contact Split Engineering at any
of the locations here.
27
Unlicensed
Viewer
Yes
Yes
No
No
No
No
No
Yes
No
No
Demo
License
Yes
Yes
Yes
Yes
Yes
No
No
Yes
No
Yes
Academic
License
Yes
Yes
Yes
Yes
Yes
Yes
Yes
Yes
No
Yes
Full
License
Yes
Yes
Yes
Yes
Yes
Yes
Yes
No
Yes
No
28
Geography of Split-Desktop
Running Split-Desktop
The installer puts a shortcut to Split-Desktop on your Windows desktop. You can also
run it from the Start Menu, under Programs | Split Engineering | Split Desktop 3.1.
Split-Desktop Projects
You are always working with a project when you are using Split-Desktop. Projects
include the images and their delineations, plus the various options for calculating and
displaying results. When you open a project, you will see everything exactly as it looked
when you saved the project.
Split-Desktop projects can be shared by copying one project file (*.desk) and, with just a
few exceptions, projects appear exactly the same to anyone who opens it, regardless of
how theyve configured their personal copy of Split-Desktop.
29
30
The Display Window shows your images and results. The majority of your
interaction happens here.
The Images Window is a list of all images in the project.
The Layout Window provides you with an optional method of grouping your
images into meaningful samples.
The Display Window is always visible. You can hide the Images Window or the Layout
Window but not both through the View menu option.
Image display- Shows selected image files as 2-dimensional photos. This is where
you can edit the delineations, modify scales, and make other changes to the
individual images (see Working With Images).
~or~
Results display Shows the calculated size distribution results of the selected
images. See Working With Results.
31
32
Changing the display type between Image and Results Display does not change the
current selection. The illustration below shows two images in the different display. You
can switch back and forth between Image and Results Display any number of times.
Images Window
The Images Window appears as a vertical list in the upper right corner of the SplitDesktop main window. Images that are selected in this window will appear in the Display
Window.
33
The list in the Images Window includes every image that is in the project. Each image
appears once, regardless of how many times it may appear in the Layout.
Selecting Columns
The left column is always the Image column (the title appears at the top of the column)
and shows a thumbnail of the image along with the images status indicator. This is the
only mandatory column; the other eight columns listed here are optional.
To add, remove or change the order of the columns shown in the Images Window, from
the menu select View | Select Images Window Columns or right-click on the column
header and select the Select columns item.
Image Status
Each image in the Split-Desktop project has a status value that indicates whether the
image is ready for use in generating results. The image status is shown as part of the
image thumbnail in both the Images Window and in the Layout Window. You have three
34
options for how the status is displayed, as shown below. To change the status display,
select View | Status display options from the menu, or right-click on any thumbnail
and the same menu item will be on the popup menu.
Layout Window
The layout window is an optional tool for organizing your images. See the section
Organizing With the Layout Window for details. You can create any number of branches
in its tree-like structure. The primary reason for using the layout window is to create
groups for viewing results.
35
Image Status
The image status is displayed in the layout window exactly as it is displayed in the
Images List.
Selecting Images
There are two ways to select images: from the Images Window or from the Layout
Window. Selected images appear in the Display Window, where they appear either in
image form or in results form, depending on which type of display is active.
Selecting from the Images Window
Select one image by clicking on it in the Images Window. To select more than one image,
use the standard Windows key combinations of Ctrl or Shift while clicking.
Selecting from the Layout Window
Click on any image or branch in the Layout Window. Clicking on a branch that has more
than one image beneath it will select all of the images. If an image appears more than
once beneath a branch, it is shown only once in the Display Window.
36
Printing
Split-Desktop can print individual images or results. Images are printed the maximum
size that will fit on a single page, and results are printed on multiple pages. The first page
of the results printout is always the graph, and the columns of tabulated results are printed
on the following pages.
Display the item you want to print in either the Image Display or the Results Display, and
then File | Print from the menu or press the
button. This will present the standard
Windows printer dialog where you can select the printer and printer-related options. The
File | Page setup menu option lets you specify the margins of the printout. To preview
the format before actually printing, select File | Print preview or press the button.
37
Images that are added to the project appear in the Images window. From there you can
select one or more images to view or edit.
Image Status
The image status provides a visual indication of whether each image is ready to be used
in calculating results. Each images status is shown in the Images Window and the
Layout Window, and there you can modify the way the status is displayed with the Status
Display Options.
The status indicator will be one of these three values:
Yellow. Can be used for results, but results may not be reliable because the
delineations & scale have not been edited.
Green. Ready for results. The image is delineated and scaled, and has been
edited.
38
Viewing Images
Selected images are shown in the Image Display.
39
Image Properties
Select the menu item Image | Properties to see the properties of one or more selected
images. When more than one image is selected, only those properties common to all
images are shown.
40
41
42
The mouse wheel zoom is focused on the mouse position just like when using the Zoom
tool. When using the keyboard to zoom, the zoom is focused on the center of the display.
Panning
To use the Pan tool, select it from the toolbar or from the menu with Tools | Pan tool.
The mouse cursor will change to when the Pan tool is active. To pan the image, hold
down the left mouse button and move the mouse. You can also use the four directional
arrow keys to pan the image. To increase or decrease the distance panned with each
keystroke of the arrow keys, use the + and keys on the keypad. Press the Home key to
automatically pan the upper-left corner of the image to the corner of the display.
Delineations Off
Delineations On
43
With some images, particle outlines may be more visible if you select a different color for
the particle boundaries.
44
45
46
47
Or are they?!
Delineating Images
Delineations are the foundation of the size distribution calculations in Split-Desktop.
Delineating is a semi-automatic process of drawing borders around the boundaries of
rock particles in an image. It also includes filling areas of the image with color to indicate
that the area is to be masked, or that the area is mostly fines material. A delineated image
will show the original image overlain by the delineated boundaries.
Usually, the final delineations used in an image are a combination of the automatic
delineations performed by Split-Desktop and manual edits made to improve the quality of
the automatic delineations. It is possible to skip either of these steps, but in most cases the
most efficient and accurate method is to let Split-Desktop do most of the delineation
work for you and then do a little manual tidying up.
48
Automated Delineation
Existing delineations are deleted from the images. If you have already spent time
performing manual edits to the delineations, executing this command will wipe out those
edits.
To have Split-Desktop perform automated delineations, select one or more images and
execute the menu option Image | Delineate. The Delineation Settings dialog will give
you a chance to modify the level of delineations and auto-fines, as shown here.
Less delineation
More delineation
The appropriate Level of delineation may change with different images taken under
different environmental conditions. It is usually easiest to start with the level in the center
and make adjustments as needed.
49
Auto Fines
Check the Use auto-fines option to have Split-Desktop automatically identify particles
that appear to be patches of fines. Usually it is preferable to manually identify fines, so
this option is unchecked by default.
50
Original Image
Edited Delineations
Nifty Editing Shortcut!
There is a shortcut that allows you to quickly switch between the brush and the eraser: if
you hold down the Shift key before you press the left mouse button, the eraser tool
becomes brush tool and vice versa. This way you do not have to go to the toolbar or
menu to switch between the brush and the eraser.
Fines Example
In the example below, there are large rocks mixed in with the fines. In this case it was
easiest to first remove the delineations from the entire left side of the image by making a
Polygonal area selection and deleting the delineations. Then the boundaries of the coarse
particles can be drawn in, and the fine area is filled with the Fines fill tool.
52
Mask Example
In the image below, you would want to mask out the shovel bucket and probably some of
the unbroken rock face at the top. In this case the polygonal shape works the best.
The image below shows the mouse clicks used to create the polygonal masked area.
Notice that some of the clicks are outside the image. Thats a useful trick you can use
when you want to snap a selection line to the edges of your image.
55
Scaling Images
Split-Desktop allows one to three scales in each image. (It also allows zero, but in that
case the image cannot be used to calculate results.) Scales appear in the image as shown
below, displaying the length of the scale and the value of the scale in pixels per unit.
Typical Scale
56
Scales can be added manually, using the Scale tool, or automatically using scaling objects
in the image. Regardless of which method is used to add the scale(s), they can be
modified or deleted at any time by selecting them with the Scale selection tool.
Manual Scaling
To add a scale manually, select the scale tool from the toolbar
or from the menu with
Tools | Scale tool. Position the mouse over the first end point of the scale, press down the
left mouse button, and drag the mouse to the other end of the scale. When you release the
mouse button the scale dialog shown here will ask you for the length of the scale. Press
OK and Split-Desktop will insert the scale and calculate its value in pixels per unit.
57
Selecting a scale
Scale, selected
After the scale is selected, you can use the mouse to move either endpoint of the scale
with the end grippers, or move the entire scale by dragging the center gripper. To change
the known length of the scale, right-click on any of the grippers and select Properties
from the popup menu. The value of the scale is automatically recalculated after either of
these changes.
58
Right-Click on a Gripper
To delete all selected scales, select Delete from the popup menu shown above or select
Edit | Delete from the menu. To delete all scales in an image, select Image | Delete all
scales.
Automatic Scaling
Automatic scaling can be performed on images as they are added to the project. See the
section on automation for more information.
Automatic scaling works by locating scaling objects (generally the red scaling balls
provided by Split Engineering) in the image. Currently, automatic scaling works only
with round or spherical objects. The search for scaling objects is based primarily on their
color, so automatic scaling works best when the scaling objects in all images are the same
color.
Executing automatic scaling
To use automatic scaling, select Image | Find scales from the menu. You will have
the chance to change any of the options shown in dialog box below, or you can just click
OK to proceed with the same settings used last time.
59
Copy the color of the selected area (Edit | Copy) and then run the auto-scale tool (Image |
Find scales). When the clipboard holds image information, the Paste from Clipboard
button is enabled. Simply click that button to set the scale object color.
Rangefinder Scaling
To use rangefinder scaling, select Image | Rangefinder scaling from the menu.
This method is the most technically difficult. You must first calibrate your camera by
using similar triangles between the sensing array, the distance to the lens, the distance
from the lens to the object and the size of the image collected. This calibration will
change if the focal length is changed, so to use this method you must calibrate for
whatever zoom settings you acquire images at. It is probably only practical to use this
method for the most zoomed in levels and the most zoomed out levels on a zoom camera.
You must also use a rangefinder to record the distance to a particle that appears at the
bottom of the image and the distance to a particle that appears at the top of the image. If
you wish to use this method, please contact Split Engineering for further instructions and
help in calibrating your camera.
Rectangle selection
Polygon Selection
Circular selection
61
Use the toolbar button or select the menu option Edit | Select area and select one of
the shapes from the dropdown menu.
down while you trace the curve with the mouse. Release the mouse button to stop
drawing the curve. You can mix any combination of lines and curves. To erase one or
more previously drawn points, press the Backspace key.
To close the polygon, either press the Enter key or draw a point on the curve so that the
curve crosses itself. When the curve crosses itself, it will be automatically closed. Press
the Esc key to abort the current outline.
63
Circular selection
64
Editing Images
Cropping
The Crop tool reduces the area of the image. You might want to do this if a significant
part of the image does not contain broken rock to be used in the size analysis.
Select the crop tool from the toolbar or from the menu with Edit | Crop tool. Draw a
rectangle (see the selection tool description for drawing a rectangle) that includes all
scales in the image. If the image has scales in it, the cropped area must include all of the
scales or the cropping will fail with an error message.
65
66
67
68
As a reference, the original image resolution is available from the Image Properties.
69
Delineate
Check this box to automatically delineate images as they are opened. Press the Settings
button to modify the delineation parameters, which are the same as the parameters used
when this command is performed from the menu.
Fine Scales
Check this box to automatically locate scaling objects within images as they are opened.
Press the Settings button to modify the scale size and the parameters used to locate
scales. These settings are the same as those used when this command is performed from
the menu.
70
See the section Reducing Image Resolution for reducing the resolution after the image
has been added to the project.
71
Estimating Fines
Split-Desktop can see and measure particles, but in every image there is a point below the
resolution of the image where particles can no longer be seen and delineated. At this
point, Split-Desktop will estimate the remaining finer material. The fines cutoff chiefly
depends on the resolution of the image (in pixels/unit). The shape of the curve below the
cutoff is determined by the distribution of the particles right above the cutoff. SplitDesktop utilizes the best fit of either a Schumann or Rosin-Rammler equation to
represent the distribution of fines below the automatically computed fines cutoff point. A
regression is computed for the data before the fines correction for each method and the
one with the highest correlation is chosen.
Fines Factor
Since the black pixels in the image represent both fines and outlines of particles, a
percentage of these pixels are included in the fines calculation. This percentage is called
the fines factor, and can vary for each image.
Change the fines factor through the Image Properties dialog. You can either use the slider
bar to select a canned percentage, or you can manually type in any percentage value from
0 and above.
72
73
Few fines present. Use Low (or 10% - 20%). Or use None (0%) if you know fine
material has been screened out.
NOTE: The fines estimation does indeed change the size calculation that Split-Desktop
produces. If the image has many black pixels, the change in size results can be dramatic.
Before using Split-Desktop for your testing purposes or as a part of the daily regimen, it
is not unreasonable to calibrate a fines estimation factor for your site. You may want to
calibrate the fines factor by imaging material and comparing the sieve results to the SplitDesktop results. By altering the fines factor you should be able to get the lower portion
of the cumulative size curve to fit the sieve curve. Be sure to employ proper sampling
techniques before calibrating, otherwise the calibrated fines factor may not be accurate.
Contact Split Engineering if you want advice on developing a procedure. This will be
most beneficial when encountering finer material and especially when acquiring and
processing images of finer material on conveyor belts. For future systematic use of the
74
software you will have a consistent frame of reference if you start with calibrated
samples.
Because the fines estimation percent is a powerful user controlled parameter, remain
systematic in its use. Split-Desktop helps to be systematic by providing five options:
None, Low, Medium High and Very High; each with a corresponding preset percentage.
Wanton use of this parameter will hinder your ability to compare data output sets with
confidence.
The image below shows the effect of changing the Fines Factor. The five curves are from
the same image at different Fines Factor values.
75
Results Options
Result options are available on the Results Options dialog. Invoke the dialog by any of
the following methods:
76
General Options
Items on the General page of Results Options mostly control placement of the graph and
text boxes.
77
Graph only
Text only
Toolbar Shortcuts
Show just the graph
Show just the text
78
Left of graph
Right of graph
Above graph
Below graph
Toolbar Shortcuts
Left of graph
Right of graph
Above graph
Below graph
79
Graph Content
Curves Displayed
These options control how the curves that are displayed on the graph.
Combined Applies when more than one image is selected. When checked,
the combined size distribution of all images is displayed. Use the line style
combo box to select the line style for combined results.
Images Applies when more than one image is selected. When checked, a
curve for every selected image is displayed. Use the line style combo box to
select the line style for individual image results.
Intermediate Applies when a branch is selected from the Layout Window.
When checked, intermediate results from branches beneath the selected
branch are displayed. Use the line style combo box to select the line style for
intermediate results.
80
Axis Scales
Select linear or log scale for the size (X) axis and the percent (Y) axis.
81
82
Graph Colors
83
Adding a color
Select a color in the list by clicking on it. Selected colors can be deleted, changed (use the
Modify button), or moved up & down the list. Press Default to restore the color list to
the factory default.
84
Legend Position
The Legend Position graphic on the dialog shows the eight positions (radio buttons on
white boxes) relative to the graph, portrayed at the dark gray box. Four of the available
positions are shown here.
85
Logo
You can replace the Split Engineering logo in the lower right corner of the graph with
your own logo. To select a different logo, press the button and browse to a jpeg or
bmp file. Note: the entire image is stored in the Split-Desktop project, so large logo
image files may greatly increase the size of your Split-Desktop project file.
You can change the size of the logos at the bottom of the page by selecting the Small,
Medium or Large options.
86
Text Content
Text content controls the amount of information shown in the text output part of the
result.
87
Items Displayed
These options are analogous to the Curves Displayed options on the Graph Content page.
Final cumulative Applies when more than one image is selected. When
checked, the combined size distribution of all images is displayed.
Images Applies when more than one image is selected. When checked, a
curve for every selected image is displayed. Use the line style combo box to
select the line style for individual image results.
Intermediate cumulative Applies when a branch is selected from the Layout
Window. When checked, intermediate results from branches beneath the
selected branch are displayed.
88
89
FXO Series
Check Show FXO series to include the FXO series results in the text output.
Fines Factor & Cutoff
Check Show fines factor & cutoff to include the fines factor and the fines cutoff in the
calculated minimum size of delineated particles.
Fines Fit Statistics
Check Show fines fit statistics to include the calculated fines fit constants in the text
output.
Sieve Series
The sieve series is a virtual set of sieve sizes that you create. The purpose is to mimic the
size distribution results provided by a lab that does actual sieve analysis.
90
91
92
Units
These are the units of the sieve series, and not necessarily the same as the output units.
FXO Series
The FXO series is a virtual set of percent-passing values that you create. The purpose is
to mimic the size distribution results provided by a lab that does actual sieve analysis.
93
Reference Curves
Reference curves are optional size distribution curves that you can display on the graph.
Each curve consists of a user-defined sieve series that includes the percent-passing values
for each sieve size.
94
95
96
Units
These are the units of the sieve series, and not necessarily the same as the output units.
Exporting Results
Exporting is disabled in the Split-Desktop demo.
There are five primary ways to export your results from Split-Desktop:
Copy/Paste using the clipboard
Saving to a text file
Exporting to an Excel spreadsheet
Printing
Custom output with script
97
To copy the entire contents of the text window, select Edit | Copy text from the menu (see
the graphic above). You can also copy any part of the text window by selecting it with the
mouse, and then right-click on the text window and select Copy from the popup menu.
98
Exporting to Excel
When you export to Excel, the format of the output will mimic the way your results look
in Split-Desktop. For example, if you are showing the graph above the text, that is how it
will look in Excel.
To write the results to a spreadsheet and then immediately open the spreadsheet, select
Results | Save as. When the Save As dialog appears, select Excel file (*.xls) as the Save
as type. See the graphic above.
To export the results to a spreadsheet without first saving the spreadsheet, press the
toolbar button .
99
Results in Excel
Printing
Results are printed on multiple pages. The first page of the results printout is always the
graph, and the columns of tabulated results are printed on the following pages.
Select File | Print from the menu or press the
button. This will present the standard
Windows printer dialog where you can select the printer and printer-related options. The
File | Page setup menu option lets you specify the margins of the printout. To preview
the format before actually printing, select File | Print preview or press the button.
100
101
102
In the examples below, note the selected branch in the tree and the resulting collection of
selected images.
103
As with any selection, you can switch between the Image Display and the Results
Display to see the selection as images or as results.
104
Adding Branches
To add a new branch to the Layout tree, right-click on the branch which will become the
parent branch and select New branch from the menu. A new branch will appear, waiting
for you to edit its name.
105
Adding Images
Add images to branches in the Layout tree by dragging them from the Images Window.
106
Scripting
Scripting is a way to extend the features of Split-Desktop. For example, you can use
scripting to automatically create branches in the Layout tree each time images are added,
or to employ a custom algorithm when performing delineations.
Introduction to IronPython
Split-Desktop uses IronPython as its scripting language. IronPython is a variant of the
popular Python language that is tailored to the Microsoft .NET platform, making it ideal
for Split-Desktop. It is public-domain software, distributed along with Split-Desktop
under Microsoft Public License.
If you plan to do any significant amount of scripting, we highly recommend taking time
to learn the basics of the IronPython scripting language. Many books on the subject are
available, as well as online sites such at the IronPython home page that offer tutorials.
107
Only one script file at time can be run from the command line this way.
108
Processing Point
Before attempting to open one or more image
files from disk on request from the interactive
user
After opening one or more image files from disk
on request from the interactive user, after any
automatic image processing takes place.
Before attempting to open each individual image
file from disk. Differs from PreOpenImages.py in
that this executes once for each image, and files
opened from other scripts will invoke this.
After opening each individual image file from
disk. Differs from PostOpenImages.py in that this
executes once for each image, before any
automatic image processing takes place.
Before delineating an image. This can replace
the standard delineation algorithm.
After an image has been delineated.
When results are requested from an image. This
can replace the standard results calculations.
When the Histogram of sizes is requested from
an image. This can replace the standard
histogram generation.
PostOpenImages.py
PreOpenImage.py
PostOpenImage.py
PreDelineateImage.py
PostDelineateImage.py
CreateResultsFromSingleImage.py
CalculateHistogram.py
Sample Scripts
Refer to the sample script files in the scripts/samples folder of the Split-Desktop
installation. These sample scripts include comments that describe objects which are made
available to the script, plus they may help get your started writing your own script.
Caching Script Files
Script files are not cached, but their existence is. That means that you can change the
content of a script file while Split-Desktop is running. However if a script file does not
exist the first time Split-Desktop looks for it, it will not be searched for again until you
restart Split-Desktop.
109
To start the interpreter, run the ipy.exe program that is installed in the Split-Desktop
installation folder. The screenshot below shows the first three commands you are likely to
execute inside the interpreter. These commands import the Split-Desktop interface into
IronPython. Note that when running automation scripts from within Split-Desktop, these
commands are executed automatically and do not need to appear in your script file.
Getting Help
The best way to get help is by looking over the sample scripts and exploring the script
interface with the interpreter. After executing the three statements shown above, you can
explore the Split-Desktop interface to IronPython using the dir( ) and help()
commands. A few examples are shown below with the commands shown in blue.
>>> dir(Desktop)
['Algebra2D', 'CodedPoint', 'ColorSpace', 'ColorTriplet', 'DefaultDelineationSet
tings', 'DesktopDocSimple', 'Frame', 'GaussianSmoothList', 'Gray8Frame', 'Histog
ram', 'HistogramFraction', 'HistogramResizer', 'Image', 'ImageTreeNode', 'MainWi
ndowProxy', 'Particle', 'Properties', 'RGB24Frame', 'RawParticle', 'ReferenceCur
ve', 'Results', 'ResultsCalculatorOrig', 'ResultsDisplay', 'Shell', 'SieveSeries
', 'Win32']
>>> dir(Desktop.Algebra2D)
['Exact32', 'Real4']
>>> dir(Desktop.Algebra2D.Exact32)
['Point', 'Polygon', 'Rect', 'Segment', 'Vector']
>>> help(Desktop.Algebra2D.Exact32.Point)
Help on class Point:
class Point(__builtin__.object)
| Point()
| Point(Point that)
| Point(int x_, int y_)
| Point(Point pt)
| Point(Point pt)
|
| Methods defined here:
|
| Assign(...)
| Assign(self, Point that)
| Point Assign(self, Point pt)
110
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
DistanceTo(...)
Single DistanceTo(self, Point that)
Translate(...)
Point Translate(self, Vector direction, Single distance)
Translated(...)
Point Translated(self, Vector direction, Single distance)
__add__(...)
x.__add__(y) <==> x+y
__div__(...)
x.__div__(y) <==> x/y
__eq__(...)
x.__eq__(y) <==> x==y
.
.
.
111