Size Stream Studio. Operation Manual. September 2016 v7.0. This manual describes the operation of the Size Stream Studio 3D measurement software.

Transcription

1 Size Stream Studio Operation Manual September 2016 v7.0 This manual describes the operation of the Size Stream Studio 3D measurement software.

2

3 Table of Contents Size Stream Studio Operation 1 Automatic Measuring Operations 2 Mouse Functions 2 Load Operations 2 Processing Operations 2 Save Operations 2 Automatic Measuring Options 3 Automatic Measurement Results 3 Manual Measuring Operations 4 Raw 3D Data Controls 4 Refined Body Mesh Controls 5 Line Tool Options 6 Height from the Ground 6 Line Distance between Two Points 7 Curve Distance between Two Points 8 Slice Tool Functions 9 Segment Volume 11 Moving Landmarks 12 Marker Tool Functions 14 Batch Process Operations 16 Settings 18 Switching Views 18 Visual Settings 19 Data Load Settings 20 Measurement Units 21 View Operations 21 License Dialog 21 Exact Match Avatar 22 Custom Measurement Editor 24 Custom Measurement Editor Tutorial 25 Choosing a Waist Measurement 28 Parameterized Waist Circumference 29 OptimizedMeasurement.mg file 30 Adjusting the Parameters 31 Changing the Measurement List Order 32 Size Stream Standard Measurement Definitions 33 Size Stream Measurement List by Number and Alphabetically 42 Size Stream Landmark List by Number and Alphabetically 46 System Shortcut Keys 49

4

5 Size Stream Studio Software Operation The Size Stream Studio software enables the user to expand the use of the 3D data output of the Size Stream 3D Body Scanner. The Studio application allows the user to: manually create and manipulate measurements that may not be found in the Body Scanner measurement list; process multiple scans using the Batch Process function; post-process scans for use in 3D printing applications; work offline away from the scanner which could increase scanner availability and utilization by others. Launching the Size Stream Studio software opens the Automatic Measuring Screen: From this screen, the user can navigate to the other screens by clicking on any of the buttons at the top of the screen: Automatic Manual Batch Settings Exact Match Measuring Measuring Process Avatars The user chooses operations in the field at the left in each screen. As an operation is chosen, subsequent allowable operation buttons are revealed. The System Status bar at the bottom will show the file name of the loaded image. It tracks and records the operations chosen by the user and displays error messages in red should any occur. The System Status bar can be closed by clicking on Hide System Status Messages, and can be opened or closed by clicking the green check mark at the top of the screen. When the System Status bar is closed, the green check mark will turn into a red X if an error message occurs. 1

6 Automatic Measuring Operations: Mouse Functions: Hold the LEFT mouse button to rotate the 3D data image in all axes. Hold the RIGHT mouse button to position the 3D data image on the screen. Roll the Scroll wheel to gross zoom the 3D data image in and out. Press the Scroll wheel to fine zoom the 3D data image in and out. Load Operations: Load Raw Data use to load a Raw 3D data file (in.binary or.xyz or.obj formats). Load Refined Body Mesh use to load a Refined Body Mesh file (.obj format only). Load Avatar use to load an avatar file (.obj format only). Processing Operations: Create Refined Body Mesh use to process Raw 3D data into a Refined Body Mesh. Get Measurements use to extract measurements from the Refined Body Mesh. Create Avatar Choose from the template avatar files in c:\ Size Stream \ Studio \ Avatar Files. Measurements must be extracted from the Refined Body Mesh before an avatar can be created. Save Operations: Save Raw Data use to save the raw 3D data to file (as.binary,.xyz,.obj, or.wrl). Save Refined Body Mesh use to save the Refined Body Mesh to file (as.obj). Save Measurements use to save extracted measurements (core, custom, landmarks, horizontal slices) to a text file. 2

7 Automatic Measuring Options: Take Custom Measurements click to extract measurements using a custom measurement file in addition to the core measurement set. The custom measurement list will be displayed at the bottom of the core measurements in the output list. Select the custom measurement file in the Settings screen. Show Landmark Coordinates click to extract the XYZ coordinates of the more than 160 available body landmarks. The landmark coordinates list will be displayed at the bottom of the core measurements in the output list. Automatic Measurement Results: The Automatic Measurement Results displays the measurement sets selected by the user. This includes the core measurements as defined in the Measurement Selector tool (See: Changing the Measurement List Order) as well as a custom measurement set and Landmark coordinates. Circumference and linear measurements are displayed on the 3D image. Height measurements are measured vertically to the floor but are not displayed. The user can click on a specific measurement in the list to highlight it on the image. Multiple measurements can be displayed by holding the CTL key while choosing. CTL-A highlights all measurements. CTL-S clears all highlighted measurements. 3

8 Manual Measuring Operations A key feature of Size Stream Studio is the ability to take manual measurements from the 3D data. This gives the user the ability to gather measurement data that may not be available through the automatic measuring options. Manual measurements can be extracted from either the Raw 3D Data on a limited basis or more extensively from the Refined Body Mesh. These measurements can be saved and given userspecified names. In addition, there is a selection of body landmarks that can be manually adjusted by the user to achieve a custom or different measurement, or to alter an existing one. Once moved, landmarks can be saved as a new file for later use without losing the original file landmark positions. Raw 3D Data Controls The green check mark indicates manual measuring is set to work with Raw 3D Data. A new raw data set can be loaded by clicking the Load Raw 3D Data button. Manual measurements from raw data are limited to Height from the Ground measurements and Line Distance Between Two Points. To use: Select the measurement function. Hold the CTL key and left-click the mouse on the3d image for the measurement. The measurement line will appear on the 3D image and the measurement value will appear in the output Results box. 4

9 Refined Body Mesh Controls The refined body mesh provides the user with more manual measurement tools, the ability to move selected body landmark points, and the ability to see individual slices of the body as well as the volume of a designated body segment. The green check mark indicates manual measuring is set to work with a Refined Body Mesh. A new Body Mesh file can be loaded by clicking the Load Refined Body Mesh button. If a raw data file was initially loaded and converted to a refined mesh, you can switch between the two by clicking either the Refined Body Mesh or Raw 3D Data box. The available manual measurements are shown and some can be extracted either as a simulated tape measure which spans the body depressions or as a contour measurement which follows the contours of the body. To use: Select the measurement function desired. Hold the CTL key and move the mouse on the3d image. Move the crosshair to the desired location on the 3D image and left-click to take the measurement. The measurement line will appear on the 3D image and the measurement value will be stored in the measurement Results box. Each mouse click will take a new measurement. 5

