Geotechnical Tasks

Repair geotechnical models to make them suitable for finite element analysis. They read geoscience objects, such as triangle meshes and geological model meshes. They write results back to geoscience objects. Some tasks, like the mesh-validation checks, return their findings directly in the task result.

How do you run a geotechnical compute task?

It takes three steps to run a task.

1. Start the task.
2. Wait for it to finish.
3. Get the result.

You can use the Task API for each step.

How do you start a task?

You can start a task by sending a POST request to the Task API.

POST https://{hub}.api.seequent.com/compute/orgs/{org_id}/geotech/{task}

That URL has three placeholders you need to fill in.

• Replace {hub} with the hub code for the hub you are using.
• Replace {org_id} with the UUID for your organization.
• Replace {task} with the name of the task you want to use.

Send a request body that has a parameters field with your task parameters. The parameters are different for each task.

{
    "parameters": {
        ...
    }
}

How do you know when the task is done?

When you start the task, the Task API will respond with HTTP code 303 and a header called Location. The value inside the Location header is a status endpoint you can use to check the status of your job. You can send GET requests to that endpoint over and over until it says your job is done.

How do you get the results?

When your task is done, the status endpoint response has a result link in the links section. Make a GET request to the result link, and it tells you what geoscience objects were created or modified by the task, along with any data the task produced.

{
    "message": "Your task is done!",
    "object": {
        ...
    }
}

Geoscience objects

Geotechnical compute tasks read data from one or more geoscience objects and usually write results to a geoscience object, too. Since they work with geoscience objects so much, there are special parameter formats that you can use to tell the task what objects you want to use.

Geoscience object references

A geoscience object reference is a URL for a geoscience object. You can either use URLs with the object's path or its ID.

// A path-based URL
"https://{hub}.api.seequent.com/geoscience-object/orgs/{org_id}/workspaces/{workspace_id}/objects/path/{path}"

// An ID-based URL
"https://{hub}.api.seequent.com/geoscience-object/orgs/{org_id}/workspaces/{workspace_id}/objects/{object_id}"

Geoscience object targets

A geoscience object target lets you tell the task how to save results to a geoscience object. It has four fields.

• reference (string)
  • The geoscience object reference that points to the object where you want to save results.
• overwrite (boolean, optional)
  • If this is true, the task will overwrite the object at reference if it already exists. If this is false, the task will fail if the object already exists. Defaults to false.
• description (string, optional)
  • A description for the object. If the object already exists and you include this field, the task will update the object's description. If you don't include this field, the task will leave the object's description unchanged. If it's a brand new object, the task will create it with this description.
• tags (object, optional)
  • Tags to add to the object. If the object already exists and you include this field, the task will add these tags to the object's existing tags. If you don't include this field, the task will leave the object's tags unchanged. If it's a brand new object, the task will create it with these tags.

{
  "reference": "https://{hub}.api.seequent.com/geoscience-object/orgs/{org_id}/workspaces/{workspace_id}/objects/path/{path}",
  "overwrite": true,
  "description": "A description",
  "tags": {
    "Tag": "value"
  }
}

Available tasks

Add to intersected geometry

The Add to intersected geometry task adds one or more triangle mesh objects to an existing intersected Geological Model Meshes object.

Check triangle orientation

The Check triangle orientation task identifies triangles with inconsistent normal orientation relative to their neighbors.

Copy geological model meshes

The Copy geological model meshes task copies an existing set of Geological Model Meshes, optionally removing external volumes from the result.

Create cross section

The Create cross section task intersects parameterized 3D Design Geometry with a vertical plane to produce a 2D Design Geometry cross section.

Create geological model meshes

The Create geological model meshes task decomposes an intersected mesh or existing GMM into per-volume geological model meshes, optionally removing the top external volume.

Detect degenerate triangles

The Detect degenerate triangles task identifies needle and cap triangles in a Triangle Mesh or Geological Model Meshes object.

Detect duplicate points

The Detect duplicate points task identifies exact duplicate vertices in a Triangle Mesh or Geological Model Meshes object.

Detect duplicate triangles

The Detect duplicate triangles task identifies duplicate triangles with the same vertex indices regardless of order.

Detect fins

The Detect fins task identifies fin-like connected components without closed boundaries.

Detect holes

The Detect holes task identifies holes in a Triangle Mesh or Geological Model Meshes object based on boundary edge analysis.

Detect non-manifold edges

The Detect non-manifold edges task identifies edges shared by more than two triangles.

Detect non-manifold vertices

The Detect non-manifold vertices task identifies vertices with non-manifold topology.

Detect non-partitioning surfaces

The Detect non-partitioning surfaces task identifies surfaces that are neither fins nor surfaces with holes.

Detect self-intersections

The Detect self-intersections task identifies self-intersecting triangles in a Triangle Mesh or Geological Model Meshes object.

Fill holes

The Fill holes task fills holes in a Geological Model Meshes object using specified edge identifiers and a configurable fill mode strategy.

Fix self-intersections

The Fix self-intersections task fixes self-intersections in a Geological Model Meshes object using configurable intersection detection settings.

Initialize aggregate geometry

The Initialize aggregate geometry task creates a rotated bounding box as a Geological Model Meshes object for use as the initial intersected geometry when creating a model.

Local remesh

The Local remesh task locally remeshes a Geological Model Meshes object around selected seed triangles using configurable remeshing parameters and radius-based region growth.

Make GMM into intersected geometry

The Make GMM into intersected geometry task clips a Geological Model Meshes object and processes it to create an intersected geometry mesh.

Make into model input

The Make into model input task clips a triangle mesh to specified bounds, merges duplicate points, and translates it so it can be used as model input.

Mark volumes for removal

The Mark volumes for removal task marks specified volumes in a Geological Model Meshes object for removal by setting their material to external, or clears the marking.

Parameterize volumes

The Parameterize volumes task parameterizes closed volumes from Triangle Mesh or Geological Model Meshes inputs and writes the result as a Design Geometry object.

Remesh

The Remesh task remeshes a Geological Model Meshes object to improve triangle quality while preserving the model structure.

Remove triangles

The Remove triangles task removes selected triangle indices from a Geological Model Meshes object and uploads the updated mesh as a new object.

Subsume embedded volume in GMM

The Subsume embedded volume in GMM task merges a specified source embedded volume into a target volume in a GMM, either by explicit index or automatic selection.

Validate GMM as intersected geometry

The Validate GMM as intersected geometry task checks whether a Geological Model Meshes object is valid as intersected geometry and returns human-readable descriptions of any issues found.