Generates 3D web versions of geological models primarily for geomodelportal website (https://github.com/AuScope/geomodelportal)

1. Install Python v3.7 or higher (https://www.python.org/)
2. Install PDM (https://pdm.fming.dev/latest/)

NB: pyassimp requires the assimp shared library which may need to be compiled and installed separately

3. Clone and compile collada2gltf (https://github.com/KhronosGroup/COLLADA2GLTF)
4. Set 'COLLADA2GLTF_BIN' environment variable to point to the path where 'COLLADA2GLTF-bin' resides, e.g.

export COLLADA2GLTF_BIN=/home/fred/github/COLLADA2GLTF/build/

5. Clone this repository (i.e. geomodel-2-3dweb)
6. 'pdm install' will install the python library dependencies 'eval $(pdm venv activate)' will start a Python env, 'deactivate' to exit

Run conv_webasset.py. You must give it either the directory where the GOCAD files reside, or a GOCAD file plus a conversion parameter file. This README explains the format of the conversion parameter file.

e.g.

./conv_webasset.py gocad.ts config.json

where config.json looks like this:

{
    "ModelProperties": {
        "crs": "EPSG:28352",
        "name": "Any Name",
        "modelUrlPath": "path",
        "init_cam_dist": 0.0,
        "proj4_defn": "+proj=utm +zone=52 +south +ellps=GRS80 +towgs84=0,0,0,0,0,0,0 +units=m +no_defs"
    },
    "GroupStructure": {}
}

Use the '-g' flag to generate COLLADA files

batch_proc.py is a simple batch script used to convert the GOCAD models for the website.

make_boreholes.py is a script to create a database of NVCL borehole objects to display within the model. See this README for more information.

Autogenerated API Documentation is available here

Please see README file for documentation generation details.

Funding provided by AuScope Pty Ltd

SKUA/GOCAD software from the Paradigm Academic Software Program was used to view some types of GOCAD object files and produce sample GOCAD OBJECT files used for testing

Please cite as:

Fazio, Vincent; Woodcock, Robert (2024): AuScope 3D Geological Models Portal. v1. CSIRO. Service Collection. http://hdl.handle.net/102.100.100/609085?index=1