10 Line Tool Options Height from the Ground Hold the Ctrl button and left mouse click on the image to get the vertical distance from the selected point to the floor. The result is shown in the Tape Measure box and listed in the measurement Results box. Results box: As manual measurements are extracted they will be listed successively in the measurement Results box. Click on a measurement in the to activate it. This selects the tool used to create the measurement, as well as displaying relevant information about the measurement and highlighting it in the display. Select a manual measurement and press the Delete key to remove it from the list. The measurements in the list can be reordered by clicking and dragging a measurement to the desired position in the list. A measurement can also be renamed. Select the measurement and enter the new name into the Name Result text box and then press the Name Result button. Toggle the Tape Measure button the see/hide the drop line. Click Save Session to save the measurements to a file of your choice. Click Load Session to resume work on a previously saved session.. Click Export Excel to save the measurments for working in an Excel worksheet. Click Print to save a front and side view of the selected measurement for printing. 6

11 Line Distance Between Two Points Hold the Ctrl button and left mouse click on the image to get the straight line distance between two selected points. Note that this will be shown as a straight line that will pass through the 3D image making it useful for widths and depths. The result is shown in the Tape Measure box and listed in the measurement Results box. Multiple line measurements can be extracted and they will be listed successively in the measurement Results box. Click on the measurement in the list to see it on the image again. A selected measurement can be renamed by clicking the Name Result button and entering a name in the box. A selected measurement can be removed by using the Delete key on the keyboard. Toggle the Tape Measure button the see/hide the measurement line. Click Save Session to save the measurements to a file of your choice. Click Load Session to resume work on a previously saved session.. Click Export Excel to save the measurments for working in an Excel worksheet. Click Print to save a front and side view of the selected measurement for printing. 7

12 Curve Distance Between Two Points Hold the Ctrl button and left mouse click on the image to get the distance over the surface of the body between the two selected points. This measurement can be taken either as a simulated tape measurement which spans the concavities or as a contour measurement which will follow the contour of the body. The result is shown in both the Tape Measure and Contour boxes and the measurement is listed in the measurement Results box. Toggle the Tape Measure button the see/hide the green simulated tape line. Toggle the Contour button to see/hide the red contour line. Multiple line measurements can be extracted and they will be listed successively in the measurement Results box. Click on the measurement in the list to see it on the image again. A selected measurement can be renamed by clicking the Name Result button and entering a name in the box. A selected measurement can be removed by using the Delete key on the keyboard. Toggle the Tape Measure button the see/hide the measurement line. Click Save Session to save the measurements to a file of your choice. Click Load Session to resume work on a previously saved session.. Click Export Excel to save the measurments for working in an Excel worksheet. Click Print to save a front and side view of the selected measurement for printing. 8

13 Slice Tool Functions Horizontal Slice Hold the Ctrl button and left mouse click on the image to see the slice at that point in the viewer box. A Horizontal Slice is best viewed on the torso but can also be used on the arms or legs. Use the Slice Cross Section on non-vertical arms and legs for best result. The Tape Measure box shows the simulated tape measurement of the slice in the viewer. Toggle the check box to see/hide the green measurement line on the body image. The Contour box shows the contour or perimeter measurement of the slice in the viewer. Toggle the check box to see/hide the red measurement line on the body image. The Bounding Box shows the maximum Width and Depth of the slice in the viewer. Toggle the check box to see/hide the bounds rectangle on the image of the slice in the viewer. The Surface Area box shows the surface area of the slice in the units being used ( inches²; cm², mm²). The blue lines appearing in the slice depict the area being calculated. Toggle the check box to see/hide the blue lines on the body slice. The Height from the floor of the viewed slice is shown in the box above the slider bar. This value is always in mm and can be manually changed by the user to select a different or specific slice height. The Slider Bar can also be used to move the slice view up or down on the body image. Click Store Slice to record that slice in the measurement Results box to be saved. The measurement values do not appear in the Results box but are saved in the file to be exported to Excel. 9

14 Cross Section Slice This slice tool is used on the arms and legs to see a cross section slice along the axis of the limb. Hold the Ctrl button and left mouse click on the body image arm or leg to see the slice at that point in the viewer box. A selected measurement can be renamed by clicking the Name Result button and entering a name in the box. Click Save Session to save the measurements to a file of your choice. Click Load Session to resume work on a previously saved session.. Click Export Excel to save the measurments for working in an Excel worksheet. Click Print to save a front and side view of the selected measurement for printing. 10

15 Segment Volume This tool gives the Volume of the selected segment. Hold the Ctrl button and left mouse click on the body image to select the upper and lower levels of the segment to be measured. The Volume of the segment will appear in the measurement Results list in the units being used (inches 3 ; cm 3 ; mm 3 ). Multiple segments can be selected and they will be listed successively in the measurement Results box. Click on the measurement in the list to see it on the image again. A selected measurement can be renamed by clicking the Name Result button and entering a name in the box. Click Save Session to save the measurements to a file of your choice. Click Load Session to resume work on a previously saved session.. Click Export Excel to save the measurments for working in an Excel worksheet. Click Print to save a front and side view of the selected measurement for printing. 11

16 Moving Landmarks Moving measurement landmarks is a way to change the placement of an extracted measurement on the body image. Although all measurements have landmarks, only a selected few are exposed to the user in this function. They are shown on the image below and include the Armpits, the Waist, the Crotch, and a set of points related to the Bust/Chest. The four Waist landmarks (Front, Back, Left, Right) can be moved to reposition either the Waist Circum Tape Measure or either of the Optimized Waist measurements, depending on which of these the user prefers. These landmarks can not be moved off the body surface. The Crotch landmark can be moved to reposition the Crotch point to compensate for clothing that might result in an incorrect crotch point placement by the software. This landmark can be moved off the body surface, for example, to place the crotch point lower than where found. The Armpit landmarks (R&L) can be moved in all axes and can also be moved off the body similar to the Crotch landmark. The Bust/Chest landmarks can be moved in any direction but can not be moved off the body. Landmarks moved can be saved in the new positions with the 3D body data as a new file for future use and the original position file is kept intact. 12

