Location-wise summary

An ensemble is an attribute where every location has multiple equiprobable values. The location-wise summary task computes summary statistics (min, max, mean, and variance) of all the values at each location, and saves each statistic as a geoscience object attribute.

Parameters

• source (geoscience object reference)
  • A geoscience object reference that points to a multi-dimensional continuous attribute inside a regular-3d-grid or regular-masked-3d-grid object. This is the ensemble you want to aggregate.
• target (geoscience object reference)
  • A geoscience object reference that tells the task where to save the result. It must point to a regular-3d-grid or regular-masked-3d-grid object. The task will save four attributes to that object for the summary statistics. It will name them: "min", "max", "mean", and "variance".

Example

For more information, see the location-wise summary API reference.

Request

requests.post(
    "https://{hub}.api.seequent.com/compute/orgs/{org_id}/geostatistics/location-wise-summary",
    headers={"Authorization": "Bearer {token}"},
    json={
        "parameters": {
            "source": {
                "object": "https://{hub}.api.seequent.com/geoscience-object/orgs/{org_id}/workspaces/{workspace_id}/objects/path/my-grid.json",
                "attribute": "locations.attributes[?name=='my-attribute']",
            },
            "target": {
                "object": "https://{hub}.api.seequent.com/geoscience-object/orgs/{org_id}/workspaces/{workspace_id}/objects/path/my-grid.json",
            },
        },
    },
)

Result

{
    "message": "Location-wise summary statistics computed.",
    "object_modified": {
        "type": "geoscience-object-reference",
        "object_reference": "https://{hub}.api.seequent.com/geoscience-object/orgs/{org_id}/workspaces/{workspace_id}/objects/path/my-grid.json",
        "object_element": [
            {
                "type": "element",
                "path": "/cell_attributes/@name=min",
            },
            {
                "type": "element",
                "path": "/cell_attributes/@name=max",
            },
            {
                "type": "element",
                "path": "/cell_attributes/@name=mean",
            },
            {
                "type": "element",
                "path": "/cell_attributes/@name=variance",
            },
        ],
    },
}

Tips

• The source and target can use the same object, but they don't have to.
• The task computes four summary statistics: minimum, maximum, mean, and variance of the ensemble values at each location.