Meshes
In Leapfrog Geo, meshes are used to represent surfaces in the form of vertices and triangles that define the 3D shape of the surface. Meshes can be open or closed. Meshes are generated as part of the model-building process, but can also be imported into a project or created directly in the project. Leapfrog Geo has several tools for adjusting meshes.
The Meshes folder contains all meshes imported into Leapfrog Geo and created in Leapfrog Geo outside of the model building process.
Two types of meshes are stored in the Meshes folder:
- Non-editable meshes () are meshes imported into Leapfrog Geo and meshes created in Leapfrog Geo from the moving plane, Meshes > Mesh Operations tools and by extracting mesh parts from other surfaces in the project.
- Editable meshes () are created in Leapfrog Geo from data objects such as points data, GIS data and polylines. Editable meshes can be refined by adding more data. Editable meshes can be interpolated meshes (using FastRBF) or triangulated meshes (using Delaunay triangulation). Interpolated meshes can also be created from structural data and values objects.
The rest of this topic is divided into:
- Cleaning Up a Mesh
- Importing a Mesh
- Reloading a Mesh
- Displaying Surfaces
- Importing Meshes from Central
- Exporting Meshes
Cleaning Up a Mesh
There are several options for cleaning up a mesh that can be applied to meshes imported into Leapfrog Geo and to non-editable meshes created in Leapfrog Geo.
To clean up a mesh, double-click on the mesh in the Meshes folder or right-click on the mesh and select Open. The Cleanup Mesh window will be displayed:
The Cleanup Mesh window will also be displayed when you import meshes.
The first option, Combine identical vertices, is intended for snapping cases where vertices occupy the exact same point in space. When enabled, vertices that have the exact same coordinates will be merged.
When enabled, Combine identical vertices occurs before the other processing actions in the Cleanup Mesh window.
The next option, Remove self-intersections for volumes, retriangulates self-intersecting triangles and trims away remaining open surfaces, whether they lie inside or outside the mesh. Before applying the Remove self-intersections for volumes option, check whether the mesh is open or closed. To do this, right-click on it in the project tree and select Properties. Closed should be True:
A mesh may appear to be closed in the scene but the Closed property will be false. Such a mesh may be made up of open parts that do not join up perfectly to make a closed mesh. If Remove self-intersections for volumes is enabled for such a mesh, it may disappear when it is trimmed.
Remove self-intersections for volumes should not be enabled for surface-like open meshes.
You may wish to enable Remove self-intersections for volumes if a mesh is reporting as open but is more volume-like than surface-like. Such a mesh may have a single open part that needs to be removed, or it may have open parts that line up perfectly and can be retriangulated to form a closed mesh.
The next four options are automatically applied to meshes created in or imported into Leapfrog Geo:
- Consistently orient faces ensures that a mesh can be used for inside/outside testing.
- Remove non-vertex points removes points that are not used by any triangles.
- Remove degenerate faces removes triangles with duplicate vertices.
- Orient concentric parts ensures that internal parts have the correct orientation.
Other options are:
- Invert mesh orientation reverses the polarity of the mesh.
- Remove vertical edges removes any vertical faces from the mesh boundary.
- Rotate locations about X axis lets you rotate the mesh 90 degrees clockwise or anticlockwise.
- Move Mesh lets you offset the mesh by a vector. Tick the Move Mesh box and enter the required values. The offset values can be changed by opening the Clean Mesh window once again.
Select the options required, then click OK.
The mesh will be added to the project tree under the Meshes folder.
Importing a Mesh
Mesh formats Leapfrog Geo supports include:
- Leapfrog Files (*.msh, *.ara)
- Gocad Files (*.ts)
- DXF Files (*.dxf)
- Surpac Files (*.str, *.dtm)
- Gemcom Files (*.tri)
- Datamine Files (*pt.asc, *tr.asc)
- Micromine Files (*MMpt.dat, *MMtr.dat)
- DXF Polyface Files (*.dxf)
- Alias Wavefront Object Files (*.obj)
- Vulcan Files (*.00t) (with Maptek Link)
If you have the Maptek Link module, you can also import meshes in VULCAN .00t format. Contact Customer Support as described in Getting Support for more information about licensing the Maptek Link module.
Once a mesh has been imported to the project, you can evaluate it against any interpolant or distance function in the project. See Meshes for more information.
To import a mesh, right-click on the Meshes folder and select Import Mesh. Navigate to the folder that contains the mesh file and select the file. You can select multiple files using the Shift and Ctrl keys. Click Open to import the file.
The Cleanup Mesh window will be displayed. See Cleaning Up a Mesh. Select the options required, then click OK.
The mesh will be added to the project tree under the Meshes folder.
Meshes with Textures
Leapfrog Geo can import OBJ meshes with textures. If you have the Maptek Link module, you can also import Vulcan 8 meshes with textures.
Textured OBJ Meshes
For OBJ meshes, a materials file (.mtl) is required, together with the referenced images. Image formats supported include:
- PNG Files (*.png)
- JPEG Files (*.jpg, *.jpeg)
- TIFF and GeoTIFF Files (*.tiff, *.tif)
- Windows Bitmap Files (*.bmp)
- Graphics Interchange Format Files (*.gif)
The texture is automatically imported when the mesh is imported and will appear in the project tree under the mesh.
Textured Vulcan 8 Meshes
This feature is only available if you have the Maptek Link module.
When importing a Vulcan 8 mesh that contains a path to an associated texture, Leapfrog Geo will also import the texture. If the path to the texture does not exist, you can import it once the mesh has been imported. Do this by right-clicking on the mesh in the project tree and selecting Import Texture. Navigate to the folder containing the texture file and click Open. The texture will be imported and stored in the project tree as part of the mesh.
Reloading a Mesh
Meshes imported into Leapfrog Geo and created from extracting mesh parts can be reloaded. To do this, right-click on the mesh in the project tree and select Reload Mesh. Navigate to the file that should be used and click Open.
Displaying Surfaces
Leapfrog Geo assigns different colours to each side of a surface.
A basic mesh will have an inside (coloured red) and an outside (coloured blue):
In the case of contact surfaces, each side will be assigned a lithology. “Unknown” will be used if multiple lithologies are contacted. Contact surfaces can be displayed using the assigned lithologies or the younging direction:
Veins can also be displayed coloured with the thickness values.
Surfaces that are part of a geological model or interpolant are, by default, displayed clipped to the model boundary:
Disable the Clipped surface button () to view the surface unclipped.
Draping an Image on a Mesh
You can drape images on any mesh in the Meshes folder. To do this, right-click on the mesh in the Meshes folder and select one of the Drape Image options.
- For the Import Image option, you will be prompted for a file location. Navigate to the folder containing the image you wish to drape, select the file and click Open. Set georeferencing information for the image, if required, then click OK. See Importing a Map or Image for more information on georeferencing images. The imported image will appear in the project tree under the mesh.
- For the Select Existing Image option, select from the images available in the project and click OK. A hyperlink to the image will appear in the project tree under the mesh.
You can drape as many images as required. When the mesh is displayed in the scene, you will be able to select any draped images from the list of display options.
When you import and georeference an image, you can then export it as a GeoTIFF. To do this, right-click on it in the project tree and select Export. You will be prompted for a filename and location. Click Save.
Importing Meshes from Central
When you are working in a Central project, you can import meshes from other Central projects on the same server. Importing meshes from Central allows you to easily share data between projects without having to manually export and re-import the data. In addition, if the mesh is out-of-date, you can reload it from Central.
Importing Central Meshes
To import a mesh from Central, first make sure you are already connected to Central. Then right-click on the Meshes folder and select Import Mesh From Central. In the window that appears, select one of the projects in the repository. Next, the project history will be displayed. Select a version to view a list of available objects, then click on a model to load its list of surfaces. Here, the surfaces from the Lithology geological model have been loaded, while the surfaces in the Numeric Models folder have not:
Use the Shift and Ctrl keys to select as many objects as required. Click Import to import the objects, which will be saved into the Meshes folder.
A different colour is used to indicate meshes imported from Central (), and viewing the properties shows you what version of the project the mesh came from:
When you import a mesh from Central, Leapfrog Geo checks to see if the mesh is the latest version from that branch. Out-of-date meshes () are indicated in the project tree.
Updating Out-of-Date Meshes
There are two options for updating an out-of-date mesh:
- Reload Latest on Branch imports the newest mesh available on the branch the out-of-date mesh was imported from.
- Reload From Central displays the project history and allows you to pick any point in time on any branch.
Right-click on a mesh and choose one of these options.
If you have selected multiple meshes in the project tree, the Reload Latest on Branch option is the only one available:
Exporting Meshes
Leapfrog Geo exports meshes in the following formats:
- Leapfrog Files (*.msh)
- Gocad Files (*.ts)
- DXF Files (*.dxf)
- Surpac Files (*.dtm, *.str)
- Gemcom Files (*.tri)
- Datamine Files (*pt.asc, *tr.asc)
- Micromine Files (*MMpt.dat, *MMtr.dat)
- DXF Polyface Files (MineCAD) (*.dxf)
- Alias Wavefront Object Files (*.obj)
- Drawing Files (2013/LT2013) (*.dwg)
If you have the Maptek Link module, you can also export meshes in VULCAN .00t format. Contact Customer Support as described in Getting Support for more information about licensing this module.
You can export single meshes or batch export meshes from the Meshes folder or from individual models. Each of these is described below:
- Exporting a Single Mesh
- Exporting Multiple Meshes from the Meshes Folder
- Exporting Multiple Meshes from Models
Exporting a Single Mesh
To export a mesh, right-click on the mesh and select Export. The Export Mesh Parts window will appear:
The Export clipped mesh option is only available for meshes that are clipped to a boundary. If the quality of the mesh produced is not acceptable, clip the mesh as described in Clipping a Mesh, then export the mesh.
Select the Parts to Export, then click OK. You will be prompted for a filename and location.
When exporting a mesh that has multiple parts, you can distinguish between the different parts by clicking on them in the Export Mesh Parts window. Here, the mesh was added to the scene before the Export Mesh Parts window was opened. Clicking on a mesh part in the list selects that part in the scene:
If the mesh is not in the scene when the Export Mesh Parts window is opened, selecting a part in the list will display it in the scene without reference to the other parts of the mesh:
Use the Shift and Ctrl keys to select and view multiple mesh parts in the scene:
Exporting Multiple Meshes from the Meshes Folder
To export multiple meshes from those in the Meshes folder, right-click on the Meshes folder and select Export Meshes. In the window that appears, select the meshes you wish to export:
The filename that will be used for each mesh is shown in the Filenames column. To change the filename for any of the meshes, click on its name in the Filenames column.
Next, select the format required and where to save the exported meshes. Available formats are:
- Leapfrog Model Files (*.lfm)
- Leapfrog Files (*.msh)
- Gocad Files (*.ts)
- DXF Files (*.dxf)
- Surpac Files (*.dtm, *.str)
- Gemcom Files (*.tri)
- Datamine Files (*pt.asc, *tr.asc)
- Micromine Files (*MMpt.dat, *MMtr.dat)
- DXF Polyface Files (MineCAD) (*.dxf)
- Alias Wavefront Object Files (*.obj)
- Drawing Files (2013/LT2013) (*.dwg)
Click Export to save the meshes.
Exporting Multiple Meshes from Models
You can export multiple meshes from individual geological models, numeric models, combined models and static models. To export meshes in this way, right-click on a model or interpolant and select Export. In the window that appears, select the volumes and surfaces you wish to export:
For geological models, if you wish to export surfaces other than the output volumes, untick the Only Output Volumes option. For faulted geological models, you also can select from the faulted volumes by ticking the Faulted Volumes box.
The filename that will be used for each mesh is shown in the Filenames column. To change the filename for any of the meshes, click on its name in the Filenames column.
Next, select the format required and where to save the exported meshes. Available formats are:
- Leapfrog Model Files (*.lfm)
- Leapfrog Files (*.msh)
- Gocad Files (*.ts)
- DXF Files (*.dxf)
- Surpac Files (*.dtm, *.str)
- Gemcom Files (*.tri)
- Datamine Files (*pt.asc, *tr.asc)
- Micromine Files (*MMpt.dat, *MMtr.dat)
- DXF Polyface Files (MineCAD) (*.dxf)
- Alias Wavefront Object Files (*.obj)
- Drawing Files (2013/LT2013) (*.dwg)
For any of the export options other than Leapfrog Model Files format, you can save the meshes as a zip file.
The Leapfrog Model File format exports a single *.lfm file. If the file is imported into the Meshes folder, each output volume will appear as a single mesh.
Click Export to save the meshes.
Got a question? Visit the My Leapfrog forums at https://forum.leapfrog3d.com/c/open-forum or technical support at http://www.leapfrog3d.com/contact/support