17 To Move Landmarks: 1. Click the Move Landmarks Tool button to see the available landmarks on the 3D image. 2. Select Landmark to be moved from the drop down list. The selected landmark will then be highlighted on the 3D image. 3. Move the crosshair to the desired position. Hold the CTL key and Left click the mouse and the landmark will move accordingly or drag the landmark to the new position. 4. Once the landmark has been moved to the desired location, click the Store and Process button. This stores the landmark in the new position and re-extracts the measurements. The revised measurement list appears on the Automatic Measurement screen. In addition, the recomputed value will be listed in the Results box on the Manual Measure screen. Original Position click this button to restore a moved landmark to its original position. This also applies to landmarks that were previously moved and then saved. Original Position (All) click this button to restore all moved landmarks to their original positions. This also applies to landmarks that were previously moved and then saved. Save Refined Body Mesh this button saves the Body Mesh with the moved landmark locations. The user can save this Body Mesh as a new file or can overwrite the original file. When this saved file is recalled, the new landmark locations can be moved again if desired. Overlay Raw 3D Data on Refined Mesh overlays the Raw Data over the Refined Body Mesh. This is most useful for color scanning analysis of landmarks that have been manually placed on the body. To use this option, the Raw Data file must first be loaded and processed to the Refined Body Mesh in the Automatic Measuring tab. Switch to the Manual Measuring tab and check the box to Overlay Raw 3D on Refined Mesh. With the color raw data now over the body mesh, the available manual measuring tools can be used with any user-placed markers. NOTE: User-placed body markers are not moveable! Click Save Session to save the measurements to a file of your choice. Click Load Session to resume work on a previously saved session.. Click Export Excel to save the measurments for working in an Excel worksheet. Click Print to save a front and side view of the selected measurement for printing. 13

18 Marker tool: The marker tool provides a way to add and store arbitrary markers to the body mesh. These markers have no influence on measurements. The markers can be added in two ways: 1) Ctrl + Left click on the body mesh 2) Ctrl + Left click on the Overlay Selected Slices 2D slice window. To use the Overlay Selected Slices Window: 1) Create and store one or more horizontal slices using the Slice Tool. 2) Select the Marker tool and select one or more (up to four) of your horizontal slices using the pulldown controls beneath the Overlay Selected Slices. This will display those slices in the Overlay Selected Slices 2D slice window. 14

19 Use the radio button next to the pulldown controls to select one of the overlay slices as active. The active slice will be drawn in white. The inactive slices will be drawn in black. Use Ctrl + Left click in the Overlay Selected Slices 2D slice window to add a marker at the height of the active overlay slice. Overlay Selected Slices: Up to four horizontal slices can be selected for simultaneous display in the Overlay Selected Slices 2D slice window and on the 3D display of the body mesh. Any markers that are within +/- 2.0 mm in height of the active slice will also be drawn in the 2D slice window. They will also be drawn on the 3D display of the body mesh. The measurement information (tape measure circumference, contour, bounding box and surface area) of the active slice will be displayed. The Export DXF button allows you to export the slice information about the Overlay Selected Slices and any markers that are within +/- 2.0 mm of the active slice to a DXF file format. Export Excel: The manual measurement information can be saved to an Excel-friendly CSV format file. Print: The 3D display can be printed using the Print button. Note that the Print button will use the currently selected display options when it renders the mesh, such as: Select Show Landmarks in the automatic measurement tab to have landmarks displayed. Use Ctrl +A to select all automatically extracted measurements (and landmarks) for display. Use Ctrl + S to unselect all automatically extracted measurements (and landmarks) for display. Select different colors and appearances for the body mesh, measurement lines and landmarks in the Settings tab. Select to use a grid using the Ctrl + G to toggle the grid display, or go to the settings tab. Currently you cannot print out measurement values to the print out. You can customize the logo on Studio and on the Printout by creating a Logo.bmp file and adding to the Studio Executables folder. 15

20 Batch Processing Batch Processing allows the user to automatically perform multiple functions on multiple scan data files. This is particularly useful for such things as processing saved scans with a new or revised measurement file or converting files to a different format for use in a 3D CAD program. The user loads the files to be processed, chooses the operation(s) to be performed on those files, and then can either let the processing run unattended or can view each scan file individually. Add Raw Data or Refined Body Mesh File Load files to be batch processed here. Files loaded should be of the same type, either raw data or body mesh. Files loaded should be of the same format, e.g. binary, obj, etc. Multi-scan data sets can be processed as individual scans for individual results but a set of single scans can not be processed as a multi-scan set for composite results. Files can be loaded from different folders. Click the Add Raw Data or Refined Body Mesh Files button again to go to a different folder. Clear Files clears all loaded files from Batch Process. Reuse Processed Files reloads the same files for use in another Batch Process. 16

21 Batch Process Options Raw Data Process Options Raw data files can be: converted and saved in a different format, e.g. binary to obj. processed to Refined Body Mesh and saved as obj. take and save measurements to individual files and/or spreadsheet. The user can choose core measurements, custom file measurements, Landmarks or any combination for the extraction. The user will be prompted to designate the saved file location as process options are selected. Body Mesh Process Options: Single scan Body Mesh files can be used to take and save measurements to individual files and/or a spreadsheet. The user can choose core measurements, custom file measurements, Landmarks or any combination for the extraction. Composite Measurements Users of the multi-scan function can use the batch process to extract measurements from those multi-scan data sets and have the composite results for each set saved individually and /or as a spreadsheet. Only core measurements are available for these extractions. Counters Files loaded and processed are shown in the counters windows. Stop After Each File Check this option to stop the batch process after each file is loaded and processed. This allows the user to examine each 3D image as it appears in the viewing window. This is useful when trying to evaluate a new measurement or looking for anomalies in scans without having to load each scan in turn. Start/Stop Batch Click to begin the batch process. Click again to stop the process at any time. 17

