Geostatistics Task API

Version: 0.1.4

Conditional simulation workflow

POST

/compute/orgs/{org_id}/geostatistics/consim

For more information, please read the guide

Request

Path parameters

org_iduuid

Required

The organisation identifier

Body parameters

source_objecturi

Required

Reference to the Geoscience Object containing the source points used for conditioning the simulation.

source_attributestring

Required

Examples: "example string", "another example"

Reference to the attribute containing the source values. The values are transformed to normal-score space using the provided distribution.

target_objecturi

Required

Example: "/geoscience-object/orgs/{org_id}/workspaces/{workspace_id}/objects/{object_id}"

Reference to the Geoscience Object containing the grid to evaluate the simulation onto. A new attribute will be created on this object.

neighborhoodNeighborhood

Required

Search neighborhood for conditioning.

max-samplesinteger

Required

Examples: 49, 50, 60, 68, 77

The maximum number of samples to use for each evaluation point.

anisotropyEllipsoid

Required

The ellipsoid, to search for points within

ellipsoid_rangesEllipsoid Ranges

Required

The ranges of the ellipsoid

majornumber

Required

Examples: 16.26540971560848, 35.52707002275215, 67.01751743776934, 68.35476655366672, 70.18203134585514

The major axis length of the ellipsoid

semi_majornumber

Required

Examples: 7.140250957854832, 24.48109251514262, 46.22602118511158, 53.4139877029708, 63.49782881970603

The semi major axis length of the ellipsoid

minornumber

Required

Examples: 21.961517397026896, 26.994782678427796, 32.428273441532184, 68.81619584333131, 92.53911796212178

The minor axis length of the ellipsoid

rotationRotation

Required

The rotation of the ellipsoid

dip_azimuthnumber

Required

Examples: 134.43138091054578, 143.6372279990745, 241.8073054697819, 248.3523475558637, 256.66163021488387

first rotation, about the z-axis, in degrees

dipnumber

Required

Examples: 3.7861668012705985, 11.524661338742085, 44.62301045988143, 81.26750545040335, 161.9305352357302

second rotation, about the x-axis, in degrees

pitchnumber

Required

Examples: 2.588702034633674, 21.194556075476424, 199.4117480728127, 211.83844118772637, 254.82274075744348

third rotation, about the z-axis, in degrees

min-samplesinteger

Examples: 2, 33, 71, 88, 93

Default: 1

The minimum number of samples to use for each evaluation point.

distributionContinuousDistributionParameters | null

variogram_modeluri

Required

Example: "/geoscience-object/orgs/{org_id}/workspaces/{workspace_id}/objects/{object_id}"

Reference to the variogram model used to model the covariance within the domain.

kriging_method"simple" | "ordinary"

Default: "simple"

The kriging method to use for the conditioning step.

block_discretizationBlockDiscretization

Required

Sub-block discretization used for support correction within each grid block.

nxinteger

Required

Examples: 1, 2, 4, 5

Default: 1

Number of subdivisions in the x direction

nyinteger

Required

Examples: 2, 3, 7, 9

Default: 1

Number of subdivisions in the y direction

nzinteger

Required

Examples: 1, 2, 4

Default: 1

Number of subdivisions in the z direction

number_of_linesinteger

Examples: 249, 417, 485, 804, 827

Default: 500

Number of lines to use for the turning-band simulation.

number_of_simulationsinteger

Examples: 13, 25, 56, 85

Default: 1

Number of simulations to run.

random_seedinteger

Examples: 45, 52, 54, 59, 93

Default: 38239342

Random seed for simulation and tie-breaking.

number_of_simulations_to_saveinteger

Examples: 6, 12, 82, 83, 86

Default: 5

Number of simulations to publish to the output object.

loss_calculationLossCalculationsSettings | null

location_wise_quantilesQuantile[]

Examples: [0.06061267407701365,0.7282135884411827,0.8005925108616988], [0.109269032244804,0.19159007214165402,0.5362857539103444]

List of quantiles to compute for each location.

perform_validationboolean

Examples: true, false

Whether to run validation and generate a validation report.

report_contextValidationReportContext | null

Context for the validation report.

report_mean_thresholdsValidationReportThresholds | null

Thresholds for the mean comparison in the validation report.

Example body

{
  "source_object": "https://example.com",
  "source_attribute": "string",
  "target_object": "https://example.com",
  "neighborhood": {
    "max-samples": 0,
    "anisotropy": {
      "ellipsoid_ranges": {
        "major": 0,
        "semi_major": 0,
        "minor": 0
      },
      "rotation": {
        "dip_azimuth": 0,
        "dip": 0,
        "pitch": 0
      }
    },
    "min-samples": 1
  },
  "distribution": {
    "source": {
      "type": "geoscience-object-reference",
      "key": "string",
      "object_reference": "string",
      "object_element": [
        {
          "type": "element",
          "path": "string"
        }
      ]
    },
    "target": {
      "type": "geoscience-object-reference",
      "key": "string",
      "object_reference": "string"
    },
    "weights": "string",
    "tail_extrapolations": {
      "upper": {
        "power_model": {
          "power": 0,
          "max": 0
        }
      },
      "lower": {
        "power_model": {
          "power": 0,
          "min": 0
        }
      }
    },
    "replace": false,
    "tail_extrapolation": {
      "upper": {
        "power": 0,
        "max": 0
      },
      "lower": {
        "power": 0,
        "min": 0
      }
    }
  },
  "variogram_model": "https://example.com",
  "kriging_method": "simple",
  "block_discretization": {
    "nx": 1,
    "ny": 1,
    "nz": 1
  },
  "number_of_lines": 500,
  "number_of_simulations": 1,
  "random_seed": 38239342,
  "number_of_simulations_to_save": 5,
  "loss_calculation": {
    "material_categories": [
      {
        "cutoff_grade": 0,
        "metal_price": 0,
        "label": "string"
      }
    ],
    "processing_cost": 0,
    "mining_waste_cost": 0,
    "mining_ore_cost": 0,
    "metal_recovery_fraction": 0,
    "target_attribute": {
      "operation": "string",
      "name": "string"
    }
  },
  "location_wise_quantiles": [
    0
  ],
  "perform_validation": false,
  "report_context": {
    "title": "string",
    "details": [
      {
        "label": "string",
        "value": "string"
      }
    ]
  },
  "report_mean_thresholds": {
    "acceptable": 0,
    "marginal": 0
  }
}

