Documenti di Didattica
Documenti di Professioni
Documenti di Cultura
Copyright
This documentation copyright 2010 Split Engineering, LLC. All rights reserved. Split-Desktop software copyright 2010 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
Geography of Split-Desktop............................................................................................. 29
Running Split-Desktop ........................................................................................................... 29 Split-Desktop Projects ............................................................................................................ 29 Three Important Windows..................................................................................................... 30 The Display Window: Images or Results .............................................................................. 31 Images Window ....................................................................................................................... 33 Layout Window ....................................................................................................................... 35 Selecting Images ...................................................................................................................... 36 Printing .................................................................................................................................... 37
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.0, 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:
Start With a New Project From the menu, select File | New Project. Reset System Options From the menu, select Tools |Options. Ensure that only the first and last options are checked, as shown here.
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.
Results Exported to Excel Copy/Paste with the Clipboard From the menu, select Edit | Copy text or Edit | Copy graph. The text or bitmap can be pasted into any application that supports the format.
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
Reduce Resolution
Crop Image
Delineate
Scale
Edit Delineations
Fines Estimation
Show Results
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.
Select the language After you have had the chance the read the license agreement and additional installation information in the Readme file, you can select the destination folder of the installed software.
25
Error on Windows Server 2008 If this happens, first ensure that your account has administrator privileges and then start the Server Manager (Start Menu | Administrative Tools | Server Manager). Select Features, then Add Features, and check the box for .NET Framework 3.0 Features.
26
Adding .NET Framework 3.0 Features to Windows Server 2008 Continue with the wizard to install the .NET Framework 3.0 features, and then run the Split-Desktop setup program again.
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
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.0.
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.
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. Name The images display name Fines Factor The user-defined fines factor for the image Results Status The images status in text form Scale Scaling information Resolution The number of rows & columns in the image Modified The date this image was last modified in this project Added The date this image was added to the project File Name The original file name of the image
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.
Selecting Images Window columns Use the button labeled <<==>> to move columns between the Displayed and Hidden collections. To change the order of the displayed columns, select a column name in the Displayed Columns list and use the Up and Down buttons to move its relative position.
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
The Layout Window In the layout shown above you can get instant results for all images taken on K-Bench by clicking on the K-Bench node. If you are only interested in the images on K-Bench that were in Shot 234, you would click on the Shot234 node.
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
Images Window Columns The Results Status column in the Images Window provides a concise summary of the images status, and the Scale column give details about the scales in the images. Refer to the section on the Image Window Columns for information.
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
Image Properties single image The only items that can be modified from the Image properties dialog are the Display Name and the Fines Factor. Display Name The images name as it appears in Split-Desktop. The default name of an image is its file name. Columns and Rows The current resolution of the image. Fines Factor The estimated fines factor used in generating the size distribution results. Original Image The name and resolution of the image when it was added to the project.
41
Added & Modified The time the image was added to the project, and the last time it was modified.
Zoom tool showing how mouse position is maintained Other ways to zoom There are two other ways to zoom without using the zoom tool: Mouse wheel + and keys on the keypad These might be useful when you have another tool selected, for example when you are editing an image, and do not want to have to invoke the Zoom tool.
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.
Nifty Shortcut for Panning! You can pan at any time without having to select the Pan Tool but holding down the right mouse button and moving the mouse.
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
Mouse-over feedback outline in yellow To modify the mouse-over options, select the menu option Image | Display options.
45
Image Display Options The two options for mouse-over information are Highlight particles (draws particle outlines) Tooltip information (shows approximate particle sieve size, scaled if possible) Both of these effects are shown in the image above where the particle is outlined with yellow and the tooltip shows the scaled particle sieve size is approximately 4.41 inches. Particle Highlight Options The particle highlight can show the particle outline, the best-fit ellipse (used to calculate the particles sieve size), or both. To change the highlight options, press the Settings button shown above.
46
Using Particle Highlight While Editing Delineations The two images below illustrate how to use the particle highlight to improve delineations. The first image shows what appear to be good delineations, however the second image shows where a small bridge between two particles that might be missed by the human eye is made obvious with the highlight outline.
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.
Automated Delineation Settings Move the Level of delineation slider to adjust the amount of delineation and press OK. Do not forget to turn delineation visibility on to see the results. The effects of moving the slider are shown in the two images here. The same image was delineated with different Level of delineation settings.
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.
Cut and fill an area with the Fines area tool One particle at a time with the Fines fill tool
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
Scaling object diameter diameter of the scaling balls Scaling object color color of the scaling balls, see below Apply mask to scale object check this to mask out the scaling objects after they are located
Setting the scaling object color The most reliable method of setting the color of the scaling objects is to copy the color from an image. As shown in the image below, select an area of a scaling ball that is representative. For example, avoid the edges of the ball where lighting may create bright spots and avoid discoloration such as the writing shown here.
60
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.
Clipboard option enabled An alternative method of setting the color is to use the standard windows color selection dialog, which you can invoke with the button.
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.
Use the toolbar button or select the menu option Edit | Select area and select one of the shapes from the dropdown menu.
Three selection shapes Rectangular Area Selection Position the mouse over one corner of the desired rectangle and press down the left mouse button. Holding the button down, move the mouse to the opposite corner and then release the button. The selected area is highlighted with a marching ants border and a shaded interior.
Rectangular area selected Polygon Area Selection The polygonal selection tool can draw straight lines, curves, or both. To draw straight lines, click the left mouse button (one click equals button down + button up) on the endpoints of the segments. To draw a curve, press the left mouse button down and hold it 62
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.
Polygonal area selected In the example shown above, part of the area was drawn with straight lines and part was drawn with a curve. To draw a polygon selection that touches the borders of the image, move the mouse beyond the boundary of the image and click a point. The selection point will be snapped to the closest edge of the image. In the graphic below, the points where you might click the mouse are indicated with red dots and lines pointing to the snapped location.
63
Polygonal area that touches the image boundaries Circular Area Selection Position the mouse over any point along the circumference of the circle. Press down the left mouse button and move the mouse to the opposite point on the circumference of the circle.
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
Some example resolutions are shown in the table below. Columns and Rows 700 x 700 1024 x 1024 2048 x 2048 4096 x 4096 Approx resolution (pixel count) 0.5 Megabytes 1 Megabyte 4 Megabytes 16 Megabytes
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
Fines Factor on Image Properties The Fines Factor can be modified on more than one image at a time. Select any number of images to change them all at once. If you do not want any black pixels to count as fines, i.e. rip rap material where the fines have been screened out, then move the slider to None which will enter 0%. Similarly, if the material is very fine, you will want all of the black pixels to count as fines, thus move the slider to High, which will select 100%. Of course, Split-Desktop will allow any percentage to be entered. The default setting for muckpiles is 50% and the values above 100% are typically used when calibrating conveyor belt material. Example guidelines for setting this percentage are shown in the images below. Obviously not all images from a muck pile will look the same so you should set this number based upon your overall impression. If you are group processing images, note that the same fines percentage is applied to all images.
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: Menu option Results | Results options Right-click on the graph or text and select Results options
76
General Options
Items on the General page of Results Options mostly control placement of the graph and text boxes.
77
Graph only Toolbar Shortcuts Show just the graph Show just the text
Text only
78
Left of graph
Right of graph
Above graph Toolbar Shortcuts Left of graph Right of graph Above graph Below 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
Reference Curves Reference curves are displayed when checked. Cumulative Curve When checked, curves are shown as cumulative histograms Sieve series histogram- When checked, curves are shown as non-cumulative histograms
Axis Scales
Select linear or log scale for the size (X) axis and the percent (Y) axis.
81
82
Graph Colors
Result Options Graph Colors The curves that are shown in the graph are assigned colors from the list on this page. The colors are assigned in the same order that the results appear in the legend. If there are more curves displayed than there are colors in the list, the list repeats.
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
The Same Tree Showing Anatomy In the example above, the root includes two children which are branches: the K-Bench branch and the L-Bench branch. The L-Bench branch has two children which are images. The more complicated K-Bench branch has two children which are also branches: Shot234 and Shot235. Both of the Shot branches have one image child each.
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.
At various points during processing, Split-Desktop will attempt to locate an appropriately named IronPython script file that matches the processing point. If the script file exists, Split-Desktop executes the script. The list of processing points and matching script file names are shown below. To customize the behavior of Split-Desktop at one of the processing points, make sure that the appropriately named script file exists in the scripts folder of the Split-Desktop installation. It must actually be in the scripts folder, and not any subfolders.
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
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