22 Settings This screen is where the user can customize Size Stream Studio with their preferences and save them for future use. Switch View - Clear Raw Body Measure Avatar Screen Data Mesh Lines View Click on the icon to switch views. Use CTL+V to change views when on other tabs. The icons show the data processing flow from left to right. You can only switch views to data that has been loaded and processed further, i.e., if Raw Data is loaded and processed through to an avatar, then all views are available by clicking the icon. 18

23 Visual Settings The user can choose the color and point size of the different data views: Raw Data view change the color and point size of the 3D image. Display Grid Click to superimpose on the Studio screen. This allows the user to obtain a gross measurement of the 3D scan data on the screen. The Grid can be displayed either in inches or mm/cm. The 3D scan can be moved or rotated on the screen and the grid will remain. When using the zoom function on the image, the grid will automatically scale accordingly. Use CTL+G on the other screens to toggle the grid on and off. Refined Body Mesh view change the color and point size of the 3D image. The Body Mesh can be viewed as a Point Cloud, Solid Mesh or a Transparent Mesh. Transparent Mesh mode is best when using the Grid. Measurement view - change the color and line size of the measurement lines and Landmarks that appear on the 3D image. 19

24 Data Load Settings Clean Extra Data When Loading Raw Data In normal scanning operation, the sensors see the scanner frame and include it in the raw image. When converting the raw data from the sensors to the 3D Raw Data image shown on the screen, the Size Stream software automatically strips out this unwanted data so that only the data of the subject being scanned remains. If the scanner user turns off the extra data cleaning, it can be turned on here so the extra data is stripped away as would occur in normal scan operation. Custom Measurement File Click the button to select a custom measurement file (if any are available). The default demonstration custom measurement file that is provided with the software is shown in the illustration. Click the button to navigate to the folder where the files reside. Click the X button to clear the selection. See the section Custom Measurement List for details. Measurement Display List Click the button to select a different Measurement Order List. This list defines the Core measurement set that is displayed whenever measurements are extracted. The user can customize this list and create new ones. See the section Changing the Measurement Display List Order for details. Click the X button to clear the selection. If no list is chosen, the software will default to the entire Size Stream measurement list displayed in alphabetical order.. Measurement Guidance File Click the button to select a different Measurement Guidance file or to change the parameters in the existing file. The parameters and their use are detailed in the section Parameterized Waist Circumference. Click the X button to clear the selection. If no file is chosen, the software will default to using the Waist Circumference Tape Measure. 20

25 Measurement Units - Click on the button to convert the measurement units displayed in the Automatic and Manual Measurement tabs. Landmark XYZ coordinates do not change. View Operations Save Screenshot click to save a screenshot of the image in the viewing space. There is no other Print function available. Reset View click to return the 3D image to the starting position. Rotate View 90 Degrees click to rotate the 3D image in 90 degree increments. Show License Dialog Click to open the License information box. The Licensing box shows the number of days remaining for the active Studio software license and instructions on how to have the license activated or renewed. This box will automatically pop up if the license has not been activated or when the license is down to 14 days or less remaining as a reminder to renew. 21

26 Exact Match Avatar The Exact Match Avatar screen is where a Size Stream raw 3D data file can be converted to a rigged animation file. This file can be viewed using an online available animation viewer or formatted for additional processing to make a 3D printed model. To Create Exact Match Avatar: Select Raw Data Click and select a Size Stream raw data file. This can be a binary, XYZ, or raw data OBJ file. Note that no image appears on the screen at this point. Select Output Folder There are three available formats to save the output. Choose any or all three: FBX File Format This stores the ExactMatch avatar and contains a rigged skeleton, an organized body mesh with UV texture mapping and an animated sequence. OBJ File Format (FBX Avatar in Bind Pose) This converts the ExactMatch avatar to OBJ format. It preserves the same vertex, face and texture coordinate organization as the FBX file. It uses the FBX-defined bind pose position of the ExactMatch avatar. OBJ File Format (High Resolution Refined Body Mesh) This is the unorganized high resolution body mesh produced from the raw 3D Data. It does not contain texture coordinates and does not have a skeleton rigging associated with it. You can control the number of triangles produced in this file using the Number of Triangles control on the tab. 22