Responses

200

The task result returned by the Compute API Result endpoint when the task is done

Response schema

targetTarget grid

The target grid with simulation results.

referenceuri

Example: "/geoscience-object/orgs/{org_id}/workspaces/{workspace_id}/objects/{object_id}"

Reference to a geoscience object.

namestring

Examples: "Sample Name", "A name for the thing"

The name of the geoscience object.

descriptionstring | null

Examples: "This is a sample description. It describes a thing for which we need a description", "An example description, which could be quite long and detailed."

The description of the geoscience object.

schema_idstring

Examples: "123e4567-e89b-12d3-a456-426614174000", "987e6543-e21b-12d3-a456-426614174999"

The ID of the Geoscience Object schema.

summary_attributesSummary statistics

Attribute containing summary statistics of the simulation results.

meanMean

Attribute containing the mean of the simulations.

referencestring

Examples: "example string", "another example"

Reference to the attribute in the geoscience object.

namestring

Examples: "Sample Name", "A name for the thing"

The name of the output attribute.

varianceVariance

Attribute containing the variance of the simulations.

referencestring

Examples: "example string", "another example"

Reference to the attribute in the geoscience object.

namestring

Examples: "Sample Name", "A name for the thing"

The name of the output attribute.

minMinimum

Attribute containing the minimum of the simulations.

referencestring

Examples: "example string", "another example"

Reference to the attribute in the geoscience object.

namestring

Examples: "Sample Name", "A name for the thing"

The name of the output attribute.

maxMaximum

Attribute containing the maximum of the simulations.

referencestring

Examples: "example string", "another example"

Reference to the attribute in the geoscience object.

namestring

Examples: "Sample Name", "A name for the thing"

The name of the output attribute.

quantile_attributesQuantile[]

List of attributes containing quantiles of the simulation results.

referencestring

Examples: "example string", "another example"

Reference to the attribute in the geoscience object.

namestring

Examples: "Sample Name", "A name for the thing"

The name of the output attribute.

quantilenumber

Examples: 0.0584832920072994, 0.060957571476515815, 0.21770089841417495, 0.31360480976972926, 0.7357371787890434

Quantile of the simulations, that this attribute represents.

simulationsAttributeOutput_ContinuousEnsemble_V1_1_0_ | null

Attribute containing the simulation results.

simulations_normal_scoreAttributeOutput_ContinuousEnsemble_V1_1_0_ | null

Attribute containing the simulation results in normal score space.

point_simulationsAttributeOutput_ContinuousEnsemble_V1_1_0_ | null

Attribute containing the point simulation results.

point_simulations_normal_scoreAttributeOutput_ContinuousEnsemble_V1_1_0_ | null

Attribute containing the point simulation results in normal score space.

loss_calculation_attributeAttributeOutput_CategoryAttribute_V1_1_0_ | null

Attribute containing the loss calculation results.

validation_summaryValidationSummary | null

validation_reportFileOutput | null

Link to the validation report file.

linksLinks

Links related to the simulation task.

dashboarduri | null

(1, 2,083) chars

Link to the validation dashboard.

Example response

{
  "target": {
    "reference": "https://example.com",
    "name": "string",
    "description": "string",
    "schema_id": "string",
    "summary_attributes": {
      "mean": {
        "reference": "string",
        "name": "string"
      },
      "variance": {
        "reference": "string",
        "name": "string"
      },
      "min": {
        "reference": "string",
        "name": "string"
      },
      "max": {
        "reference": "string",
        "name": "string"
      }
    },
    "quantile_attributes": [
      {
        "reference": "string",
        "name": "string",
        "quantile": 0
      }
    ],
    "simulations": {
      "reference": "string",
      "name": "string"
    },
    "simulations_normal_score": {
      "reference": "string",
      "name": "string"
    },
    "point_simulations": {
      "reference": "string",
      "name": "string"
    },
    "point_simulations_normal_score": {
      "reference": "string",
      "name": "string"
    },
    "loss_calculation_attribute": {
      "reference": "string",
      "name": "string"
    }
  },
  "validation_summary": {
    "reference_mean": 0,
    "mean": 0
  },
  "validation_report": {
    "reference": "https://example.com",
    "name": "string"
  },
  "links": {
    "dashboard": "https://example.com"
  }
}

303

303 response, see Compute API Execute Task documentation for more details