Referencia de la API
Los endpoints que implementa un proveedor y todos los esquemas del contrato v0. Generada a partir de la misma fuente con la que valida la plataforma.
URL base
Su servicio, en una ruta base de su elección, que su equipo indica al conectar el modelo, por ejemplo https://models.example.com/shockai/v0.
Autenticación. Cada solicitud lleva un encabezado ShockAI-Signature, firmado con la clave Ed25519 de la plataforma. Consulte Firmar solicitudes.
Endpoints
/healthzSay the service is up
Optional and unsigned: the only endpoint that is. The platform may call it before a signed request, to wake a host that sleeps when idle, and ignores the body. Answer 200 without reading anything a case holds.
Respuestas
200Up.
/manifestDescribe the model
Returns the model manifest. The platform reads it at registration and whenever the provider announces a new version; a manifest change never alters a run already made, because every result is pinned to the version that produced it.
Respuestas
200ModelManifestThe manifest.401ApiErrorThe signature is missing, expired or wrong (authentication).500ApiErrorThe model failed (provider_error). The platform retries with backoff.
/quotePrice a case
For models priced by quote. Returns a binding price for the case; the platform shows it to the user and, on acceptance, passes the quote id with the run. Quoting must not start work.
Cuerpo de la solicitud
BlastCaseRespuestas
200QuoteThe quote.400ApiErrorThe request is malformed or the case fails validation (invalid_request).401ApiErrorThe signature is missing, expired or wrong (authentication).422ApiErrorThe case is valid but the model cannot run it (unsupported_case), or cannot honour its consent terms (consent_refused). Final: the platform will not retry.429ApiErrorToo many requests (rate_limited). SendRetry-After; the platform backs off accordingly.500ApiErrorThe model failed (provider_error). The platform retries with backoff.
/runsRun the model on a case
Sync models answer within 30 seconds with the run succeeded and its result. Async models answer 202 with the run queued, then report through the run.* webhooks. The case contains only the inputs the manifest declares. The platform sends an Idempotency-Key; a repeated key must return the original run, not start another.
Parámetros
Idempotency-Key(header)obligatorio · Stable across retries of the same run request.
Cuerpo de la solicitud
RunRequestRespuestas
200RunSync: the finished run.202RunAsync: the accepted run.400ApiErrorThe request is malformed or the case fails validation (invalid_request).401ApiErrorThe signature is missing, expired or wrong (authentication).422ApiErrorThe case is valid but the model cannot run it (unsupported_case), or cannot honour its consent terms (consent_refused). Final: the platform will not retry.429ApiErrorToo many requests (rate_limited). SendRetry-After; the platform backs off accordingly.500ApiErrorThe model failed (provider_error). The platform retries with backoff.
Callback
{$request.body#/callbackUrl}Run status changed. WebhookEvent Signed with the same scheme, with your key: one of the signing.callbackKeys your manifest declares, over the callback URL exactly as given. Sign each delivery afresh, so a retry carries a current timestamp. Deliver at least once: retry with backoff until a 2xx, stop on a 4xx other than 408 or 429, and after a restart send again what was not delivered, under the same event id. The platform de-duplicates on the event id, and polls a run whose callback does not come. The callback URL is the run's own, so keep it private.
/runs/{runId}Get a run
The platform polls this as a fallback when a webhook is late. Results must stay retrievable for at least 24 hours after the run finishes.
Parámetros
runId(path)obligatorio · The id the provider assigned inPOST /runs.
/runs/{runId}Cancel a run
Best effort. A run that has already finished is returned unchanged. A cancelled run is not charged.
Parámetros
runId(path)obligatorio · The id the provider assigned inPOST /runs.
Esquemas
Primero los documentos de nivel superior, luego las partes que los componen. Cada uno se publica también como un JSON Schema independiente.
BlastCase
Descargar JSON SchemaEverything a model may read about one blast: design, as-built record, site, receivers, calibration and the question asked.
| Campo | Tipo | Descripción |
|---|---|---|
specVersionobligatorio | "0.1" | Version of the ShockAI Model API specification this document follows. |
caseIdobligatorio | string | SHA-256 of the canonical case (see Canonical JSON) without caseId and createdAt, and without the uri of any BlobRef (any object carrying uri, sha256 and mediaType): its bytes are named by the hash, and a signed URL changes from run to run. Identical cases have identical ids, which is what makes results cacheable and reproducible.patrón ^sha256:[0-9a-f]{64}$ |
createdAtobligatorio | string (date-time) | An ISO 8601 timestamp in UTC, for example 2026-09-26T04:12:00Z. |
coordinateSystemobligatorio | CoordinateSystem | The frame every position in the case is expressed in. |
siteobligatorio | object | |
site.name | string | longitud mín. 1 · longitud máx. 200 |
site.domainsobligatorio | array de RockDomain | A zone of rock the site treats as one material. Holes name the domain they sit in.máx. 100 elementos |
site.terrain | BlobRef | Surface model, when the provider needs one. |
designobligatorio | Design | The blast as designed. |
asBuilt | object | Present once the blast is drilled, loaded or fired. A pre-blast prediction leaves it out. |
asBuilt.holes | array de AsBuiltHole | A hole as drilled and loaded. Fields left out are as designed.máx. 5000 elementos |
asBuilt.firing | FiringRecord | What actually fired, and when. |
receiversobligatorio | array de Receiver | A place a prediction is wanted. It has a position, a resolved distance, or both.máx. 1000 elementos |
calibration | Calibration | What the site has measured. This is what lets a kinematic model be calibrated rather than assumed. |
measured | Measured | Present once the blast has fired and its records are in. |
requestobligatorio | OutputRequest | The question the case asks. |
consentobligatorio | Consent | The data owner’s terms for this case. A provider that cannot honour them must refuse the run. |
ModelManifest
Descargar JSON SchemaWhat a model says about itself: capabilities, inputs, validity, execution, pricing and data handling.
| Campo | Tipo | Descripción |
|---|---|---|
specVersionobligatorio | "0.1" | Version of the ShockAI Model API specification this document follows. |
idobligatorio | ModelId | A model identifier in the form vendor/model, lower case, for example shockai/site-law. |
versionobligatorio | string | A semantic version. A result is always pinned to the exact version that produced it.patrón ^\d+\.\d+\.\d+(?:-[0-9A-Za-z.-]+)?$ |
nameobligatorio | string | longitud mín. 1 · longitud máx. 120 |
summaryobligatorio | string | longitud mín. 1 · longitud máx. 500 |
vendorobligatorio | object | |
vendor.nameobligatorio | string | longitud mín. 1 · longitud máx. 120 |
vendor.url | string (uri) | |
methodobligatorio | ModelMethod | The family of method, so a user can tell a fitted law from a simulation. |
capabilitiesobligatorio | array de Capability | One kind of output a model produces, and what it needs to produce it.mín. 1 elementos |
executionobligatorio | object | |
execution.modeobligatorio | enum | Sync models answer POST /runs within the timeout; async models accept the run and call back.syncasync |
execution.typicalSecondsobligatorio | number | > 0 |
execution.maxSecondsobligatorio | number | Hard limit. A run still going at this point is cancelled.> 0 · ≤ 604800 |
pricingobligatorio | object (model = "included") | object (model = "per_run") | object (model = "per_hole") | object (model = "quote") | object (model = "licence") | How a run is charged. |
pricing.modelobligatoriomodel = "included" | "included" | |
pricing.modelobligatoriomodel = "per_run" | "per_run" | |
pricing.currencyobligatoriomodel = "per_run" | string | longitud mín. 3 · longitud máx. 3 |
pricing.unitAmountobligatoriomodel = "per_run" | integer | Minor units, e.g. cents.≥ 0 |
pricing.modelobligatoriomodel = "per_hole" | "per_hole" | |
pricing.currencyobligatoriomodel = "per_hole" | string | longitud mín. 3 · longitud máx. 3 |
pricing.unitAmountobligatoriomodel = "per_hole" | integer | ≥ 0 |
pricing.modelobligatoriomodel = "quote" | "quote" | |
pricing.modelobligatoriomodel = "licence" | "licence" | |
pricing.notemodel = "licence" | string | The customer brings their own licence; the platform charges nothing on the run.longitud máx. 500 |
dataHandlingobligatorio | object | |
dataHandling.regionsobligatorio | array de string | Where the case is processed, for example au, eu, us.mín. 1 elementos · cada elemento longitud mín. 2, longitud máx. 40 |
dataHandling.retentionobligatorio | enum | none30dcontract |
dataHandling.trainsOnCustomerDataobligatorio | boolean | |
documentationUrl | string (uri) | |
signing | object | How the provider signs what it sends the platform. Required of an async model, whose results arrive as signed callbacks. |
signing.callbackKeysobligatorio | array de Ed25519Jwk | The public keys your callbacks are signed with, as Ed25519 JWKs: one, or two while you rotate. The platform pins them when the model is connected, so a changed key is a new manifest version.mín. 1 elementos · máx. 3 elementos |
build | object | What is deployed behind this version. |
build.hashobligatorio | string | Identifies the code and weights answering, for example a commit or image digest. Every result reports it in provenance.buildHash.longitud mín. 1 · longitud máx. 128 · patrón ^[A-Za-z0-9._:+/@-]+$ |
ModelResult
Descargar JSON SchemaWhat a model returns for one case.
| Campo | Tipo | Descripción |
|---|---|---|
specVersionobligatorio | "0.1" | Version of the ShockAI Model API specification this document follows. |
caseIdobligatorio | string | A content hash: sha256: followed by 64 lower-case hex digits.patrón ^sha256:[0-9a-f]{64}$ |
outputsobligatorio | array de Output | One answer, discriminated by kind.máx. 5000 elementos |
unavailableobligatorio | array de Unavailable | A requested output the model declined to produce, and why.máx. 5000 elementos |
warningsobligatorio | array de Warning | Something the model wants a person to see.máx. 500 elementos |
provenanceobligatorio | Provenance | Where a result came from. Reports cite it; the platform uses it to score the model later. |
RunRequest
Descargar JSON SchemaThe body of POST /runs.
| Campo | Tipo | Descripción |
|---|---|---|
caseobligatorio | BlastCase | Everything a model may read about one blast: design, as-built record, site, receivers, calibration and the question asked. |
quoteId | string | The accepted quote, for models priced by quote.longitud mín. 1 · longitud máx. 128 · patrón ^[A-Za-z0-9][A-Za-z0-9._:-]*$ |
callbackUrl | string (uri) | Where an async model sends its run.* events. Always HTTPS. |
A model run, by status. Sync models return it succeeded from POST /runs; async models return it queued.
Uno de QueuedRun | RunningRun | SucceededRun | FailedRun | CancelledRun
A binding price for one case, valid until it expires.
| Campo | Tipo | Descripción |
|---|---|---|
idobligatorio | string | An opaque identifier: letters, digits, ., _, : and -, up to 128 characters.longitud mín. 1 · longitud máx. 128 · patrón ^[A-Za-z0-9][A-Za-z0-9._:-]*$ |
caseIdobligatorio | string | A content hash: sha256: followed by 64 lower-case hex digits.patrón ^sha256:[0-9a-f]{64}$ |
currencyobligatorio | string | longitud mín. 3 · longitud máx. 3 |
amountobligatorio | integer | Minor units, e.g. cents.≥ 0 |
expiresAtobligatorio | string (date-time) | An ISO 8601 timestamp in UTC, for example 2026-09-26T04:12:00Z. |
estimatedSecondsobligatorio | number | > 0 |
ApiError
Descargar JSON SchemaEvery non-2xx response carries this body.
| Campo | Tipo | Descripción |
|---|---|---|
errorobligatorio | object | |
error.typeobligatorio | enum | The error family. unsupported_case and consent_refused are final; rate_limited, provider_error and timeout may be retried.invalid_requestunsupported_caseconsent_refusedauthenticationrate_limitedquote_expiredprovider_errortimeout |
error.codeobligatorio | string | A stable machine-readable code within the family.longitud máx. 80 · patrón ^[a-z][a-z0-9_]*$ |
error.messageobligatorio | string | longitud mín. 1 · longitud máx. 1000 |
error.param | string | The case field at fault, as a JSON Pointer.longitud máx. 200 |
WebhookEvent
Descargar JSON SchemaSent by an async provider to the run’s callbackUrl, signed like every request. type is run. and the state the run in data has reached.
Uno de
type = "run.running"| Campo | Tipo | Descripción |
|---|---|---|
idobligatorio | string | Unique per event; deliveries are at-least-once, so de-duplicate on it.longitud mín. 1 · longitud máx. 128 · patrón ^[A-Za-z0-9][A-Za-z0-9._:-]*$ |
createdAtobligatorio | string (date-time) | An ISO 8601 timestamp in UTC, for example 2026-09-26T04:12:00Z. |
typeobligatorio | "run.running" | |
dataobligatorio | object | |
data.runobligatorio | RunningRun | Started and not yet finished. |
type = "run.succeeded"| Campo | Tipo | Descripción |
|---|---|---|
idobligatorio | string | Unique per event; deliveries are at-least-once, so de-duplicate on it.longitud mín. 1 · longitud máx. 128 · patrón ^[A-Za-z0-9][A-Za-z0-9._:-]*$ |
createdAtobligatorio | string (date-time) | An ISO 8601 timestamp in UTC, for example 2026-09-26T04:12:00Z. |
typeobligatorio | "run.succeeded" | |
dataobligatorio | object | |
data.runobligatorio | SucceededRun | Finished with the model’s result. |
type = "run.failed"| Campo | Tipo | Descripción |
|---|---|---|
idobligatorio | string | Unique per event; deliveries are at-least-once, so de-duplicate on it.longitud mín. 1 · longitud máx. 128 · patrón ^[A-Za-z0-9][A-Za-z0-9._:-]*$ |
createdAtobligatorio | string (date-time) | An ISO 8601 timestamp in UTC, for example 2026-09-26T04:12:00Z. |
typeobligatorio | "run.failed" | |
dataobligatorio | object | |
data.runobligatorio | FailedRun | Finished without a result, and why. |
type = "run.cancelled"| Campo | Tipo | Descripción |
|---|---|---|
idobligatorio | string | Unique per event; deliveries are at-least-once, so de-duplicate on it.longitud mín. 1 · longitud máx. 128 · patrón ^[A-Za-z0-9][A-Za-z0-9._:-]*$ |
createdAtobligatorio | string (date-time) | An ISO 8601 timestamp in UTC, for example 2026-09-26T04:12:00Z. |
typeobligatorio | "run.cancelled" | |
dataobligatorio | object | |
data.runobligatorio | CancelledRun | Stopped before it finished, by the platform or the provider. |
ImportDocument
Descargar JSON SchemaPredictions made by another tool, brought onto the platform with their provenance.
| Campo | Tipo | Descripción |
|---|---|---|
specVersionobligatorio | "0.1" | Version of the ShockAI Model API specification this document follows. |
blastobligatorio | object | |
blast.platformBlastId | string | The blast on the platform, when the importer knows it.longitud mín. 1 · longitud máx. 128 · patrón ^[A-Za-z0-9][A-Za-z0-9._:-]*$ |
blast.externalRef | string | The blast’s name or number in the source tool.longitud mín. 1 · longitud máx. 200 |
sourceobligatorio | object | |
source.toolobligatorio | string | The software that produced the results.longitud mín. 1 · longitud máx. 120 |
source.versionobligatorio | string | longitud mín. 1 · longitud máx. 60 |
source.vendor | string | longitud mín. 1 · longitud máx. 120 |
source.method | ModelMethod | The family of method, so a user can tell a fitted law from a simulation. |
source.file | object | |
source.file.nameobligatorio | string | longitud mín. 1 · longitud máx. 255 |
source.file.sha256obligatorio | string | A content hash: sha256: followed by 64 lower-case hex digits.patrón ^sha256:[0-9a-f]{64}$ |
source.producedAt | string (date-time) | An ISO 8601 timestamp in UTC, for example 2026-09-26T04:12:00Z. |
outputsobligatorio | array de ImportedOutput | One prediction made elsewhere, discriminated by kind: every kind a prediction case asks.mín. 1 elementos · máx. 5000 elementos |
unavailable | array de Unavailable | A requested output the model declined to produce, and why.máx. 5000 elementos · predeterminado [] |
warnings | array de Warning | Something the model wants a person to see.máx. 500 elementos · predeterminado [] |
Airblast
Predicted peak overpressure at a receiver.
| Campo | Tipo | Descripción |
|---|---|---|
kindobligatorio | "airblast" | |
receiverIdobligatorio | string | An opaque identifier: letters, digits, ., _, : and -, up to 128 characters.longitud mín. 1 · longitud máx. 128 · patrón ^[A-Za-z0-9][A-Za-z0-9._:-]*$ |
peakPaobligatorio | Estimate | Peak overpressure, Pa. dB(L) = 20·log10(Pa / 20 µPa). |
peakDbL | Estimate | The same peak in dB(L), as the model computed it, so a limit in decibels is read without a round trip. |
scaledDistance | number | The cube-root scaled distance the prediction was made at.> 0 |
validityobligatorio | Validity | How far to trust one output. |
AirblastLaw
A fitted airblast attenuation law on cube-root scaled distance.
| Campo | Tipo | Descripción |
|---|---|---|
scalingobligatorio | "cube_root" | |
kPaobligatorio | number | Site constant in P = K·SD^−β, pascals.> 0 |
betaobligatorio | number | Attenuation exponent β.> 0 |
sigmaLnobligatorio | number | Residual standard deviation in ln(Pa).≥ 0 |
nobligatorio | number | Readings in the fit.> 0 |
fitobligatorio | LawFitStatistics | The least-squares statistics of a log-log fit, for prediction intervals: ln y ± t(p, dof)·σ·√(1 + 1/n + (ln SD − mean)²/sxx). |
scaledDistanceobligatorio | Range | The scaled-distance range the fit was made over. |
sourceobligatorio | enum | platform_fituserprior |
AsBuiltHole
A hole as drilled and loaded. Fields left out are as designed.
| Campo | Tipo | Descripción |
|---|---|---|
idobligatorio | string | The design hole this record amends.longitud mín. 1 · longitud máx. 128 · patrón ^[A-Za-z0-9][A-Za-z0-9._:-]*$ |
collar | Point3 | A position in the case coordinate system, metres. |
toe | Point3 | A position in the case coordinate system, metres. |
waterDepthM | number | Standing water measured at loading, m.≥ 0 |
decks | array de Deck | The hole as loaded, when it differs from the design.mín. 1 elementos · máx. 32 elementos |
BackbreakReading
How far behind some of its holes a fired blast broke the wall it left: the damage a model judging it can be fitted to.
| Campo | Tipo | Descripción |
|---|---|---|
distanceMobligatorio | number | How far behind the holes the final wall broke, m. A model judging damage reads it as a radius about each hole’s charge, square to its axis: for vertical holes, the distance in plan from the line of their collars to the broken crest.≥ 0 |
holeIdsobligatorio | array de string | The holes it was measured behind: the back row for one reading of the blast, or one hole for a reading per hole.mín. 1 elementos · máx. 5000 elementos · cada elemento longitud mín. 1, longitud máx. 128, patrón ^[A-Za-z0-9][A-Za-z0-9._:-]*$ |
method | enum | How it was measured: taped, surveyed, read from a scan, or estimated by eye.tapesurveyscanestimate |
note | string | Anything a reader should know.longitud máx. 500 |
BlobRef
A large payload passed by reference rather than inline: terrain, point clouds, long waveforms.
| Campo | Tipo | Descripción |
|---|---|---|
uriobligatorio | string (uri) | A signed HTTPS URL. It expires; fetch it once when the run starts. |
sha256obligatorio | string | A content hash: sha256: followed by 64 lower-case hex digits.patrón ^sha256:[0-9a-f]{64}$ |
mediaTypeobligatorio | string | IANA media type, for example image/tiff or application/vnd.las.longitud mín. 3 · longitud máx. 120 |
bytes | integer | Size in bytes.≥ 0 |
Calibration
What the site has measured. This is what lets a kinematic model be calibrated rather than assumed.
| Campo | Tipo | Descripción |
|---|---|---|
siteLaw | SiteLaw | A fitted scaled-distance attenuation law. |
airblastLaw | AirblastLaw | A fitted airblast attenuation law on cube-root scaled distance. |
seedWaveforms | array de SeedWaveform | A single-hole ground-motion record: the kinematic input a superposition model is calibrated from.máx. 500 elementos |
vod | array de VodMeasurement | A measured velocity of detonation.máx. 5000 elementos |
outcomes | array de MeasuredOutcome | A reading from an earlier blast at this site.máx. 10000 elementos |
strainAmplitude | StrainAmplitude | The site's fit of the strain a blast puts in its rock near the charges, which a model judging damage scales its amplitude by. |
CancelledRun
Stopped before it finished, by the platform or the provider.
| Campo | Tipo | Descripción |
|---|---|---|
idobligatorio | string | An opaque identifier: letters, digits, ., _, : and -, up to 128 characters.longitud mín. 1 · longitud máx. 128 · patrón ^[A-Za-z0-9][A-Za-z0-9._:-]*$ |
modelIdobligatorio | ModelId | A model identifier in the form vendor/model, lower case, for example shockai/site-law. |
modelVersionobligatorio | string | A semantic version. A result is always pinned to the exact version that produced it.patrón ^\d+\.\d+\.\d+(?:-[0-9A-Za-z.-]+)?$ |
caseIdobligatorio | string | A content hash: sha256: followed by 64 lower-case hex digits.patrón ^sha256:[0-9a-f]{64}$ |
createdAtobligatorio | string (date-time) | An ISO 8601 timestamp in UTC, for example 2026-09-26T04:12:00Z. |
updatedAtobligatorio | string (date-time) | An ISO 8601 timestamp in UTC, for example 2026-09-26T04:12:00Z. |
statusobligatorio | "cancelled" |
Capability
One kind of output a model produces, and what it needs to produce it.
| Campo | Tipo | Descripción |
|---|---|---|
outputobligatorio | OutputKind | A kind of answer: a prediction of what a blast will do, or, for hole_diagnosis and strain_amplitude, a reading of what a fired blast did. |
inputsobligatorio | object | |
inputs.requiredobligatorio | array de InputPath | A part of the BlastCase. The case a model receives is built from the parts it declares and nothing else. design.holes carries the holes and the layout family they form; design.drillingDeviation carries design.drillingDeviationM.mín. 1 elementos |
inputs.requiredAnyOf | array de array de InputPath | Inputs that stand in for one another: the model needs at least one from each group, for example the charge, from the stated MIC or from the holes. A case carrying none of a group is declined with missing_input, as for a missing required input.predeterminado [] · cada elemento mín. 2 elementos |
inputs.optional | array de InputPath | A part of the BlastCase. The case a model receives is built from the parts it declares and nothing else. design.holes carries the holes and the layout family they form; design.drillingDeviation carries design.drillingDeviationM.predeterminado [] |
validity | object | The domain the model is validated on. Outputs outside it must be marked outside or declined. |
validity.distanceM | Range | An inclusive interval. Either bound may be omitted. A range whose min exceeds its max is empty: a model declared valid over one is valid nowhere, and no prediction falls inside a fitted range that is empty. |
validity.scaledDistance | Range | An inclusive interval. Either bound may be omitted. A range whose min exceeds its max is empty: a model declared valid over one is valid nowhere, and no prediction falls inside a fitted range that is empty. |
validity.rockClasses | array de RockClass | Coarse rock class used when no measured properties are available. |
validity.notes | string | longitud máx. 1000 |
CaseUnavailable
A kind answered once for the case that the model declined.
| Campo | Tipo | Descripción |
|---|---|---|
kindobligatorio | enum | ppv_fielddamage_envelopestrain_fieldflyrock_zonefragmentation_curvemovement_fieldtiming_proposalhole_diagnosisstrain_amplitude |
reasonobligatorio | enum | Why the model did not answer.not_supportedmissing_inputoutside_validityinsufficient_calibration |
detail | string | longitud máx. 500 |
Consent
The data owner’s terms for this case. A provider that cannot honour them must refuse the run.
| Campo | Tipo | Descripción |
|---|---|---|
purposeobligatorio | enum | What the owner agreed the case be used for: prediction of what a blast will do, or diagnosis of what a fired blast did, which sends the blast’s own records. A case asks only for the kinds of its purpose.predictiondiagnosis |
retentionobligatorio | enum | How long the provider may keep the case after the run.none30dcontract |
allowTrainingobligatorio | boolean | Whether the provider may use the case to improve its model. False unless the owner opts in. |
CoordinateSystem
The frame every position in the case is expressed in.
Uno de
kind = "epsg"| Campo | Tipo | Descripción |
|---|---|---|
kindobligatorio | "epsg" | |
codeobligatorio | integer | EPSG code of a projected system, for example 28350 (GDA94 / MGA zone 50).> 0 |
kind = "local"| Campo | Tipo | Descripción |
|---|---|---|
kindobligatorio | "local" | |
nameobligatorio | string | The mine grid name.longitud mín. 1 · longitud máx. 120 |
gridBearingDeg | number | Bearing of grid north from true north, degrees clockwise.≥ -360 · ≤ 360 |
origin | object | WGS 84 position of the local origin, when known. |
origin.latitudeobligatorio | number | ≥ -90 · ≤ 90 |
origin.longitudeobligatorio | number | ≥ -180 · ≤ 180 |
DamageEnvelope
The zone around the charges where rock is expected to be damaged: the basis for wall control.
| Campo | Tipo | Descripción |
|---|---|---|
kindobligatorio | "damage_envelope" | |
thresholdMmSobligatorio | number | The PPV taken as the onset of damage for this envelope.> 0 |
criterionobligatorio | string | Name of the damage criterion, for example holmberg-persson, charge-column-integration or hoek-brown-strain.longitud mín. 1 · longitud máx. 120 |
holesobligatorio | array de object | máx. 5000 elementos |
holes[].holeIdobligatorio | string | An opaque identifier: letters, digits, ., _, : and -, up to 128 characters.longitud mín. 1 · longitud máx. 128 · patrón ^[A-Za-z0-9][A-Za-z0-9._:-]*$ |
holes[].radiusMobligatorio | Estimate | Radius from the hole axis at which the threshold is reached. |
surface | BlobRef | The envelope as a closed mesh, when available. |
validityobligatorio | Validity | How far to trust one output. |
Deck
One interval of a hole, collar downwards. Only an explosive deck carries a product and a mass.
Uno de ExplosiveDeck | UnchargedDeck
Design
The blast as designed.
| Campo | Tipo | Descripción |
|---|---|---|
name | string | longitud mín. 1 · longitud máx. 200 |
pattern | enum | Layout family.squarerectangularstaggeredringdevelopmentother |
holesobligatorio | array de DesignHole | Every hole, collar to toe. Empty when the platform holds only a summary of the design, as for a what-if question about a charge at a distance.máx. 5000 elementos |
productsobligatorio | array de Product | An explosive product as loaded.máx. 50 elementos |
initiation | Initiation | Omitted when the platform holds only a summary of the design. |
maxInstantaneousCharge | MaxInstantaneousCharge | The maximum instantaneous charge (MIC) as the platform computed it for compliance. A model that works from the charge rather than from every hole should use it; one that models the holes may recompute it. |
drillingDeviationM | number | One standard deviation of collar and drilling error, m (Cunningham’s W): what fragmentation uniformity loses to imperfect drilling.≥ 0 |
DesignHole
A hole as designed.
| Campo | Tipo | Descripción |
|---|---|---|
idobligatorio | string | An opaque identifier: letters, digits, ., _, : and -, up to 128 characters.longitud mín. 1 · longitud máx. 128 · patrón ^[A-Za-z0-9][A-Za-z0-9._:-]*$ |
row | integer | > 0 |
column | integer | > 0 |
collarobligatorio | Point3 | A position in the case coordinate system, metres. |
toeobligatorio | Point3 | A position in the case coordinate system, metres. |
diameterMm | number | Hole diameter, mm. Left out when the plan does not state it.> 0 · ≤ 2000 |
domainId | string | The rock domain the hole sits in.longitud mín. 1 · longitud máx. 128 · patrón ^[A-Za-z0-9][A-Za-z0-9._:-]*$ |
burdenM | number | Burden this hole breaks, m.> 0 |
spacingM | number | Spacing to its neighbour in the row, m.> 0 |
subdrillM | number | Drilled length below grade, m. |
decksobligatorio | array de Deck | The hole from collar to toe. Stemming is a deck like any other.mín. 1 elementos · máx. 32 elementos |
delayobligatorio | HoleDelay | When a hole is designed to fire. |
DiagnosedHole
One hole’s diagnosis.
| Campo | Tipo | Descripción |
|---|---|---|
holeIdobligatorio | string | The design hole.longitud mín. 1 · longitud máx. 128 · patrón ^[A-Za-z0-9][A-Za-z0-9._:-]*$ |
verdictobligatorio | HoleVerdict | What became of a hole. on_time, late and early: it fired, within the model’s timing limit of its designed time, after it, or before it. not_detected: no motion of its own was found, so it is taken not to have fired. weak and strong: it fired, and its ground motion was well below or well above the blast’s typical hole. unrelieved: it fired confined, with no relief to break to; reserved for a model that can tell, and the platform’s own does not give it. unresolved: the records cannot tell it from the holes in resolvedWith. A verdict claims only what it names: a hole on time may also be weak, which size says. |
confidenceobligatorio | number | The model’s probability that the verdict is right, about what the verdict claims and nothing more: for on_time, late and early, that the hole fired and when; for weak and strong, its size; for not_detected, that it did not fire.≥ 0 · ≤ 1 |
alternatives | array de object | The other verdicts the model weighed, likeliest first. Each is a claim of its own, so with the verdict’s they need not sum to one.máx. 8 elementos |
alternatives[].verdictobligatorio | HoleVerdict | What became of a hole. on_time, late and early: it fired, within the model’s timing limit of its designed time, after it, or before it. not_detected: no motion of its own was found, so it is taken not to have fired. weak and strong: it fired, and its ground motion was well below or well above the blast’s typical hole. unrelieved: it fired confined, with no relief to break to; reserved for a model that can tell, and the platform’s own does not give it. unresolved: the records cannot tell it from the holes in resolvedWith. A verdict claims only what it names: a hole on time may also be weak, which size says. |
alternatives[].confidenceobligatorio | number | ≥ 0 · ≤ 1 |
timing | object | When the hole fired. Left out for a hole not detected. |
timing.offsetMsobligatorio | number | The firing time the model found less the design hole’s delay.totalMs, ms. |
timing.sigmaMs | number | One standard deviation of that time, ms.≥ 0 |
size | object | How big the hole was. Left out for a hole not detected. |
size.relativeobligatorio | number | Its ground motion over the blast’s typical hole’s: 1 is typical.≥ 0 |
size.sigmaLn | number | One standard deviation of ln(relative).≥ 0 |
size.call | object | The size as a claim of its own, where the records resolve sizes. A weak or strong verdict makes the same call. |
size.call.valueobligatorio | enum | weaktypicalstrong |
size.call.confidenceobligatorio | number | The model’s probability that the call is right.≥ 0 · ≤ 1 |
confinement | object | How much shear the hole carried, which is what confinement shows as. Only where a record’s heading is known. |
confinement.relativeobligatorio | number | Its shear over its compression (motion across the ray over motion along it) against the blast’s typical hole: 1 is typical.≥ 0 |
confinement.sigmaLn | number | ≥ 0 |
clarityDb | number | The hole’s motion over the noise at its clearest record, dB. |
dominantFrequencyHz | number | > 0 |
resolvedWith | array de string | The other design holes the records cannot tell this one from: they fired too close together for any record to separate.máx. 5000 elementos · cada elemento longitud mín. 1, longitud máx. 128, patrón ^[A-Za-z0-9][A-Za-z0-9._:-]*$ |
flags | array de string | What a reader should know about this hole’s answer, as stable codes. Reserved: heading_unknown, no record that heard it has a known heading; det_log_disagrees, the firing record says it did not fire and the records say it did; low_snr, it is barely above the noise; clipped_samples, a record that heard it was clipped; window_truncated, the record ends before its motion does; no_plan_time, the design gives it no firing time.máx. 20 elementos · cada elemento longitud máx. 80, patrón ^[a-z][a-z0-9_.-]*$ |
evidence | HoleEvidence | The working behind a verdict: the ground motion the model attributes to this hole alone, so a reader can see what it rests on. |
Ed25519Jwk
An Ed25519 public key as an RFC 8037 JWK. Publish only the public half: the platform refuses a manifest whose key carries its private part (d).
| Campo | Tipo | Descripción |
|---|---|---|
ktyobligatorio | "OKP" | |
crvobligatorio | "Ed25519" | |
xobligatorio | string | The 32-byte public key, base64url without padding.longitud mín. 43 · longitud máx. 43 · patrón ^[A-Za-z0-9_-]+$ |
kid | string | Ignored: the key id is always the RFC 7638 thumbprint.longitud mín. 1 · longitud máx. 128 |
use | "sig" | |
alg | "EdDSA" |
Estimate
A predicted quantity with its uncertainty. A point value with no spread is allowed but a spread is expected: a prediction without one cannot be scored for coverage.
| Campo | Tipo | Descripción |
|---|---|---|
medianobligatorio | number | The best estimate (P50). |
percentiles | array de object | Further points on the predictive distribution, usually those the request asked for.máx. 99 elementos |
percentiles[].pobligatorio | number | Percentile, 0 to 100.≥ 0 · ≤ 100 |
percentiles[].valueobligatorio | number | The value at that percentile, in the unit of the parent quantity. |
ensemble | array de number | Raw ensemble members, for providers that sample rather than summarise.máx. 10000 elementos |
ExplosiveDeck
An interval of a hole loaded with explosive.
| Campo | Tipo | Descripción |
|---|---|---|
kindobligatorio | "explosive" | |
topDepthMobligatorio | number | Depth of the top of the deck along the hole, from the collar.≥ 0 |
bottomDepthMobligatorio | number | Depth of the bottom of the deck along the hole.≥ 0 |
productIdobligatorio | string | The product loaded.longitud mín. 1 · longitud máx. 128 · patrón ^[A-Za-z0-9][A-Za-z0-9._:-]*$ |
massKgobligatorio | number | Charge mass.≥ 0 |
FailedRun
Finished without a result, and why.
| Campo | Tipo | Descripción |
|---|---|---|
idobligatorio | string | An opaque identifier: letters, digits, ., _, : and -, up to 128 characters.longitud mín. 1 · longitud máx. 128 · patrón ^[A-Za-z0-9][A-Za-z0-9._:-]*$ |
modelIdobligatorio | ModelId | A model identifier in the form vendor/model, lower case, for example shockai/site-law. |
modelVersionobligatorio | string | A semantic version. A result is always pinned to the exact version that produced it.patrón ^\d+\.\d+\.\d+(?:-[0-9A-Za-z.-]+)?$ |
caseIdobligatorio | string | A content hash: sha256: followed by 64 lower-case hex digits.patrón ^sha256:[0-9a-f]{64}$ |
createdAtobligatorio | string (date-time) | An ISO 8601 timestamp in UTC, for example 2026-09-26T04:12:00Z. |
updatedAtobligatorio | string (date-time) | An ISO 8601 timestamp in UTC, for example 2026-09-26T04:12:00Z. |
statusobligatorio | "failed" | |
errorobligatorio | object | |
error.typeobligatorio | enum | The error family. unsupported_case and consent_refused are final; rate_limited, provider_error and timeout may be retried.invalid_requestunsupported_caseconsent_refusedauthenticationrate_limitedquote_expiredprovider_errortimeout |
error.codeobligatorio | string | A stable machine-readable code within the family.longitud máx. 80 · patrón ^[a-z][a-z0-9_]*$ |
error.messageobligatorio | string | longitud mín. 1 · longitud máx. 1000 |
error.param | string | The case field at fault, as a JSON Pointer.longitud máx. 200 |
FiringRecord
What actually fired, and when.
| Campo | Tipo | Descripción |
|---|---|---|
sourceobligatorio | enum | Where the firing times come from: a detonator log, an imported timing file, or the design itself.det_logtiming_importdesign |
firedAt | string (date-time) | Wall-clock time of T0. |
holesobligatorio | array de object | máx. 5000 elementos |
holes[].idobligatorio | string | An opaque identifier: letters, digits, ., _, : and -, up to 128 characters.longitud mín. 1 · longitud máx. 128 · patrón ^[A-Za-z0-9][A-Za-z0-9._:-]*$ |
holes[].firedMsobligatorio | number | null | Measured firing time from T0, ms; null when the hole did not fire. |
holes[].statusobligatorio | enum | firedmisfirecutoffunknown |
FlyrockZone
Predicted flyrock range and clearance.
| Campo | Tipo | Descripción |
|---|---|---|
kindobligatorio | "flyrock_zone" | |
maxThrowMobligatorio | Estimate | Maximum expected throw, m. |
mechanismobligatorio | enum | face_burstcrateringriflingcombined |
clearance | object | Recommended clearance distances. |
clearance.personnelMobligatorio | number | > 0 |
clearance.equipmentMobligatorio | number | > 0 |
holes | array de object | máx. 5000 elementos |
holes[].holeIdobligatorio | string | An opaque identifier: letters, digits, ., _, : and -, up to 128 characters.longitud mín. 1 · longitud máx. 128 · patrón ^[A-Za-z0-9][A-Za-z0-9._:-]*$ |
holes[].maxThrowMobligatorio | number | ≥ 0 |
holes[].faceBurstM | number | How far the face would throw rock out through the hole’s burden, m.≥ 0 |
holes[].crateringM | number | How far the hole’s stemming and the rock over its charge would be thrown if they blew out, m. Whether they do is not this figure: the hole’s confinement says that.≥ 0 |
holes[].stemmingM | number | The stemming the hole was read at, m: as loaded where the case’s as-built record states the hole’s decks, else as designed.≥ 0 |
holes[].stemmingAsLoaded | boolean | True where stemmingM is the as-built record’s. |
validityobligatorio | Validity | How far to trust one output. |
FragmentationCurve
Predicted size distribution of the broken rock.
| Campo | Tipo | Descripción |
|---|---|---|
kindobligatorio | "fragmentation_curve" | |
domainId | string | An opaque identifier: letters, digits, ., _, : and -, up to 128 characters.longitud mín. 1 · longitud máx. 128 · patrón ^[A-Za-z0-9][A-Za-z0-9._:-]*$ |
curveobligatorio | array de object | The curve, by ascending sieve size.mín. 2 elementos · máx. 200 elementos |
curve[].sizeMmobligatorio | number | Sieve size, mm.> 0 |
curve[].passingPercentobligatorio | number | Percent of the rock passing that size.≥ 0 · ≤ 100 |
x50Mmobligatorio | Estimate | A predicted quantity with its uncertainty. A point value with no spread is allowed but a spread is expected: a prediction without one cannot be scored for coverage. |
x80Mmobligatorio | Estimate | A predicted quantity with its uncertainty. A point value with no spread is allowed but a spread is expected: a prediction without one cannot be scored for coverage. |
uniformityIndex | number | ≥ 0 |
validityobligatorio | Validity | How far to trust one output. |
FrequencyBin
One band of log10(scaled distance) and the median dominant frequency the site recorded in it.
| Campo | Tipo | Descripción |
|---|---|---|
log10SdMinobligatorio | number | |
log10SdMaxobligatorio | number | |
medianHzobligatorio | number | Median dominant frequency of the readings in the band, Hz.> 0 |
countobligatorio | integer | > 0 |
Grid
A plan-view grid for field outputs. A field’s values sit at the nodes minX + i·cellM, minY + j·cellM for i below its columns and j below its rows, the last node within a cell of maxX and maxY; a reader takes columns and rows from the output and never recomputes them.
| Campo | Tipo | Descripción |
|---|---|---|
minXobligatorio | number | |
minYobligatorio | number | |
maxXobligatorio | number | |
maxYobligatorio | number | |
cellMobligatorio | number | Cell size, m.> 0 |
elevationobligatorio | enum | Where grid points sit vertically.terraincollar_plane |
HoleDelay
When a hole is designed to fire.
| Campo | Tipo | Descripción |
|---|---|---|
totalMsobligatorio | number | Designed firing time from T0, milliseconds. |
surfaceMs | number | Delay carried by the surface connector.≥ 0 |
downholeMs | number | Delay of the in-hole unit.≥ 0 |
tieInFrom | string | The hole this one receives its signal from on the surface tie-in.longitud mín. 1 · longitud máx. 128 · patrón ^[A-Za-z0-9][A-Za-z0-9._:-]*$ |
HoleDiagnosis
What each hole of a fired blast did, read from the blast’s own ground-motion records and its firing record.
| Campo | Tipo | Descripción |
|---|---|---|
kindobligatorio | "hole_diagnosis" | |
holesobligatorio | array de DiagnosedHole | Every design hole with an explosive deck, once each.máx. 5000 elementos |
records | array de object | What became of each record the model was given.máx. 64 elementos |
records[].recordIdobligatorio | string | An opaque identifier: letters, digits, ., _, : and -, up to 128 characters.longitud mín. 1 · longitud máx. 128 · patrón ^[A-Za-z0-9][A-Za-z0-9._:-]*$ |
records[].useobligatorio | enum | What the model did with the record: read it; set it aside as unable to tell the holes apart; or skipped it unread, for example beyond the number of records it reads, or at a receiver with no position.readset_asideskipped |
records[].residualFraction | number | For a record read: the energy left in it once every hole’s motion is taken out, over what was there.≥ 0 |
validityobligatorio | Validity | How far to trust one output. |
HoleEvidence
The working behind a verdict: the ground motion the model attributes to this hole alone, so a reader can see what it rests on.
| Campo | Tipo | Descripción |
|---|---|---|
recordIdobligatorio | string | The record of measured.records the motion is modelled on: the one that heard the hole most clearly.longitud mín. 1 · longitud máx. 128 · patrón ^[A-Za-z0-9][A-Za-z0-9._:-]*$ |
sampleRateHzobligatorio | number | The rate of the rows, which is the model’s own and need not be the record’s.> 0 |
startMsobligatorio | number | Time of the first row from T0, ms, as the model aligned the record. |
samplesobligatorio | array de [3 × number] | The hole’s own motion at that record, one [a, b, c] row per sample on the record’s axes, mm/s. At most a second or so: enough to draw.máx. 8192 elementos |
HoleVerdict
What became of a hole. on_time, late and early: it fired, within the model’s timing limit of its designed time, after it, or before it. not_detected: no motion of its own was found, so it is taken not to have fired. weak and strong: it fired, and its ground motion was well below or well above the blast’s typical hole. unrelieved: it fired confined, with no relief to break to; reserved for a model that can tell, and the platform’s own does not give it. unresolved: the records cannot tell it from the holes in resolvedWith. A verdict claims only what it names: a hole on time may also be weak, which size says.
on_timelateearlynot_detectedweakstrongunrelievedunresolvedImportedOutput
One prediction made elsewhere, discriminated by kind: every kind a prediction case asks.
Uno de ReceiverPpv | MaxCharge | ReceiverWaveform | ReceiverSpectrum | PpvField | Airblast | DamageEnvelope | StrainField | FlyrockZone | FragmentationCurve | MovementField | TimingProposal
Initiation
How the blast is initiated.
| Campo | Tipo | Descripción |
|---|---|---|
systemobligatorio | InitiationSystem | The detonator technology. It sets the delay scatter a model should assume when none is given. |
delayScatter | object | One standard deviation of detonator timing error: a fixed part plus a percentage of the nominal delay. |
delayScatter.fixedMs | number | ≥ 0 |
delayScatter.percent | number | ≥ 0 |
InitiationSystem
The detonator technology. It sets the delay scatter a model should assume when none is given.
electronicnonelelectricdetonating_cordInputPath
A part of the BlastCase. The case a model receives is built from the parts it declares and nothing else. design.holes carries the holes and the layout family they form; design.drillingDeviation carries design.drillingDeviationM.
design.holesdesign.productsdesign.initiationdesign.maxInstantaneousChargedesign.drillingDeviationasBuilt.holesasBuilt.firingsite.domainssite.terrainreceiverscalibration.siteLawcalibration.airblastLawcalibration.seedWaveformscalibration.vodcalibration.outcomescalibration.strainAmplitudemeasured.recordsmeasured.backbreakLawFitStatistics
The least-squares statistics of a log-log fit, for prediction intervals: ln y ± t(p, dof)·σ·√(1 + 1/n + (ln SD − mean)²/sxx).
| Campo | Tipo | Descripción |
|---|---|---|
dofobligatorio | number | Residual degrees of freedom of the fit.> 0 |
meanLnScaledDistanceobligatorio | number | Mean of ln(scaled distance) over the readings. |
sxxobligatorio | number | null | Σ(ln SD − mean)² over the readings. Null when only the law’s summary is known; intervals then leave out the leverage term.> 0 |
MaxCharge
The inverse question: how much charge per delay a receiver’s limit allows. The design value blasters plan with.
| Campo | Tipo | Descripción |
|---|---|---|
kindobligatorio | "max_charge" | |
receiverIdobligatorio | string | An opaque identifier: letters, digits, ., _, : and -, up to 128 characters.longitud mín. 1 · longitud máx. 128 · patrón ^[A-Za-z0-9][A-Za-z0-9._:-]*$ |
limitMmSobligatorio | number | The PPV limit the charge was held to: the receiver’s own limit.> 0 |
percentileobligatorio | number | The percentile the limit was read at.≥ 50 · ≤ 99.9 |
maxChargeKgobligatorio | number | null | The largest maximum instantaneous charge whose prediction at that percentile stays at or under the limit. Null when even a token charge exceeds it.> 0 |
scaledDistance | number | The scaled distance at that charge.> 0 |
validityobligatorio | Validity | How far to trust one output. |
MaxInstantaneousCharge
The maximum instantaneous charge (MIC) as the platform computed it for compliance. A model that works from the charge rather than from every hole should use it; one that models the holes may recompute it.
| Campo | Tipo | Descripción |
|---|---|---|
massKgobligatorio | number | The largest charge detonating inside any one window, kg.> 0 |
windowMsobligatorio | number | The window, ms. Jurisdictions set it; 8 ms is common.> 0 |
Measured
What was measured of this blast itself, once it has fired. calibration holds what earlier blasts taught the site; this holds the blast in question.
| Campo | Tipo | Descripción |
|---|---|---|
records | array de MeasuredRecord | A ground-motion record of this blast, as a monitor wrote it. Its time against T0 is not known: a recorder starts on the motion reaching it, and its clock is not the initiation system’s. A model that needs the two aligned finds the alignment itself.máx. 64 elementos |
backbreak | array de BackbreakReading | How far behind its holes the blast broke the wall, once it was seen.máx. 5000 elementos |
MeasuredOutcome
A reading from an earlier blast at this site.
| Campo | Tipo | Descripción |
|---|---|---|
blastRefobligatorio | string | Which earlier blast this came from.longitud mín. 1 · longitud máx. 200 |
receiverIdobligatorio | string | An opaque identifier: letters, digits, ., _, : and -, up to 128 characters.longitud mín. 1 · longitud máx. 128 · patrón ^[A-Za-z0-9][A-Za-z0-9._:-]*$ |
distanceM | number | > 0 |
micKg | number | Maximum instantaneous charge of that blast, kg.> 0 |
ppvMmS | number | ≥ 0 |
basis | PpvBasis | How peak particle velocity is taken: the largest single component (max_axis) or the peak vector sum (pvs). |
dominantFrequencyHz | number | > 0 |
airblastDbL | number | ≥ 0 |
MeasuredRecord
A ground-motion record of this blast, as a monitor wrote it. Its time against T0 is not known: a recorder starts on the motion reaching it, and its clock is not the initiation system’s. A model that needs the two aligned finds the alignment itself.
| Campo | Tipo | Descripción |
|---|---|---|
idobligatorio | string | An opaque identifier: letters, digits, ., _, : and -, up to 128 characters.longitud mín. 1 · longitud máx. 128 · patrón ^[A-Za-z0-9][A-Za-z0-9._:-]*$ |
receiverIdobligatorio | string | The receiver it was recorded at. That receiver carries a position, with or without an elevation: a record with no place on the grid tells a model nothing about which hole it heard.longitud mín. 1 · longitud máx. 128 · patrón ^[A-Za-z0-9][A-Za-z0-9._:-]*$ |
sampleRateHzobligatorio | number | > 0 |
axesobligatorio | enum | How the rows’ three components lie. recorded: as the unit wrote them, with nothing known of how it lay. levelled: turned so the third component is vertical, up positive, and the first two lie in the level plane on an unknown bearing. oriented: levelled, with the first component along headingDeg and the second a quarter turn clockwise of it seen from above.recordedlevelledoriented |
headingDeg | number | Bearing of the first component, degrees clockwise from grid north. Given for oriented axes only.≥ 0 · ≤ 360 |
quietUntilIndexobligatorio | integer | The rows before this index were recorded before the blast’s motion arrived: what a model measures the noise from.≥ 0 |
dominantFrequencyHz | number | Dominant frequency of the record, Hz, as the platform’s analysis found it.> 0 |
clipMmS | number | The recorder’s full scale, mm/s. A sample at it was clipped.> 0 |
recordedAt | string (date-time) | Wall-clock time of the first row, by the recorder’s own clock. |
samplesobligatorio | ParticleVelocity | Three-component particle velocity, mm/s: one [a, b, c] row per sample in frame order, so every component has the same length; or a reference to the same rows. |
ModelId
A model identifier in the form vendor/model, lower case, for example shockai/site-law.
stringlongitud mín. 3 · longitud máx. 128 · patrón ^[a-z0-9][a-z0-9-]*\/[a-z0-9][a-z0-9.-]*$
ModelMethod
The family of method, so a user can tell a fitted law from a simulation.
empiricalkinematicnumericalstatisticalhybridMovementField
Predicted displacement of the burden, and the muckpile it forms.
| Campo | Tipo | Descripción |
|---|---|---|
kindobligatorio | "movement_field" | |
pointsobligatorio | array de object | máx. 50000 elementos |
points[].idobligatorio | string | Names the point within this field.longitud mín. 1 · longitud máx. 128 · patrón ^[A-Za-z0-9][A-Za-z0-9._:-]*$ |
points[].fromobligatorio | Point3 | A position in the case coordinate system, metres. |
points[].toobligatorio | Point3 | A position in the case coordinate system, metres. |
points[].flight | object | When the point moves. Without a touchdown, a viewer may draw it as an arc under gravity that joins from and to in that time; the model’s own path may differ, such as a block that rolls after it lands. Left out, only the displacement is stated. |
points[].flight.launchMsobligatorio | number | When the point leaves from, milliseconds from T0. |
points[].flight.durationMsobligatorio | number | How long it then takes to come to rest at to, milliseconds.≥ 0 |
points[].flight.touchdown | object | Where the point first comes down on something, or the rock round it closes on it: the end of its flight through the air, before it rolls, slides, slumps or drops to to, or is carried up to it. The arc under gravity that joins from and at in afterMs is the model’s own flight; from there the point moves to to, arriving at durationMs. Left out, the flight is not told apart from what follows it. |
points[].flight.touchdown.atobligatorio | Point3 | A position in the case coordinate system, metres. |
points[].flight.touchdown.afterMsobligatorio | number | When it gets there, milliseconds after it leaves from: never after durationMs.≥ 0 |
points[].source | object | The point as a source for a model of the broken rock’s surface, a flow over the ground the blast empties: how much rock, how heavy, the momentum it starts with and whether the mass carries it. A field that states sources states one for every point with a flight (conformance holds it to that). Left out, a viewer infers the flow from where the points rest. |
points[].source.volumeM3obligatorio | number | The rock the point stands for as it stood in the bench, m³: in situ, before any swell.> 0 |
points[].source.massKgobligatorio | number | That rock’s mass, kg.> 0 |
points[].source.momentumobligatorio | object | The level momentum the rock leaves from with at flight.launchMs, kg·m/s, once whatever confines or relieves it has taken its share: what a flow of the broken rock over the ground starts with. Its vertical part is not stated; the flight is. |
points[].source.momentum.xobligatorio | number | Eastward, kg·m/s. |
points[].source.momentum.yobligatorio | number | Northward, kg·m/s. |
points[].source.carriedobligatorio | boolean | True where the mass carries the rock: it rides the burden as its cover (a model may hold the stemming above the charge so wherever it comes down), or it comes down and rests over the ground the blast breaks or the bench round it. False where it is thrown clear, out through the free face onto the floor in front, a piece of its own. |
muckpileSurface | BlobRef | The predicted muckpile surface. |
validityobligatorio | Validity | How far to trust one output. |
Output
One answer, discriminated by kind.
Uno de ReceiverPpv | MaxCharge | ReceiverWaveform | ReceiverSpectrum | PpvField | Airblast | DamageEnvelope | StrainField | FlyrockZone | FragmentationCurve | MovementField | TimingProposal | HoleDiagnosis | StrainAmplitudeFit
OutputKind
A kind of answer: a prediction of what a blast will do, or, for hole_diagnosis and strain_amplitude, a reading of what a fired blast did.
receiver_ppvmax_chargereceiver_waveformreceiver_spectrumppv_fieldairblastdamage_envelopestrain_fieldflyrock_zonefragmentation_curvemovement_fieldtiming_proposalhole_diagnosisstrain_amplitudeOutputRequest
The question the case asks.
| Campo | Tipo | Descripción |
|---|---|---|
outputsobligatorio | array de OutputKind | What the caller wants back.mín. 1 elementos |
receiverIds | array de string | Receivers to predict at; all receivers when omitted.cada elemento longitud mín. 1, longitud máx. 128, patrón ^[A-Za-z0-9][A-Za-z0-9._:-]*$ |
grid | Grid | A plan-view grid for field outputs. A field’s values sit at the nodes minX + i·cellM, minY + j·cellM for i below its columns and j below its rows, the last node within a cell of maxX and maxY; a reader takes columns and rows from the output and never recomputes them. |
percentiles | array de number | Points of the predictive distribution to report. 50 and 95 when omitted.máx. 20 elementos · predeterminado [50,95] · cada elemento ≥ 0, ≤ 100 |
designPercentile | number | The percentile design values are read at: a charge limit is the largest charge whose prediction at this percentile stays under the limit. 95 when omitted.≥ 50 · ≤ 99.9 · predeterminado 95 |
seed | integer | Seed for any sampling, so a run can be reproduced exactly.≥ 0 |
ParticleVelocity
Three-component particle velocity, mm/s: one [a, b, c] row per sample in frame order, so every component has the same length; or a reference to the same rows.
Uno de
[a, b, c] in frame order, mm/s.Point3
A position in the case coordinate system, metres.
| Campo | Tipo | Descripción |
|---|---|---|
xobligatorio | number | Easting, metres. |
yobligatorio | number | Northing, metres. |
zobligatorio | number | Elevation, metres. Up is positive. |
PpvBasis
How peak particle velocity is taken: the largest single component (max_axis) or the peak vector sum (pvs).
max_axispvsPpvField
Peak particle velocity over a plan-view grid, at one percentile.
| Campo | Tipo | Descripción |
|---|---|---|
kindobligatorio | "ppv_field" | |
gridobligatorio | Grid | A plan-view grid for field outputs. A field’s values sit at the nodes minX + i·cellM, minY + j·cellM for i below its columns and j below its rows, the last node within a cell of maxX and maxY; a reader takes columns and rows from the output and never recomputes them. |
percentileobligatorio | number | ≥ 0 · ≤ 100 |
basisobligatorio | PpvBasis | How peak particle velocity is taken: the largest single component (max_axis) or the peak vector sum (pvs). |
columnsobligatorio | integer | Nodes along x: ⌊(maxX − minX) / cellM⌋ + 1.> 0 |
rowsobligatorio | integer | Nodes along y: ⌊(maxY − minY) / cellM⌋ + 1.> 0 |
valuesMmSobligatorio | array de (number | null) | BlobRef | Row-major from the south-west corner; null where the model declines to predict.máx. 4000000 elementos · cada elemento ≥ 0 |
validityobligatorio | Validity | How far to trust one output. |
Product
An explosive product as loaded.
| Campo | Tipo | Descripción |
|---|---|---|
idobligatorio | string | An opaque identifier: letters, digits, ., _, : and -, up to 128 characters.longitud mín. 1 · longitud máx. 128 · patrón ^[A-Za-z0-9][A-Za-z0-9._:-]*$ |
nameobligatorio | string | longitud mín. 1 · longitud máx. 120 |
classobligatorio | enum | Product family.anfoheavy_anfoemulsionwatergelpackagedboosterother |
densityGcc | number | In-hole density, g/cm³.> 0 · ≤ 3 |
relativeWeightStrength | number | Relative weight strength, ANFO = 100.> 0 |
energyMjKg | number | Rated energy, MJ/kg.> 0 |
nominalVodMs | number | Nominal velocity of detonation, m/s.> 0 |
Provenance
Where a result came from. Reports cite it; the platform uses it to score the model later.
| Campo | Tipo | Descripción |
|---|---|---|
modelIdobligatorio | ModelId | A model identifier in the form vendor/model, lower case, for example shockai/site-law. |
modelVersionobligatorio | string | A semantic version. A result is always pinned to the exact version that produced it.patrón ^\d+\.\d+\.\d+(?:-[0-9A-Za-z.-]+)?$ |
caseIdobligatorio | string | A content hash: sha256: followed by 64 lower-case hex digits.patrón ^sha256:[0-9a-f]{64}$ |
startedAtobligatorio | string (date-time) | An ISO 8601 timestamp in UTC, for example 2026-09-26T04:12:00Z. |
finishedAtobligatorio | string (date-time) | An ISO 8601 timestamp in UTC, for example 2026-09-26T04:12:00Z. |
inputsUsedobligatorio | array de InputPath | Which parts of the case the model actually read, as input paths.máx. 50 elementos |
parameters | mapa de (string | number | boolean) | Any parameters the model fitted or chose, so the result can be explained. |
buildHash | string | The build that answered, as the manifest's build.hash names it.longitud mín. 1 · longitud máx. 128 · patrón ^[A-Za-z0-9._:+/@-]+$ |
QueuedRun
Accepted and waiting to start.
| Campo | Tipo | Descripción |
|---|---|---|
idobligatorio | string | An opaque identifier: letters, digits, ., _, : and -, up to 128 characters.longitud mín. 1 · longitud máx. 128 · patrón ^[A-Za-z0-9][A-Za-z0-9._:-]*$ |
modelIdobligatorio | ModelId | A model identifier in the form vendor/model, lower case, for example shockai/site-law. |
modelVersionobligatorio | string | A semantic version. A result is always pinned to the exact version that produced it.patrón ^\d+\.\d+\.\d+(?:-[0-9A-Za-z.-]+)?$ |
caseIdobligatorio | string | A content hash: sha256: followed by 64 lower-case hex digits.patrón ^sha256:[0-9a-f]{64}$ |
createdAtobligatorio | string (date-time) | An ISO 8601 timestamp in UTC, for example 2026-09-26T04:12:00Z. |
updatedAtobligatorio | string (date-time) | An ISO 8601 timestamp in UTC, for example 2026-09-26T04:12:00Z. |
statusobligatorio | "queued" | |
progress | number | Fraction complete, for display only.≥ 0 · ≤ 1 |
Range
An inclusive interval. Either bound may be omitted. A range whose min exceeds its max is empty: a model declared valid over one is valid nowhere, and no prediction falls inside a fitted range that is empty.
| Campo | Tipo | Descripción |
|---|---|---|
min | number | |
max | number |
Receiver
A place a prediction is wanted. It has a position, a resolved distance, or both.
Requiere al menos uno de position, distanceM
| Campo | Tipo | Descripción |
|---|---|---|
idobligatorio | string | An opaque identifier: letters, digits, ., _, : and -, up to 128 characters.longitud mín. 1 · longitud máx. 128 · patrón ^[A-Za-z0-9][A-Za-z0-9._:-]*$ |
name | string | longitud mín. 1 · longitud máx. 200 |
kindobligatorio | enum | A seismograph location, a structure to protect, a lease or property boundary point, or any point of interest.monitorstructureboundarypoint |
position | SurfacePosition | Where the receiver is. Omitted when only its distance is known. A monitor placed on a plan often has no surveyed height: its z is then left out. |
distanceM | number | The source-to-receiver distance the platform resolved: a surveyed or entered distance, or the slant distance to the nearest charge. A model should use it unless it models the geometry itself.> 0 |
distanceSource | string | Where distanceM came from, for example manual, placement or georeference.longitud mín. 1 · longitud máx. 40 |
limits | object | The limits that apply here: a model reports exceedance probability against them, and a charge limit is held to the PPV limit. |
limits.ppvMmS | number | > 0 |
limits.airblastDbL | number | > 0 |
limits.standard | string | The standard the limit comes from, for example AS 2187.2.longitud máx. 120 |
ReceiverPpv
Predicted peak particle velocity at a receiver.
| Campo | Tipo | Descripción |
|---|---|---|
kindobligatorio | "receiver_ppv" | |
receiverIdobligatorio | string | An opaque identifier: letters, digits, ., _, : and -, up to 128 characters.longitud mín. 1 · longitud máx. 128 · patrón ^[A-Za-z0-9][A-Za-z0-9._:-]*$ |
basisobligatorio | PpvBasis | How peak particle velocity is taken: the largest single component (max_axis) or the peak vector sum (pvs). |
ppvMmSobligatorio | Estimate | Peak particle velocity, mm/s. |
dominantFrequencyHz | Estimate | Frequency at the peak, Hz. |
scaledDistance | number | The scaled distance the prediction was made at.> 0 |
exceedanceProbability | number | Probability of exceeding the receiver’s PPV limit, when it has one.≥ 0 · ≤ 1 |
validityobligatorio | Validity | How far to trust one output. |
ReceiverSpectrum
A predicted amplitude spectrum at a receiver.
| Campo | Tipo | Descripción |
|---|---|---|
kindobligatorio | "receiver_spectrum" | |
receiverIdobligatorio | string | An opaque identifier: letters, digits, ., _, : and -, up to 128 characters.longitud mín. 1 · longitud máx. 128 · patrón ^[A-Za-z0-9][A-Za-z0-9._:-]*$ |
spectrumobligatorio | array de object | The spectrum, by ascending frequency.máx. 10000 elementos |
spectrum[].frequencyHzobligatorio | number | > 0 |
spectrum[].amplitudeobligatorio | number | Fourier amplitude, mm/s·s.≥ 0 |
validityobligatorio | Validity | How far to trust one output. |
ReceiverUnavailable
A kind answered per receiver that the model declined, at one receiver or at all of them.
| Campo | Tipo | Descripción |
|---|---|---|
kindobligatorio | enum | receiver_ppvmax_chargereceiver_waveformreceiver_spectrumairblast |
receiverIdobligatorio | string | null | The receiver the model declined at, or null when it declines the kind at every receiver (for example, the case names none).longitud mín. 1 · longitud máx. 128 · patrón ^[A-Za-z0-9][A-Za-z0-9._:-]*$ |
reasonobligatorio | enum | Why the model did not answer.not_supportedmissing_inputoutside_validityinsufficient_calibration |
detail | string | longitud máx. 500 |
ReceiverWaveform
A predicted ground-motion time history at a receiver.
| Campo | Tipo | Descripción |
|---|---|---|
kindobligatorio | "receiver_waveform" | |
receiverIdobligatorio | string | An opaque identifier: letters, digits, ., _, : and -, up to 128 characters.longitud mín. 1 · longitud máx. 128 · patrón ^[A-Za-z0-9][A-Za-z0-9._:-]*$ |
percentile | number | Which member of the distribution this trace represents, when the model samples.≥ 0 · ≤ 100 |
sampleRateHzobligatorio | number | > 0 |
startMsobligatorio | number | Time of the first sample from T0, ms. |
frameobligatorio | enum | xyztvl |
samplesobligatorio | ParticleVelocity | Three-component particle velocity, mm/s: one [a, b, c] row per sample in frame order, so every component has the same length; or a reference to the same rows. |
validityobligatorio | Validity | How far to trust one output. |
RockClass
Coarse rock class used when no measured properties are available.
super_softsoftmediumhardRockDomain
A zone of rock the site treats as one material. Holes name the domain they sit in.
| Campo | Tipo | Descripción |
|---|---|---|
idobligatorio | string | An opaque identifier: letters, digits, ., _, : and -, up to 128 characters.longitud mín. 1 · longitud máx. 128 · patrón ^[A-Za-z0-9][A-Za-z0-9._:-]*$ |
name | string | longitud mín. 1 · longitud máx. 120 |
rockClass | RockClass | Coarse class when nothing better is known. |
densityKgM3 | number | In-situ density, kg/m³.> 0 |
ucsMPa | number | Uniaxial compressive strength, MPa.> 0 |
youngsModulusGPa | number | Young's modulus, GPa.> 0 |
hoekBrownMi | number | Hoek–Brown constant m_i of the intact rock: the m in σ1 = σ3 + σci·(m·σ3/σci + 1)^0.5, which with the UCS gives its tensile strength σci·(√(m² + 4) − m)/2, about UCS/m_i.> 0 |
poissonsRatio | number | Poisson's ratio of the intact rock, between 0 and 0.5.> 0 · < 0.5 |
strengthStage | StrengthStage | Which stage of failure the strength figures describe (Martin and Chandler 1994): crack initiation, the onset of strain localisation, or peak. A model judging damage reads the UCS and m_i as that stage's; peak when unstated. |
strainCriterion | StrainCriterion | A strain criterion for this rock, usually regressed from its measured failure strains, which a model judging damage reads in place of the strength it derives from the figures. |
pWaveVelocityMs | number | P-wave velocity, m/s.> 0 |
rmr | number | Rock mass rating (Bieniawski).≥ 0 · ≤ 100 |
gsi | number | Geological strength index.≥ 0 · ≤ 100 |
kuzRamRockFactor | number | Kuz-Ram rock factor A, when calibrated.> 0 |
RunningRun
Started and not yet finished.
| Campo | Tipo | Descripción |
|---|---|---|
idobligatorio | string | An opaque identifier: letters, digits, ., _, : and -, up to 128 characters.longitud mín. 1 · longitud máx. 128 · patrón ^[A-Za-z0-9][A-Za-z0-9._:-]*$ |
modelIdobligatorio | ModelId | A model identifier in the form vendor/model, lower case, for example shockai/site-law. |
modelVersionobligatorio | string | A semantic version. A result is always pinned to the exact version that produced it.patrón ^\d+\.\d+\.\d+(?:-[0-9A-Za-z.-]+)?$ |
caseIdobligatorio | string | A content hash: sha256: followed by 64 lower-case hex digits.patrón ^sha256:[0-9a-f]{64}$ |
createdAtobligatorio | string (date-time) | An ISO 8601 timestamp in UTC, for example 2026-09-26T04:12:00Z. |
updatedAtobligatorio | string (date-time) | An ISO 8601 timestamp in UTC, for example 2026-09-26T04:12:00Z. |
statusobligatorio | "running" | |
progress | number | Fraction complete, for display only.≥ 0 · ≤ 1 |
Scaling
Charge scaling for scaled distance: D/√Q for ground vibration, D/∛Q for airblast and near-field work.
square_rootcube_rootSeedWaveform
A single-hole ground-motion record: the kinematic input a superposition model is calibrated from.
| Campo | Tipo | Descripción |
|---|---|---|
idobligatorio | string | An opaque identifier: letters, digits, ., _, : and -, up to 128 characters.longitud mín. 1 · longitud máx. 128 · patrón ^[A-Za-z0-9][A-Za-z0-9._:-]*$ |
holeId | string | The single hole that produced it.longitud mín. 1 · longitud máx. 128 · patrón ^[A-Za-z0-9][A-Za-z0-9._:-]*$ |
receiverId | string | Where it was recorded.longitud mín. 1 · longitud máx. 128 · patrón ^[A-Za-z0-9][A-Za-z0-9._:-]*$ |
distanceMobligatorio | number | Charge-to-sensor distance, m.> 0 |
chargeKgobligatorio | number | Charge mass of the seed hole, kg.> 0 |
sampleRateHzobligatorio | number | > 0 |
frameobligatorio | enum | Component frame: instrument axes, or transverse / vertical / longitudinal to the source.xyztvl |
samplesobligatorio | ParticleVelocity | Three-component particle velocity, mm/s: one [a, b, c] row per sample in frame order, so every component has the same length; or a reference to the same rows. |
recordedAt | string (date-time) | An ISO 8601 timestamp in UTC, for example 2026-09-26T04:12:00Z. |
SiteLaw
A fitted scaled-distance attenuation law.
| Campo | Tipo | Descripción |
|---|---|---|
metricobligatorio | "ppv" | |
basisobligatorio | PpvBasis | How peak particle velocity is taken: the largest single component (max_axis) or the peak vector sum (pvs). |
scalingobligatorio | Scaling | Charge scaling for scaled distance: D/√Q for ground vibration, D/∛Q for airblast and near-field work. |
kobligatorio | number | Site constant K in PPV = K·SD^−β, mm/s.> 0 |
betaobligatorio | number | Attenuation exponent β.> 0 |
sigmaLn | number | Residual standard deviation in natural-log units.≥ 0 |
n | number | Readings in the fit. Fractional when a regional prior lends the fit its weight in readings.≥ 0 |
scaledDistance | Range | The scaled-distance range the fit was made over. |
fit | LawFitStatistics | What a prediction interval needs beyond σ and n. |
frequencyBins | array de FrequencyBin | Dominant frequency by scaled distance, from the site’s own readings.máx. 60 elementos |
sourceobligatorio | enum | A law fitted by the platform from this site’s readings, one entered by the user, or a regional prior.platform_fituserprior |
StrainAmplitude
The site's fit of the strain a blast puts in its rock near the charges, which a model judging damage scales its amplitude by.
| Campo | Tipo | Descripción |
|---|---|---|
factorobligatorio | number | The ratio of the P wave's amplitude near the charges to the site law's PPV extrapolated inward, as the model that fitted it reads both: above 1 the rock is strained more than the law alone says. A model judging damage scales its near-field amplitude by it.> 0 |
basisobligatorio | enum | What the factor was fitted to: how far behind the back row the wall broke, half-cast counts on the final wall, a post-blast scan against the design, strain read from an array of synchronised monitors, or judgement.backbreakhalf_castscanstrain_arrayjudgement |
blastRef | string | Which blast it was fitted on.longitud mín. 1 · longitud máx. 200 |
fittedWith | object | The model and version whose amplitude the factor scales. A factor fitted against one model's assumptions is that model's: another model, another version, or any model when this is left out, reads it as judgement. |
fittedWith.modelIdobligatorio | ModelId | A model identifier in the form vendor/model, lower case, for example shockai/site-law. |
fittedWith.modelVersionobligatorio | string | A semantic version. A result is always pinned to the exact version that produced it.patrón ^\d+\.\d+\.\d+(?:-[0-9A-Za-z.-]+)?$ |
note | string | How the fit was made, for a reader.longitud máx. 500 |
StrainAmplitudeFit
A damage model's amplitude fitted to the damage a fired blast did: how much the strain near its charges exceeded, or fell short of, what the model takes from the site law.
| Campo | Tipo | Descripción |
|---|---|---|
kindobligatorio | "strain_amplitude" | |
factorobligatorio | Estimate | The factor on the model's near-field amplitude that makes the damage radius it reports on the observed holes what was seen: the median over the holes, in log, with their spread as percentiles. What a later case of the site carries as calibration.strainAmplitude. |
basisobligatorio | enum | What it was fitted to: the backbreak measured behind the holes.backbreak |
holesobligatorio | array de object | Each hole the fit read, once.máx. 5000 elementos |
holes[].holeIdobligatorio | string | An opaque identifier: letters, digits, ., _, : and -, up to 128 characters.longitud mín. 1 · longitud máx. 128 · patrón ^[A-Za-z0-9][A-Za-z0-9._:-]*$ |
holes[].observedMobligatorio | number | The backbreak seen behind it, m.≥ 0 |
holes[].factorobligatorio | number | The least factor at which the model reports its radius as the backbreak, stated rounded up.> 0 |
validityobligatorio | Validity | How far to trust one output. |
StrainCriterion
A strain-based Hoek–Brown criterion of the intact rock as Yang and Green (2025) write it, eq. 4: ε1 = ε3 ± (a·σci·ε3 + b·σci²)^0.5 + c·σci, strain a dimensionless fraction, compression positive. A model judging damage reads it on a state's greatest and least compressive principal strains, the middle one ignored, with no tension cutoff beyond the curve's own, in place of the strength it would derive from the domain's figures: so a criterion derived from the same E, μ and m need not answer as the figures do.
| Campo | Tipo | Descripción |
|---|---|---|
stage | StrengthStage | The stage of failure the criterion describes; peak when unstated. |
sigmaCiMPaobligatorio | number | The σci the constants were fitted or derived with, MPa.> 0 |
aobligatorio | number | Per MPa, for strain as a fraction (not percent). |
bobligatorio | number | Per MPa², for strain as a fraction. Must exceed c², or the curve does not enclose the unstrained state: a model judges such a criterion by the form it derives from the figures instead, and warns.> 0 |
cobligatorio | number | Per MPa, for strain as a fraction. |
lesserStrain | Range | The least compressive principal strain ε3 over the failures the fit was made from: compression positive, so the lateral extension of a triaxial test is negative. A model warns where it reads the curve outside it; an empty range covers nothing. |
greaterStrain | Range | The greatest compressive principal strain ε1 over the same failures. The curve has two limbs, and at a lesser strain inside its range the other limb was not fitted: with this, a model can tell which it read. |
basisobligatorio | enum | Whether the constants were regressed from measured failure strains (their eq. 14) or derived from E, μ and m (their eqs 5–7).regressionderived |
note | string | Where the failure strains or figures came from, for a reader.longitud máx. 500 |
StrainField
Peak extension of the rock over a plan-view grid at a depth: where a blast strains the rock past its strength, and by how much.
| Campo | Tipo | Descripción |
|---|---|---|
kindobligatorio | "strain_field" | |
gridobligatorio | Grid | A plan-view grid for field outputs. A field’s values sit at the nodes minX + i·cellM, minY + j·cellM for i below its columns and j below its rows, the last node within a cell of maxX and maxY; a reader takes columns and rows from the output and never recomputes them. |
depthMobligatorio | number | How far below the grid's plane the field was read, m, the plane being the charged holes' mean collar height for collar_plane: the strain the rock sees at the charges' level, not at the surface.≥ 0 |
columnsobligatorio | integer | Nodes along x: ⌊(maxX − minX) / cellM⌋ + 1.> 0 |
rowsobligatorio | integer | Nodes along y: ⌊(maxY − minY) / cellM⌋ + 1.> 0 |
valuesMicrostrainobligatorio | array de (number | null) | BlobRef | Peak principal extension of the rock at each cell over the whole blast, microstrain, row-major from the south-west corner; null where the model declines to predict.máx. 4000000 elementos · cada elemento ≥ 0 |
thresholdMicrostrainobligatorio | number | The extension at which a plane P wave reaches the model's criterion, for a viewer to contour: the strain of the PPV its damage_envelope reports as thresholdMmS.> 0 |
validityobligatorio | Validity | How far to trust one output. |
StrengthStage
A stage of the progressive failure of intact rock, from the first cracks to the peak load.
crack_initiationstrain_localisationpeakSucceededRun
Finished with the model’s result.
| Campo | Tipo | Descripción |
|---|---|---|
idobligatorio | string | An opaque identifier: letters, digits, ., _, : and -, up to 128 characters.longitud mín. 1 · longitud máx. 128 · patrón ^[A-Za-z0-9][A-Za-z0-9._:-]*$ |
modelIdobligatorio | ModelId | A model identifier in the form vendor/model, lower case, for example shockai/site-law. |
modelVersionobligatorio | string | A semantic version. A result is always pinned to the exact version that produced it.patrón ^\d+\.\d+\.\d+(?:-[0-9A-Za-z.-]+)?$ |
caseIdobligatorio | string | A content hash: sha256: followed by 64 lower-case hex digits.patrón ^sha256:[0-9a-f]{64}$ |
createdAtobligatorio | string (date-time) | An ISO 8601 timestamp in UTC, for example 2026-09-26T04:12:00Z. |
updatedAtobligatorio | string (date-time) | An ISO 8601 timestamp in UTC, for example 2026-09-26T04:12:00Z. |
statusobligatorio | "succeeded" | |
resultobligatorio | ModelResult | What a model returns for one case. |
SurfacePosition
A place on the ground in the case coordinate system, metres, whose elevation may not be known.
| Campo | Tipo | Descripción |
|---|---|---|
xobligatorio | number | Easting, metres. |
yobligatorio | number | Northing, metres. |
z | number | Elevation, metres. Up is positive. Left out where the height was never surveyed: unknown, not zero. |
TimingProposal
A proposed set of firing times.
| Campo | Tipo | Descripción |
|---|---|---|
kindobligatorio | "timing_proposal" | |
objectiveobligatorio | string | What the proposal optimises, for example minimise P95 PPV at receiver R3.longitud mín. 1 · longitud máx. 500 |
holesobligatorio | array de object | máx. 5000 elementos |
holes[].holeIdobligatorio | string | An opaque identifier: letters, digits, ., _, : and -, up to 128 characters.longitud mín. 1 · longitud máx. 128 · patrón ^[A-Za-z0-9][A-Za-z0-9._:-]*$ |
holes[].totalMsobligatorio | number | |
expected | array de object | What the model expects the proposed timing to achieve.máx. 1000 elementos |
expected[].receiverIdobligatorio | string | An opaque identifier: letters, digits, ., _, : and -, up to 128 characters.longitud mín. 1 · longitud máx. 128 · patrón ^[A-Za-z0-9][A-Za-z0-9._:-]*$ |
expected[].ppvMmSobligatorio | Estimate | A predicted quantity with its uncertainty. A point value with no spread is allowed but a spread is expected: a prediction without one cannot be scored for coverage. |
validityobligatorio | Validity | How far to trust one output. |
Unavailable
A requested output the model declined to produce, and why.
Uno de ReceiverUnavailable | CaseUnavailable
UnchargedDeck
An interval of a hole with no explosive in it.
| Campo | Tipo | Descripción |
|---|---|---|
kindobligatorio | enum | What fills this interval of the hole.stemmingairwaterinert |
topDepthMobligatorio | number | Depth of the top of the deck along the hole, from the collar.≥ 0 |
bottomDepthMobligatorio | number | Depth of the bottom of the deck along the hole.≥ 0 |
Validity
How far to trust one output.
| Campo | Tipo | Descripción |
|---|---|---|
statusobligatorio | enum | Whether the inputs sit inside the range the model was validated on.withinextrapolatedoutside |
code | string | Which way it is outside, as a stable code: for example below_fitted_range, above_fitted_range, near_field.longitud máx. 60 · patrón ^[a-z][a-z0-9_]*$ |
note | string | longitud máx. 500 |
VodMeasurement
A measured velocity of detonation.
| Campo | Tipo | Descripción |
|---|---|---|
holeIdobligatorio | string | An opaque identifier: letters, digits, ., _, : and -, up to 128 characters.longitud mín. 1 · longitud máx. 128 · patrón ^[A-Za-z0-9][A-Za-z0-9._:-]*$ |
productId | string | An opaque identifier: letters, digits, ., _, : and -, up to 128 characters.longitud mín. 1 · longitud máx. 128 · patrón ^[A-Za-z0-9][A-Za-z0-9._:-]*$ |
vodMsobligatorio | number | Measured velocity of detonation, m/s.> 0 |
methodobligatorio | enum | continuous_resistancepoint_to_pointoptical |
Warning
Something the model wants a person to see.
| Campo | Tipo | Descripción |
|---|---|---|
codeobligatorio | string | A stable machine-readable code. Reserved: interval.approximate, the intervals on this result are approximate (for example, the fit came without its leverage statistics); target narrows it to a receiver. Reserved for a diagnosis: diagnosis.not_converged, the fit had not settled when it stopped; diagnosis.single_record, only one record was read, so nothing cross-checks it; diagnosis.det_log_disagrees, a hole the firing record says did not fire shows in the records; diagnosis.heading_unknown, no record’s heading is known, so shear is not read.longitud máx. 80 · patrón ^[a-z][a-z0-9_.-]*$ |
messageobligatorio | string | longitud mín. 1 · longitud máx. 1000 |
target | string | What the warning is about: a hole id, a receiver id or a field path.longitud máx. 200 |