27 Select Template FBX File choose one of the supplied sample animation files from the ExactMatch Avatar Templates folder located in the Studio folder. Three sub-folders contain identical templates in three different resolutions: 1024 lowest data quality but fastest processing. Users of this resolution also need to change the Texture Image Size parameter to this level in the Studio_settings.ini file better data quality than 1024 but takes longer to process. This is the default setting and is best for the average user who is investigating possible applications highest data quality that advanced users may prefer but will take significantly longer to process, as much as 20 minutes depending on the computer. Users of this resolution also need to change the Texture Image Size parameter to this level in the Studio_settings.ini file. No Color If your scan file contains color data, the avatar will also appear in color. If the color data is not usable, for any reason, you can check this box and the color data will not be used and the avatar will appear in monochrome. If your scan file does not contain color data the avatar will only be in monochrome. Number of Triangles This setting adjusts the number of triangles created for the high resolution body model during Exact Match processing. A higher number of triangles can improve the geometric quality of the final avatar but will take longer to process. The default of 40k triangles provides adequate quality with the fastest processing. Mesh Density (mm) This setting adjusts how much smoothing is applied to the raw 3D Data during processing. The lowest setting (5) provides the highest level of smoothing while the highest setting (1) provides the least amount of smoothing. The default lowest level setting of 5 is adequate for typical Raw 3D Data. Where the Raw 3D Data has been additionally processed in an outside modelling program a more detailed result can be achieved with a higher setting. Create Now When all the settings have been chosen, Click to begin processing the raw data. The completed avatar will appear in its default pose on the screen when processing is complete. This can take several minutes. NOTE: The Size Stream Studio software does not display animation from the animated FBX file. The file must be loaded into an FBX viewer program to view the animation. The processed avatar can now be viewed in a 3D viewer, such as Autodesk FBX Review ( or can be further processed in other applications to make it suitable for making a model with a 3D printer. Additional information on the FBX file formats and usage can be found online: Manually Separate Armpits Once the avatar has been produced this tool can be used to indicate a separation line between the arm and the torso for both the left and right arm. This forces the processing to produce a separation in the mesh that can be critical for producing a good animation. To use: Hold the Ctrl key down. Place the crosshair where the armpit location will be. Press the Left mouse button and drag the crosshair down to where the arm and torso are clearly separated. Release the mouse button and Ctrl key to set the demarcation. Repeat the process for the other arm. Click the Create Now button to reprocess the avatar with these changes. Manually Reposition Skeleton Use this tool to manually adjust the position of nodes in the skeleton rigging of the avatar if they are not placed correctly during processing. To use: Hold the Ctrl key down. Place the crosshair over the desired skeleton node (represented by a black cross). The node will change to RED to indicate it is the currently selected node. Left click the mouse and drag the node to the desired location. Click the Create Now button to reprocess the avatar with these changes. 23

28 Size Stream Custom Measurement Editor If your application requires adjusting a measurement from the standard list, you can write a custom measurement with it using the Custom Measurement Scripts application found in the Size Stream\ Studio\ Executables folder. Text can also be applied to have size prediction output. The Size Stream Custom Measurement Editor allows the user to modify existing measurements to your needs. The interface allows the user to test the new scripts for errors and then verify the output prior to using the customized measurement list in the Size Stream Scanner and Studio software. Overview The Custom Measurement window has five basic sections: 1. File Commands - this section contains basic file functions. 2. Custom Measurement List - this section is where measurements are created, named, and managed. In the box above, the selected measurement shows its name and description in the corresponding boxes. The list order can be changed using the up/down arrows at the left of the list. 3. Custom Measurement Script - here is where the measurement is defined and programmed. Lines that start with a semi-colon are comment lines while instruction lines have no semi-colon. Syntax can be checked for errors and Output can be verified using the buttons above the script window. 4. Test Scan Subject - here the user can choose a specific scan to use for verifying the scripts being programmed. A Binary raw data file must be selected. 5. Reference Tokens - here are listed the available measurements and landmarks that can be utilized to make custom measurements and/or outputs. Also listed are the various functions and labels that are needed to complete the logic functions. A tutorial on how to use the custom measurement tool follows here. Specific questions and assistance requests should be directed to support@sizestream.com. A diagram and description of each measurement requested should be included with the request. 24

29 Custom Measurement Editor Tutorial 1. Create Constants and/or Values. 2. Define mathematical operations. 3. Evaluate and compare conditions When composing custom measurement scripts, there are some rules that must be followed: There must be a space between every word and every function. Correct: Create Value collar + 2 inch line Incorrect: Create Valuecollar inch line Variable names must be in one-word form. Correct: Create Value Shirtcollar + 2 inch line Correct: Create Value Shirt_collar + 2 inch line Incorrect: Create Value Shirt collar inch line Script Syntax must be followed. These are the formats of the different kind of script lines: Create Value VariableName = Math Expression Create Constant VariableName = Math Expression UNIT UNITTYPE Else Else If Comparison Expression If Comparison Expression Then Set Output Then Set Value Set Output TextOutput Set Output VariableName Set Output MeasurementName Set Output LandmarkName.X or LandmarkName.Y or LandmarkName.Z Set Value VariableName = Math Expression ; Comment Create Value VariableName = Math Expression Create Value allows you to create a variable that contains a numeric value that can be calculated and changed in the script. Give your value variable a descriptive name, then assign a valid math expression to it. Math expressions may include measurements, landmarks, defined constants and defined values. Values are automatically adjusted to be in the user s selected unit of measurements. Examples: Define a value based on an operation between two landmarks CREATE VALUE LEFTNECK2BUST Define a value based on a measurement CREATE VALUE OUTSEAM Define a value based on a combination of expressions CREATE VALUE AVGSHOULDERLENGTH = ) / TWO Define a value based on landmark references CREATE VALUE YDIFF = ) * ) 25

30 Create Constant VariableName = Numeric Value UNIT UNITTYPE Create Constant allows you to define a constant value and have it correctly applied in math expression even when the user changes the units of measurement. Give your Constant variable a descriptive name, then assign a numeric value to the variable. Define the Constant s measurement unit, then define the Constant s type of unit. Note that the applied value of the Constant will change depending on the user s units settings. NONE a unit-less constant never changes value LINE a line constant will be directly converted between INCH, CM and MM AREA an area constant will be converted between INCH^2, CM^2 and MM^2 VOLUME a volume constant will be converted between INCH^3, CM^3 and MM^3 Examples: Define the constant unit-less value 2 for use in calculating an average between two variables. CREATE CONSTANT TWO = 2 INCH NONE Define the constant value 1 inch for use in comparing the difference between two circumference measurements. CREATE CONSTANT ONEINCH = 1 INCH LINE Define the constant value 100 mm for use in comparing the difference between two surface areas. CREATE CONSTANT ONEHUNDREDMM = 100 MM AREA Define the constant value 1000 cm for use in comparing the difference between two volumes CREATE CONSTANT ONETHOUSANDCM = 1000 CM VOLUME If Else if Else Then Set Output Then Set Value If allows you to evaluate a comparison expression and choose to execute an operation based on the result of that comparison. After If give a valid comparison statement that consists of comparison operations using measurements, landmarks, defined constants and values. Math expressions cannot be used in a comparison statement. Math expressions should be stored in a value variable and then used in a comparison statement. If statements must be immediately followed by a Then statement. Else if works the same as an If statement, but is expected to follow a pair of If/Then statements. This allows for chained comparisons that culminate with an Else statement that is a catch-all if no other If or Else if statement evaluates to true. Else If statements and Else statements must be immediately followed by a Then statement. Then statements should only be used to set a new value in an already defined Value variable or to set the output to the script. Examples: A single simple comparison: ( If with no Else ) If MaxShoulderLength Then Set Value MaxShoulderLength A single complicated comparison ( If with no Else ) If ( MaxShoulderLength ) AND ( MaxShoulderLength ) Then Set Value MaxShoulderLength 26

