Line Measurements Line Measurements
The Line Measurement tool measures a collection of lines including the endpoint coordinates, length, and angle. The endpoint coordinates are reported in both (column,row) and world coordinates for images having a world coordinate calibration. Coordinates are marked using the mouse crosshair and may be refined using precision centroid coordinates computed near the clicked point. Lines drawn on the image are persistent until you leave Lines mode by closing the toolbar. Results are reported in the Lines Measurement Pane or Line Measurements report window. The toolbar opens with Marking Mode (top button) active. Lines may also be measured using the CMeasureLines class in the Pro Script Module. See the Mira Pro x64 Script User's Guide for details.
To activate the Line Measurement tool,
click on the Image Measurements
Toolbar or select Lines Toolbar in the Measure
menu.
The picture below shows two lines marked on an image. The results may be directed to a measurement pane or report window, as described below.
Adjust the image to the desired scale, showing the region to measure.
Click the
button on the Image Measurements Toolbar or use the Measure > Lines Toolbar menu command to open the
toolbar. Marking mode is automatically enabled when the toolbar is
first opened. To reactivate Marking Mode it, click at the top of the Plot Lines
Toolbar.
Move the mouse to the starting point. Press and hold down the left mouse button.
To draw a line only in multiples of 45 degrees, press the SHIFT key and hold it before starting to draw. Do not release the SHIFT key until after releasing the mouse button at the end of the line.
If 
Centroid First
Point is checked on the Centroid
Properties (Markers) page, the position will lock onto the
local centroid near where the mouse is released.
With the left button down, drag the mouse pointer to the endpoint and release the button.
If Centroid Last Point is checked on the
Centroid
Properties (Markers) page, the position will lock onto the
local centroid near where the mouse is released.
The results are reported in the Lines measurement docking pane or window.
To measure other lines, repeat steps 3 and 4.
When finished drawing lines, you can disable
marking mode by clicking 
on the toolbar.
You may choose to draw new lines of arbitrary
length and angle or you may add lines of the same length parallel
to the last line. Parallel lines are drawn by using the 
button.
Press the 
button
and rubber-band the first line vector on the image. The line
properties are listed in a grid window (Measurement Pane or
Report
Window).
Press the button
and click on an image point through which you want to place a new
line of equal length parallel to the previous line. The line
properties are listed in a grid window (Measurement Pane or
Report
Window).
Repeat step 2 to add additional parallel lines.
To draw a different line, repeat step 1 and, optionally, steps 2 and 3.
|
TIP |
Before tracking through an image set, be sure
|
Measurements are tabulated in a grid window (Line Measurements measurement pane as shown above, or a Report Window as shown below). The difference between the two output options is that the Lines measurement pane receives only measurements of that Image Window whereas the Line Measurements window is global and receives measurements from all Image Windows.
If the image has a World Coordinate System ("WCS") calibration, then X1, X2, Y1, and Y2 give the WCS values corresponding to listed column,row coordinates.
Column data in the Lines pane and Line Measurements report are described in the table below. The last few columns from the table below are not scrolled into view in the picture above.
|
Line Measurements Column Data |
|
|
# |
The sequence number of the measurement. |
|
Image |
The name of the image that was measured. |
|
Index |
The marker index for the particular image. |
|
Distance |
The distance in pixel units, or World units if the image has a WCS calibration, between the beginning and ending points. |
|
Angle |
The angle in degrees. |
|
X 1 |
The X coordinate of the starting point. |
|
Y 1 |
The Y coordinate of the starting point. |
|
Value 1 |
The image pixel value at the starting point. |
|
X 2 |
The X coordinate of the ending point. |
|
Y 2 |
The Y coordinate of the ending point. |
|
Value 2 |
The image pixel value at the ending point. |
|
Col 1 |
The column coordinate of the starting point. |
|
Row 1 |
The row coordinate of the starting point. |
|
Col 2 |
The column coordinate of the ending point. |
|
Row 2 |
The row coordinate of the ending point. |
|
Notes |
Space to add comments about the measurements. These will be included if you export the table to a text file. |
As with other interactive marking commands, the
Line Measurements command can use the exact marked endpoints
or it can compute either or both of the endpoints as a precise
centroid position. All 4 combinations of centroid or no centroid
and starting point or ending point are possible. To set these
options, click 
on the toolbar to open the Marker Properties dialog for
this command, then set Centroid First Point or Centroid Last Point accordingly.
The related Distance & Angle measurement tool marks only one line on a single image per window. However the general operating principles are the same. The topic Examples of Distance & Angle Measurement discusses centroiding the starting and ending points when making a line measurement.
Mira Pro x64 8.72 User's Guide, Copyright Ⓒ 2024 Mirametrics, Inc.
All Rights Reserved.
If checked, the centroid coordinates
will be computed for every member of the image set.