CAVS / Capabilities / Software and Codes / CFD Software Forum / CFD Software Documentation / SolidMesh / Basics / Command Line Options

Command Line Options

Type in sm at the command line with any of the following options:

Usage: sm

  1. -h/-help (Display sm usage)
  2. -version (Display sm version information)
  3. -build (Display sm build information)
  4. -case/-c CaseName (Geometry file name)
  5. -gui # (Specify alternate GUI)
  6. -oc FileName.BRep (OpenCASCADE Boundary Representation file name - requires CAPRI license and installation of OpenCASCADE)
  7. -catia FileName.CAT[PART|PRODUCT] (CatiaV5 part or product file name - requires CAPRI and CatiaV5 licenses)
  8. -ugs FileName.prt (UniGraphics part file name - requires CAPRI and UniGraphics licenses)
  9. -proe FileName.[prt|asm] (Pro/Engineer part or assembly file name - requires CAPRI and Pro/Engineering licenses)
  10. -sw FileName.sld[prt|asm] (SolidWorks part or assembly file name - requires CAPRI and SolidWorks licenses)
  11. -capriangle Angle (Maximum angle, in degrees, between triangle neighbors)
  12. -caprimaxlen Length (Fraction of min-max box diagonal of model volume to set the maximum triangle side length)
  13. -caprideviate Deviation (Fraction of min-max box diagonal of model volume to set the Maximum deviation between the parametric center of the triangle and the surface)
  14. -grid GridName (Grid file name)
  15. -extractsurf (Extract and read only the surface grid from the volume grid)
  16. -retainvolids (Retain the volume id flags from the volume grid)
  17. -tags (Specify the boundary conditions via the tags file)
  18. -melem (Maximum number of triangles per surface for surface grid generation, default = 200,000)
  19. -dir/-d DirectoryPath (Directory path)
  20. -mouse/-m <trz> (Mouse-button function assignments)
  21. -3D/-3d (default) (3D grid generation mode)
  22. -2D/-2d (2D grid generation mode)
  23. -glue/-g (default) (Glue geometry on input)
  24. -noglue/-ng (Do not glue geometry on input)
  25. -trim/-t (default) (Trim geometry on input)
  26. -notrim/-nt (Do not trim geometry on input)
  27. -discretegeometry/-dg (Treat triangulation as discrete geometry)
  28. -dgrestart (Restart from a previous topology definition, casename.dgt)
  29. -dgedgeangle (Discrete edge angle threshhold for discrete geometry feature identification)
  30. -nofeatureid (Do NOT use the feature identifcation capability to extract topology boundaries based on geometric features)
  31. -dihedralangle/-da (Dihedral angle threshhold for discrete geometry feature identification)
  32. -openangle/-oa (Open angle threshhold for discrete geometry feature identification)
  33. -stltol Tolerance (Tolerance for processing STL files)
  34. -tolerance/-tol Tolerance (Specify tolerance for input)
  35. -c1 (Use 1st order cubic interpolation when reading XYZ and Plot3D files)
  36. -c2 (Use 2nd order cubic interpolation when reading XYZ and Plot3D files)
  37. -xyzp (Do not interpolate a curve through the points when reading XYZ files)
  38. -savestate/-ss (default) (Load save state on input)
  39. -nosavestate/-nss (Do not load save state on input)
  40. -nopoints/-np (Do not load points)
  41. -nocurves/-nc (Do not load curves)
  42. -nosurfaces/-ns (Do not load surfaces)
  43. -backgroundcolor/-bgc <Red Green Blue> (Sets background color)
  44. -wireframegridcolor/-wfgc <Red Green Blue> (Sets grid color)
  45. -facecolor/-fc< Red Green Blue> (Sets the face color)
  46. -derivededgecolor/-dec< Red Green Blue> (Sets the color of derived edges)
  47. -parametricedgecolor/-pec< Red Green Blue> (Sets the color of parametric curves)
  48. -physicaledgecolor/-phec <Red Green Blue> (Sets the color of physical curves)
  49. -derivedvertexcolor/-dvc <Red Green Blue> (Sets the color of derived vertices)
  50. -physicalvertexcolor/-pvc <Red Green Blue> (Sets the color of physical vertices)
  51. -vectorcolor/-vc <Red Green Blue> (Sets the color of vectors)
  52. -diag (Lists diagnostic information)
  • -h/-help displays the command line options and usage as above.  The url for the SolidMesh website is also listed.
  • -version displays the version information of SolidMesh, including the version of libraries linked in with SolidMesh executable.
  • -build displays the build information for the SolidMesh executable.
  • -case/-c CaseName allows the user to specify a geometry file to read in. If an entire file name is specified, that file name will be used. If only a case name (no file extensions) is specified, the following order of file extensions will be used to try to find the file name:
    1. .SM.gz (Save State gzipped)
    2. .SM.Z (Save State compressed)
    3. .SM (Save State)
    4. .igs.gz (IGES gzipped)
    5. .igs.Z (IGES compressed)
    6. .igs (IGES ascii)
    7. .iges.gz (IGES gzipped)
    8. .iges.Z (IGES compressed)
    9. .iges (IGES ascii)
    10. .step.gz (STEP gzipped - requires CAPRI license and installation of OpenCASCADE)
    11. .step.Z (STEP compressed - requires CAPRI license and installation of OpenCASCADE)
    12. .step (STEP - requires CAPRI license and installation of OpenCASCADE)
    13. .p3d (Plot3D ascii)
    14. .unf (Plot3D unformatted, linear interpolation)
    15. .fmt (Plot3D formatted, linear interpolation)
    16. .xyz (XYZ curves)
  • -gui # (where # is an integer) allows the user to specify an alternate GUI layout.  Two files located in the interface/sm directory, global_api_#.ad and gui_api_#.scheme, are needed to define the GUI.  A second gui definition, -gui 2, is available and is sized 1430 x 835 pixels.
  • -oc FileName.BRep read in the specified OpenCASCADE solid model file.
  • -catia FileName.CAT[PART|PRODUCT] read in the specified CatiaV5 solid model part or product file.
  • -ugs FileName.prt read in the specified UniGraphics solid model part file.
  • -proe FileName.[prt|asm] read in the specified Pro/Engineer solid model part or assembly file.
  • -sw FileName.sld[prt|asm] read in the specified SolidWorks solid model part or assembly file.
  • -grid GridName allows you to specify a grid file to read in. If you specify the entire file name, that file name will be used. If you only specify the case name (no file extensions), the following order of file extensions will be used to try to find the file name:
    1. .r4.fgrid (FAST unformatted, real*4 representation)
    2. .r8.fgrid (FAST unformatted, real*8 representation)
    3. .b4.fgrid (FAST binary, float representation)
    4. .b8.fgrid (FAST binary, double representation)
    5. .fgrid (FAST ascii)
  • -dir/-d allows you to override the current directory and specify any specific directory as the input directory.
  • -mouse/-m<trz> allows you to map the buttons of the mouse for translation, rotation and zooming. For example if you wanted to emulate FAST mouse controls you would enter: sm -mouse rzt (left button rotate, middle zoom and right translate) The default is: sm -mouse trz (left button translate, middle rotate and right zoom)
  • -2D and -3D allow you to use the 2D or 3D grid generator. The default is 3D. This affects topology, CAD, and the grid generation options that are available.
  • -glue/-g and -noglue/-ng allows you to control gluing on input. The default is to glue geometry on input. Turning off the gluing is recommended when building or modifying geometry through the CAD system. This option is ignored for save-state files.
  • -trim/-t and -notrim/-nt allows you to control trimming on input. The default is to trim geometry on input. Turning off the trimming is recommended when building or modifying geometry through the CAD system.
  • -forcetrim/-ft allows you to force trimming of parametric surfaces.
  • -tolerance/-tol Tolerance allows you to choose a desired tolerance which will override the specified tolerance in the file you are reading. The new tolerance you desire must be typed along with this command.
  • -c1 allows you to use 1st order cubic interpolation when reading XYZ and Plot3D files
  • -c2 allows you to use 2nd order cubic interpolation when reading XYZ and Plot3D files
  • -savestate/-ss and -nosavestate/-nss allows you to control the save state properties in the file which you are about to read. The save state properties are in each IGES file written out by SolidMesh; they are composed of grid information for that model. If you choose to keep the save state properties, the grid information will be read.
  • -nopoints/-np,-nocurves/-nc, and -nosurfaces/-ns allows you to control whether or not points, curves, or surfaces are loaded.
  • -backgroundcolor/-bgc <Red Green Blue> allows you to set the background color in the view area.  This is particularly helpful for making pictures.
  • Several command line options are provided solely for the purpose of changing the display color of the various objects in SolidMesh.  The following options change the color of their respective objects by specifying a Red, Green, and Blue value (from 0 to 1) after the option.