31 More than one comparison: ( If with Else ) If MaxShoulderLength Then Set Value MaxShoulderLength Else Then Set value MaxShoulderLength A set of comparisons: ( If with Else if and Else ) If MaxShoulderLength Then Set Value MaxShoulderLength Else if MaxShoulderLength AND MaxShoulderLength Then Set Value MaxShoulderLength Else Then Set Output Error Set Value Set Value allows you to change the value of an already defined Value variable. This is useful when a value variable may need to change value based on the results of a comparison statement. The same kind of math expressions that are valid when doing a Create Value statement are also valid for Set Value. Example: CREATE VALUE maxshoulderlength IF maxshoulderlength THEN SET VALUE maxshoulderlength RIGHT Set Output TextOutput Set Output VariableName Set Output MeasurementName Set Output LandmarkName.X or LandmarkName.Y or LandmarkName.Z Set Output is used to declare what the result of the script measurement is. If the Set Output statement has a result enclosed by quotes then what is between the quotes will be displayed as text value, e.g. Small, X-Large. Otherwise the result will be a numeric value and can be a defined constant or value variable name, a measurement name, or a landmark reference. Note that a Landmark reference must include the X, Y or Z direction value of the landmark. ; Comment Comment lines are any lines that begin with a semicolon. They are useful to explain intended functionality of a script or as programmer notes in the script. Comment lines are not a functional part of the script and are present and visible only to the person writing the script. 27

32 Choosing a Waist Measurement There are several measurements that are connected to, or may reference, the Waist. Two of those commonly used include the Crotch Length and Outside Leg Length. In addition, there are adjustable landmarks in the Waist that allow the user to manually adjust the Waist to suit their application. While there are a variety of different Waist measurements included in the Size Stream Standard Measurement list, there are only three of those to which these other measurements and the movable landmarks can be connected: Waist Circumference Tape Measure- a fixed circumference starting at the Small of the Back and descends 10 degrees at the front point. This is the default setting. OPT Small of Back Waist Tape Measure a parameterized circumference starting at the Small of the Back point. See the section Parameterized (Optimized) Waist Circumference in this manual for details on how to use this measurement. OPT Formula Waist Tape Measure - a parameterized circumference that uses a formula to determine the starting back point. See the section Parameterized (Optimized) Waist Circumference in this manual for details on how to use this measurement. The default is the Waist Circumference Tape Measure. The OPT Waists are turned off by default and will show the value Unavailable in the measurement output list. To switch to either of the other OPT Waist measurements in Studio: 1. Go to the Settings tab. 2. Click the button Measurement Guidance File 3. Navigate to the Studio Executables folder and select the MeasurementGuidance.mg file. The default order in the Measurement Guidance file is the Small of the Back method which is listed above the Formula method and signified by a 1.0 in the Method of Execution line. This is the Waist that will now be connected to the other measurements and movable landmarks. To have the Formula method as the preferred Waist, switch the Method of Execution numbers between the two Waist methods so 2.0 is the top method and 1.0 is the bottom method. See the section Parameterized (Optimized) Waist Circumference in this manual for details on how to use this adjustable measurement. To switch back to the default Waist Circumference Tape Measure: 1. Go to the Settings tab. 2. Click the X box opposite the Measurement Guidance File button. This will clear the selection and restore the default. 28

33 Parameterized (Optimized) Waist Circumference The Parameterized Waist function allows the user to set the limits for where the Size Stream software will extract the Optimized Waist measurement from the 3D scan image. The software uses two different methods to determine the starting point for this measurement. The first method uses the Small of the Back while the second method uses a formula based on the relationship of the Crotch Height and Hip Circumference. With reference to that starting point, the user defines the upper and lower limits for the front, back and side points for the software to find the optimized circumference. The results of both methods are displayed in the measurement output list as: Opt Small of Back Waist Tape Measure and Opt Formula Waist Tape Measure The user can then determine which method works best for their particular application. The Parameterized Waist can be used in both the Scanner software and in the Studio software but must be configured separately in each application. Measurement limits are set and adjusted by the user in OptimizedMeasurements.mg file. In the Scanner software, this file is located in the Executables folder: C:\ Size Stream \ Scanner \ Executables \ OptimizedMeasurements.mg Note: the Studio software must be restarted for any changes to take effect. In the Studio software: c:\ Size Stream \ Studio \ OptimizedMeasurements.mg All values are set in millimeters regardless of the measurement output units chosen. Method of Operation The Parameterized Waist operates by determining the location of a horizontal slice that it marks and then uses as the starting point. The user then can adjust the upper and lower limits of the Front, Back and Side points of the slice to define a range that the software can move the slice to determine the smallest circumference. It then outputs this smallest circumference as the final measurement. There are two methods the software uses to determine the starting slice: 1) Using the Small of the Back. The software determines where this is on the scan subject and marks the horizontal slice at that point. 2) Using a Formulaic Method. The software has a formula based on the relationship of the Crotch Height and Hip Circumference with user-defined parameters to find the Small of the Back starting slice. The software will automatically use both of these methods and will output the results for both. They will be listed in the standard measurement list as: OPT Small of Back Waist Tape Measure OPT Formula Waist Tape Measure These measurements will also be shown as circumferences on the 3D Body Mesh. The file is shown on the following pages: 29

