Geostatistics Task API

Version: 0.1.4

Kriging

POST

/compute/orgs/{org_id}/geostatistics/kriging

For more information, please read the guide

Request

Path parameters

org_iduuid

Required

The organisation identifier

Body parameters

sourceSource

Required

The source object and attribute containing known values.

objecturi

Required

Spatial locations of known values.

attributestring

Required

Examples: "example string", "another example"

The known values, used to estimate values at unknown locations..

targetTarget

Required

The target object and attribute to create or update with kriging results.

objecturi

Required

Object to evaluate onto.

attribute |

Required

Name of the attribute to create or update on the target object

One of:

object

operation"create"

Required

The operation to perform on the attribute.

namestring

Required

The name of the attribute to create.

object

operation"update"

Required

The operation to perform on the attribute.

referencestring

Required

Reference to an existing attribute to update.

kriging_methodSimpleKriging | OrdinaryKriging

Required

The kriging method to use. Either simple or ordinary kriging.

One of:

SimpleKrigingobject

type"simple"

Required

Examples: "example string", "another example"

The type of kriging to use.

meannumber

Required

Examples: 8.011146524058688, 15.743272793948327, 18.58249609807232, 59.50351064500276, 96.07789032744503

The mean value, assumed to be constant across the domain.

OrdinaryKrigingobject

type"ordinary"

Required

Examples: "example string", "another example"

The type of kriging to use.

variogramuri

Required

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

Model of the covariance within the domain.

neighborhoodSearch

Required

Search parameters.

In Kriging, the value of each evaluation point is determined by a set of nearby points with known values. The search parameters determines which nearby points to use.

ellipsoidEllipsoid

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

max_samplesinteger

Required

Examples: 6, 61, 64, 67, 74

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

Example body

{
  "source": {
    "object": "https://example.com",
    "attribute": "string"
  },
  "target": {
    "object": "https://example.com",
    "attribute": {
      "operation": "string",
      "name": "string"
    }
  },
  "kriging_method": {
    "type": "string",
    "mean": 0
  },
  "variogram": "https://example.com",
  "neighborhood": {
    "ellipsoid": {
      "ellipsoid_ranges": {
        "major": 0,
        "semi_major": 0,
        "minor": 0
      },
      "rotation": {
        "dip_azimuth": 0,
        "dip": 0,
        "pitch": 0
      }
    },
    "max_samples": 0
  }
}

Responses

200

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

Response schema

messagestring

Examples: "example string", "another example"

A message that says what happened in the task.

targetTarget

The target that was created or updated.

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.

attributeAttribute

Attribute containing the kriging result.

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.

Example response

{
  "message": "string",
  "target": {
    "reference": "https://example.com",
    "name": "string",
    "description": "string",
    "schema_id": "string",
    "attribute": {
      "reference": "string",
      "name": "string"
    }
  }
}

303

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