SolidMesh Grid Tools: scalegrid

The scalegrid utility provides a tool to apply various transformations to a given grid.  The supported transformations include scaling, translation, rotation, a quarternion based general transformation, or any combinations of these.  The input grid can also be reflected about the primary coordinate planes.  The order of application of the transformations is:

  1. Translation
  2. Scaling
  3. Rotation
  4. Reflection
  5. Quarternion based general transformation
  • -igrid [file_name]
    		• Specifies the input grid file name
  • -ogrid [file_name]
    		• Specifies the output grid file name
  • -dx [#]
    		• Specifies the amount to translate the X coordinates.  Default = 0.0
  • -dy [#]
    		• Specifies the amount to translate the Y coordinates.  Default = 0.0
  • -dz [#]
    		• Specifies the amount to translate the Z coordinates.  Default = 0.0
  • -scalefac [#]
    		• Specifies the factor to by which to divide all coordinates.  Default = 1.0
  • -scalex [#]
    		• Specifies the factor to by which to divide the X coordinates.  Default = 1.0
  • -scaley [#]
    		• Specifies the factor to by which to divide the Y coordinates.  Default = 1.0
  • -scalez [#]
    		• Specifies the factor to by which to divide the Z coordinates.  Default = 1.0
  • -rpx [#]
    		• Specifies the X coordinate of the point to rotate about.  Default = 0.0
  • -rpy [#]
    		• Specifies the Y coordinate of the point to rotate about.  Default = 0.0
  • -rpz [#]
    		• Specifies the Z coordinate of the point to rotate about.  Default = 0.0
  • -rnx [#]
    		• Specifies the X component of the axis of rotation.  Default = 0.0
  • -rny [#]
    		• Specifies the Y component of the axis of rotation.  Default = 0.0
  • -rnz [#]
    		• Specifies the Z component of the axis of rotation.  Default = 1.0
  • -rdegrees [#]
    		• Specifies (in degrees) the rotation amount.
  • -symmetric_x
    		• Mirror the input grid about the x = 0 plane.
  • -symmetric_y
    		• Mirror the input grid about the y = 0 plane.
  • -symmetric_z
    		• Mirror the input grid about the z = 0 plane.
  • -transform [file_name]
    		• Applies the quarternion based transformation specifed in the transformation file file_name to the input grid.  The is will take the input grid and place it in the orientation and spatial location dictated by the quarternions.  The format for the transformation file is: 
    xcg_init ycg_init zcg_init
xcg      ycg      zcg
q1       q2       q3       q4
    where (xcg_init, ycg_init, zcg_init) is the initial location of the center of gravity, (xcg, ycg, zcg) is the current location of the center of gravity and (q1,q2,q3,q4) is the quarternion vector.  The transformation file must be an ASCII file.
  • -revtrans
    		• Applies the reverse of the transformation specified by the -transform option.  The -transform option must be specified to use this option. 
  • -flow
    		• Apply the same mirror/rotation/transformation to the solution vectors.
  • -writevtags
    		• Write the volume tags to the output grid file.
  • -dumpvtags
    		• Print the volume tags to the screen.
  • -help
    		• Prints the help screen.
  • -version
    		• Prints the version information of the executable and the associated libraries
  • -build
    		• Prints the build number of the executable

    Options listed in red are mandatory.
     

    SolidMesh Contents SolidMesh Home gridmerge SolidMesh Grid Tools sgc