34 Parameterized Waist File: OptimizedMeasurement.mg <?xml version="1.0"?> <!-- ALL VALUES ARE IN MILLIMETERS --> <Measurements> [Small Back] Parameterized Waist Circumference m_paramwaist_smallback_circumference The circumference of the minimal waist defined in the given bounds using the small of the back as a reference point. <MethodOfExecution> 1.0 </MethodOfExecution> <FrontUpperLimit> 13.0 </FrontUpperLimit> <FrontLowerLimit> </FrontLowerLimit> <BackUpperLimit> 0.0 </BackUpperLimit> <BackLowerLimit> </BackLowerLimit> <BackFormulaUpperLimit> 63.5 </BackFormulaUpperLimit> <BackFormulaLowerLimit> </BackFormulaLowerLimit> <SideUpperLimit> 13.0 </SideUpperLimit> <SideLowerLimit> </SideLowerLimit> <SideOffset> 25.4 </SideOffset> <FormulaThresholdXOver> 25.0 </FormulaThresholdXOver> <CrotchOffset> </CrotchOffset> <HipCoefficient> 0.02 </HipCoefficient> <HipSquareCoefficient> 0.0 </HipSquareCoefficient> [Formula] Parameterized Waist Circumference m_paramwaist_formula_circumference The circumference of the minimal waist defined in the given bounds using the formulaic method to compute the starting waist height. <MethodOfExecution> 2.0 </MethodOfExecution> <FrontUpperLimit> 0.0 </FrontUpperLimit> <FrontLowerLimit> </FrontLowerLimit> <BackUpperLimit> 13.0 </BackUpperLimit> <BackLowerLimit> </BackLowerLimit> <BackFormulaUpperLimit> 13.0 </BackFormulaUpperLimit> <BackFormulaLowerLimit> </BackFormulaLowerLimit> <SideUpperLimit> 38.1 </SideUpperLimit> <SideLowerLimit> </SideLowerLimit> <SideOffset> 25.4 </SideOffset> <FormulaThresholdXOver> 25.0 </FormulaThresholdXOver> <CrotchOffset> </CrotchOffset> <HipCoefficient> 0.02 </HipCoefficient> <HipSquareCoefficient> 0.0 </HipSquareCoefficient> 30

35 Adjusting the Parameters The OptimizedMeasurements.mg file has two identical lists of parameters. This enables the user to set different limits for the two methods used. Each parameter line is explained below: Method of Operation: This line defines which method being used. The default file has a 1.0 in the top set to use the Small of Back method while the lower set has a 2.0 to use the Formula method. These can be changed if, for example, the user wants to set two Small of Back methods using different limits. Front Upper Limit: This line defines the upper limit in millimeters (mm) that the Front Point can move when using either the Small of the Back or the Formula method. Front Lower Limit: This line defines the lower limit in mm that the Front Point can move when using either the Small of the Back or the Formula method. Back Upper Limit: This line defines the upper limit in mm that the Back Point can move when using the Small of Back method. It is not used in the Formula method. Back Lower Limit: This line defines the lower limit in mm that the Back Point can move when using the Small of Back method. It is not used in the Formula method. Back Formula Upper Limit: This line defines the upper limit in mm that the Back Point can move when using the Formula method. It is not used in the Small of Back method. Back Formula Lower Limit: This line defines the lower limit in mm that the Back Point can move when using the Formula method. It is not used in the Small of Back method. Side Upper Limit: This line defines the upper limit in mm that the Left and Right Side Points can move when using either the Small of Back or the Formula method. Side Lower Limit: This line defines the lower limit in mm that the Left and Right Side Points can move when using either the Small of Back or the Formula method. Side Offset: This line defines the total limit in mm that the Left and Right Side Points can move with respect to each other when using either the Small of Back or the Formula method. Formula Threshold Xover: This line defines the percentage of the Hip Circumference that the Small of Back must be above the Crotch Point before the Formula method will be used instead of the Small of the Back method. Crotch Offset: This line sets the offset value in mm that can be added to the Crotch Point to be used in the starting height computation. Hip Coefficient: This line sets the coefficient multiplier used to multiply the Hip Circumference used in the starting height computation. This can be any real number. Hip Square Coefficient: This line sets the coefficient multiplier used to multiply the Hip Circumference Squared used in the starting height computation. This can be any real number. 31

36 Changing the Measurement List Order The order that the standard measurement output list appears can be changed by the user. This can eliminate searching for those measurements that are most used by placing them at the top of the order and can delete those measurements that the user does not use. The Measurement Selector tool is used to reorder the standard measurement list and is located in the Size Stream Studio folder: c:\ Size Stream \ Studio \ MeasurementSelector.exe To rearrange the Size Stream Standard Measurement List: Click on each desired measurement from the Available Measurements list on the left. Click the Add button to move it to the new Measurement List on the right. Click on a measurement and use the Move Up and Move Down buttons to arrange the order of the selected measurements. Click the Remove button to delete a selected measurement from the Measurement List and return it to the Available Measurements list. The new list can be saved as MeasurementDisplayOrderList.txt or can be given a different name if different lists are planned. 32

37 Size Stream Standard Measurement Definitions Listed here in alphbetical order are the measurements that are available to be automatically generated when a scan file is loaded in the Studio software. This is identical to the list of measurements generated in the Size Stream Scanner software version. Circumference measurements follow the contours of the body except where designated as a tape measurement in the output list. Length and Height measurements are straight line distances. Heights are measured from the floor. Abdomen Circumference Horizontal circumference at the most forward point between the Front Waist Point and the Front Seat Point. Abdomen Height is measured from the floor. Abdomen Rise Vertical distance from crotch level to Abdomen level. Across Back Horizontal distance across the back between the back armpit points. Across Chest Horizontal distance across the chest between the front armpit points. (Actual) Ankle Circumference Circumferences of the left and right ankle bones. Ankle Circumference Circumference taken at the averaged height of both ankle bones Arm Hole Circumference Girth under the Armpit and over the Shoulder (Armscye) is available as both vertical and tilted to the Shoulder Point as ArmHole Outer Circumference. Armhole Circumference Armhole Outer Circumference 33

38 Arm Length Straight distance from the shoulder point to the wrist. Arm Under Length - Straight distance from the armpit point to the wrist. Axilla Chest Measurements Circumference taken at Armpit level. Horizontal Full Circumference, Front Length and Back Length are available. Front half view Side view Back view Side view Back Neck to Back Chest Distance from Back Neck point to back Chest level. Also taken as a vertical distance. Contour measure Vertical measure Back Neck to Shoulder Blade Distance from the Back Neck point to Shoulder Blade level. 34

