Shift or Scale a Surface

Use the Shift or Scale a Surface option (geogxnet.dll(Geosoft.GX.Mesh.Transformation.TransformMesh;Run)*) to transform an existing surface to create a new version with a different size or position. The entire surface is shifted or scaled by the same amount, resulting in no internal deformation. The new surface may be written to a new, existing, or to the same (input) geosurface file.

You can access the option from the following locations:

  • The Geosurface > Utilities menu

  • The 3D ViewGeosurface > Utilities menu

  • The 3D Viewer Geosurface > Utilities menu

Shift or Scale a Surface dialog options

Input geosurface

Select the geosurface file containing the surface to be transformed. It is recommended that the geosurface file has a valid coordinate system defined.

Script Parameter: TRANSFORMSURFACE.INPUTSURFACEFILE

Surface to modify

Select the name of the surface to be transformed from the list of surfaces in the geosurface file.

Script Parameter: TRANSFORMSURFACE.INPUTMESHNAME

Output gesourface

Specify the output geosurface file to which the transformed surface will be written. This can be the same file as the input geosurface file, another existing geosurface file, or a new geosurface file.

Script Parameter:TRANSFORMSURFACE.OUTPUTSURFACEFILE

Output surface name

Specify the name of the output transformed surface to be created. If a surface with the same name already exists in the output geosurface file, you will be prompted to specify a name that is unique within the geosurface file.

Script Parameter: TRANSFORMSURFACE.OUTPUTMESHNAME

Operation

Choose between the shift and scale operation.

Script Parameter: TRANSFORMSURFACE.TRANSFORMATIONTYPE [0: scale (default), 1: shift]

Shift

At least one shift value must be nonzero.

X shift

Specify the amount to shift every surface node along the X-axis.

Script Parameter: TRANSFORMSURFACE.DELTAX

Y shift

Specify the amount to shift every surface node along the Y-axis.

Script Parameter: TRANSFORMSURFACE.DELTAY

Z shift

Specify the amount to shift every surface node along the Z-axis.

Script Parameter: TRANSFORMSURFACE.DELTAZ

Scale

The scale values must be positive and at least one scale factor must not be ==1.

X scale factor

Specify the amount to scale (multiply) the X-coordinate of every node in the surface. This must be a positive value.

Script Parameter: TRANSFORMSURFACE.DELTAX

Y scale factor

Specify the amount to scale (multiply) the Y-coordinate of every node in the surface. This must be a positive value.

Script Parameter: TRANSFORMSURFACE.DELTAY

Z scale factor

Specify the amount to scale (multiply) the Z-coordinate of every node in the surface. This must be a positive value.

Script Parameter: TRANSFORMSURFACE.DELTAZ

Application Notes

The scaling operation is simple multiplication; coordinates are scaled relative to the origin of the coordinate system, rather than some local origin.

*The GX tool will search in the "...\Geosoft\Desktop Applications \gx" folder. The GX.Net tools, however, are embedded in the geogxnet.dll located in the "...\Geosoft\Desktop Applications \bin" folder. If running this GX interactively, bypassing the menu, first change the folder to point to the "bin" folder, then supply the GX.Net tool in the specified format.