AI Assistant¶

The GM3D AI Assistant lets you build the 3D geotechnical model by writing in plain language: describe what you want, in your own words, and the model builds itself.

Open it from the AI Assistant button in the ribbon. The panel stays open on the side, so you can watch the 3D model update as you type.

How it works¶

The flow is always the same, in three steps:

You write — describe the scene the way you would tell a colleague.
The AI understands — it recognises your intent and picks the right commands, with parameters.
GM3D builds — it runs and draws: exact, deterministic, repeatable geometry.

The role of the AI

The AI interprets language, it never touches the geometry. The model is always built by the same GM3D engine — the one already validated. This guarantees precise, repeatable results: the assistant does not "invent" geometry, it only chooses which commands to run.

You don't need the exact phrase: write in your own words. The assistant grasps the meaning, handles context ("the front", "all sides", "a bit forward") and chains several actions in one go.

Available commands¶

Terrain¶

Type	Result
`create a flat 50×50 m terrain at elevation 100`	flat surface ready to use
`create a terrain with a river`	terrain with the river channel carved in
`a very winding river` / `a barely winding river`	controls how sinuous the river is
`generate an undulating surface` / `terrain with a hill and a hollow`	natural, irregular morphology with rises and dips
`remove the terrain` / `start over`	clears the surface / empties the model and restarts

Water table & water¶

Type	Result
`add the water table at elevation 95`	water table at the given elevation
`reveal the river`	water table at the river level, to highlight the river
`remove the water table`	removes the water table
`fill the excavation with water`	fills up to the excavation rim
`put 4 metres of water`	fixed-height water body

Boreholes & stratigraphy¶

Type	Result
`add a borehole in the centre`	borehole snapped to the terrain
`put 4 boreholes at the corners`	boreholes at the corners of the area
`borehole with 2 m of clay, 3 of sand, then gravel`	full stratigraphic column
`remove borehole S1`	removes the named borehole
`import the boreholes from the .edp folder`	bulk-import boreholes from `.edp` files (exported from Dynamic/Static Probing), each at its own coordinates
`build the 3D stratigraphy`	stratigraphic solid between the boreholes

Importing boreholes from .edp files

The .edp format is the GeoStru interchange format: from Dynamic Probing or Static Probing you export a test with "Export test for other GeoStru software" (one file per test). Put them in a folder and ask "import the boreholes from the .edp folder": the assistant opens a folder picker and imports all boreholes at once, each placed at its plane coordinates and with its own layers.

Geotechnical sections¶

Once the 3D stratigraphy is built, you can cut sections to read the layers inside the model.

Type	Result
`make a section along x` / `section along y`	vertical profile along the given axis, at the centre of the model
`section at Y=30`	section at a precise position
`make a section from S2 to S4` / `section along the boreholes`	section running through the named boreholes

Stratigraphy first

Sections cut the stratigraphic solid: build the 3D stratigraphy first ("build the 3D stratigraphy"), then ask for the section. Activating a section switches GM3D to the "Show 3D sections" view.

Structures¶

Type	Result
`create a wall on the front, 3 metres high`	cantilever wall placed on the front
`put a retaining wall on all sides`	walls oriented on the four sides
`add a wall 4 m high, 10 m long, grey`	wall sized and coloured
`put a footbridge from one bank to the other`	deck at bank level
`move the structure a bit forward`	fine positioning nudge
`delete the wall` / `remove all structures`	removes one structure or clears them all

Excavation¶

Type	Result
`create an excavation 4 metres deep`	excavation in the work area
`dig 10×8, 3 m deep with 45° walls`	excavation with sloped batter
`make an excavation with vertical walls`	90° walls

View¶

Type	Result
`make the model transparent`	see the layers inside the solid
`transparency at 60%`	adjust the opacity level
`show the edges` / `hide the edges`	model edges on / off

Terrain colour & gradient¶

Type	Result
`colour the terrain green`	solid colour for the topographic surface
`make the terrain light brown`	any colour by name
`apply the elevation gradient` / `colour by elevation`	colours by elevation (red at the bottom to blue at the top) with a legend
`remove the gradient`	back to solid colour

A sample sequence¶

You can also chain commands to build a full scene, one line at a time:

create a terrain with a winding river and two hollows
add a water table that reveals the river
add 4 well-spaced boreholes with 3 m of clay, 5 of sand and 4 of gravel
build the stratigraphy

Tip

The examples in the tables are only a starting point. Try writing the request in your own words: the assistant is designed to understand meaning, not a rigid syntax.