39 Back Shoulder Width Distance between the shoulder points. Can be taken on the horizontal, at 45 degrees, or through the Back Neck point. Horizontal at 45 degrees through Back Neck point Back Vertical Rise Vertical distance from Crotch level to the Back Waist point level. Bicep Circumference Largest girth of the upper arm. Body Fat Estimations Shown in the sample custom measurement list, the formulas used are from the US Department of Defense and are found on page 13 of this document: Bust Girth with Drop Smallest Circumference fixed at the front bust level and allowing the back height to drop 3 cm. Bust-to-Bust Length Distance between the bust points. Bust Prominence Horizontal distance from the sternum across the bust to the side point. Calf Circumference - Maximum leg girth above the ankle and below the knee. Center Trunk Length Distance from the Front Neck point down through the Crotch and back up to the Back Neck point. 35

40 Cervicale to Bust Length Length from Back Neck point down to Bust points L&R. Chest / Bust Circumference Horizontal circumference measured across the bust points, under the arm pits and around the back. Chin Height Height of the point of the chin. Collar Circumference Neck column circumference taken approximately at the larynx. Crotch Height Vertical distance from the floor to the Crotch point. Crotch Length Full Distance from the Front Waist level through the Crotch to the Back Waist level. Elbows Girth at the Elbow joint and Elbow Height from the floor; Left and Right. Elbow Height Waist Horizontal circumference taken at elbow height. Foot Length Length from the back of the heel to the farthest toe tip. Forearm Circumference Largest girth of the lower arm. Front Hip - Distance across the front of the Hips from side point to side point. 36

41 Front Jacket Length Distance from Right Side Neck point over Stomach Front Point then vertically to Crotch point level. Front Shoulder Width - Distance between the shoulder points across the front. Front Vertical Rise Vertical distance from Crotch level to the Front Waist point level. Front Waist Distance across the front of the Waist from side point to side point. Half Back Center Distance from Back Neck point to center Back Waist point. Halter Distance from Left UnderBust point around the neck to Right UnderBust point. Head Circumference Circumference above the eyes. High Hip Horizontal circumference at half the distance from the Crotch to the Left Point of the OPT Small of Back Waist. Requires OPT Waist enabled. High Hip to SOB OPT Waist Vertical distance from High Hip to the Left Point of the OPT Small of Back Waist. Requires OPT Waist enabled. 37

42 Hinged Bust Circumference Front and Back portions move independently. Hip Circumference Maximum girth between the Back Waist Point and Crotch levels. Hips 2 inches Above the Crotch Horizontal girth taken 2 inches above Crotch point level. Hips 8 inches Down from SOB OPT Waist Horizontal circumference taken 8 inches below the Back Point of the OPT Small of Back Waist Requires OPT Waist enabled. Horizontal Waist - Horizontal circumference between small of back level and 4cm above it. Horizontal Waist Height Vertical distance from the floor to the Horizontal Waist Circumference. Inseam Length from the crotch point down the leg to the floor; Left or Right Actual Knee Circumference Circumferences taken over the left and right knee caps. Knee Circumference Circumference at the averaged height of both knee caps. Lower Leg Min Circumference Minimum leg girth above the ankle and below the knee. Height of measurements also available. Low Hip Maximum horizontal circumference between the Crotch and the Left Point of the OPT Small of Back Waist. Requires OPT Waist enabled. Low Hip to SOB OPT Waist Vertical distance from Low Hip to the Left Point of the OPT Small of Back Waist. Requires OPT Waist enabled. Low Rise Waist Discontinued. Shows as a 0. Mid-Shoulder to Bust Length Length measurement. Mid-Shoulder to Waist Length Length measurement. Requires OPT Waist enabled. Mid-Shoulder Height Height from floor of mid-shoulder points. Mid-Thigh Circumference taken at mid-point between the Knee and Thigh Circumference. Narrow Waist Horizontal circumference taken at the narrowest torso point between the chest and hips when viewed from the front. 38

43 Neck Circumference Circumference of the base of the neck where it meets the shoulders. OPT Waist See the section Parameterized (Optimized) Waist Circumference for details on configuring a custom waist measurement. Outside Leg Length Distance from the side waist level over the hip then vertical to the floor. OverArm Circumference Horizontal girth taken over the arms at the widest point of the biceps. Pants Waist - Smallest circumference starting between the small of back level and 4cm above it and allowed to drop in the front up to 3 cm to follow the actual pant waist contour. Seat Circumference Horizontal circumference at the most prominent rear point between the waist and crotch. Seat Fold Height Vertical distance from the floor to where the buttocks meet the leg. Side Back Waist to Floor Vertical distance; Left or Right. Side Neck to Bust Length L&R Distance from the side neck points to the bust points. Side Neck Trunk Length - Distance from the Right Side Neck point down through the Crotch and back up to the Right Side Neck point. 39

44 Shoulder Arc Distance from Front Bust level through the Side Neck point to Back Bust level. Shoulder Length Distance from the side neck point to the shoulder point. Shoulder Slope Drop angle of the shoulder point from the neck base point in degrees. Shoulder Circumference Horizontal girth at approx. 65% of the vertical distance from the Bust points to Shoulder points. Sleeve Length Distance from back neck point over the shoulder point to the wrist. Stomach Front Point Circumference Horizontal circumference taken at most prominent front point below the bust and above the waist. Stomach Max Circumference Horizontal circumference taken at maximum girth below the bust and above the waist. Subject Height Height from floor to top of subject (hair is seen as a surface and is included). Surface Area Surface area of separate body parts plus L&R Bust in square units plus Surface Area Total are available. 40

45 Thigh Circumference Leg girth measured 2 inches below the Crotch. Thigh Height of the circumference is available. Underbust Circumference Horizontal circumference taken below the bust. Under Knee Circumference Circumference at bottom of the knee cap. Under Knee Height Height from the floor to the Under Knee Circumference. Upper Bust Front Length Distance between armpits across top of Bust. Vertical Trunk Circumference Distance from Mid-Shoulder point through the Crotch to Back Neck point. Volume Volume of separate body parts plus L&R Bust in cubic units plus total Volume are available. Waist Circumference Circumference taken at a 10 degree angle starting at the back point that is 80% of the distance from the Crotch level to the Small of Back point. Waist at 50% - Horizontal circumference taken at half the distance from the Crotch to the Bust/Chest. Waist Height Height from the floor to the Waist Circumference Right Side Point. Wrist Circumference Circumference at the wrist joint below the bone. This measurement is dependent on the subject gripping the handholds during scanning. 41