Evaluate Simulation Variables

curl --request POST \
  --url https://api.ionworks.com/simulations/{simulation_id}/evaluate \
  --header 'Content-Type: application/json' \
  --data '
{
  "variables": [
    "<string>"
  ]
}
'

{
  "detail": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>",
      "input": "<unknown>",
      "ctx": {}
    }
  ]
}

Evaluate Simulation Variables

Evaluate specific variables from a simulation.

This endpoint supports lazy variable evaluation:

If UCPSolution exists in storage: returns variables already in parquet
If only simulation_data exists and variables are present: returns from database
If variables are missing: triggers a re-run job (returns 202 Accepted)

Parameters

simulation_id : str ID of the simulation body : EvaluateVariablesRequest Request body with list of variable names to evaluate

Returns

dict Dictionary with time_series, steps, and metrics

Raises

HTTPException 202 if re-run is triggered (includes job_id in detail) 404 if simulation not found

Evaluate Simulation Variables

curl --request POST \
  --url https://api.ionworks.com/simulations/{simulation_id}/evaluate \
  --header 'Content-Type: application/json' \
  --data '
{
  "variables": [
    "<string>"
  ]
}
'

{
  "detail": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>",
      "input": "<unknown>",
      "ctx": {}
    }
  ]
}

Path Parameters

simulation_id

string

required

Body

application/json

Request body for evaluating specific variables from a simulation.

variables

string[]

required

List of variable names to evaluate from the simulation

Response

Successful Response

⌘I