Saltar al contenido principal
Menú para desarrolladores
Vista previa para sociosv0

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

get/healthz

Say 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.
get/manifest

Describe 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.
post/quote

Price 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

BlastCase

Respuestas

  • 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). Send Retry-After; the platform backs off accordingly.
  • 500ApiErrorThe model failed (provider_error). The platform retries with backoff.
post/runs

Run 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

RunRequest

Respuestas

  • 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). Send Retry-After; the platform backs off accordingly.
  • 500ApiErrorThe model failed (provider_error). The platform retries with backoff.

Callback

post{$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.

get/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 in POST /runs.

Respuestas

  • 200RunThe run.
  • 401ApiErrorThe signature is missing, expired or wrong (authentication).
  • 404ApiErrorNo such run.
  • 500ApiErrorThe model failed (provider_error). The platform retries with backoff.
delete/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 in POST /runs.

Respuestas

  • 200RunThe run, cancelled or already final.
  • 401ApiErrorThe signature is missing, expired or wrong (authentication).
  • 404ApiErrorNo such run.
  • 500ApiErrorThe model failed (provider_error). The platform retries with backoff.

Esquemas

Primero los documentos de nivel superior, luego las partes que los componen. Cada uno se publica también como un JSON Schema independiente.

Everything a model may read about one blast: design, as-built record, site, receivers, calibration and the question asked.

CampoTipoDescripción
specVersionobligatorio"0.1"Version of the ShockAI Model API specification this document follows.
caseIdobligatoriostringSHA-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}$
createdAtobligatoriostring (date-time)An ISO 8601 timestamp in UTC, for example 2026-09-26T04:12:00Z.
coordinateSystemobligatorioCoordinateSystemThe frame every position in the case is expressed in.
siteobligatorioobject
site.namestringlongitud mín. 1 · longitud máx. 200
site.domainsobligatorioarray de RockDomainA zone of rock the site treats as one material. Holes name the domain they sit in.máx. 100 elementos
site.terrainBlobRefSurface model, when the provider needs one.
designobligatorioDesignThe blast as designed.
asBuiltobjectPresent once the blast is drilled, loaded or fired. A pre-blast prediction leaves it out.
asBuilt.holesarray de AsBuiltHoleA hole as drilled and loaded. Fields left out are as designed.máx. 5000 elementos
asBuilt.firingFiringRecordWhat actually fired, and when.
receiversobligatorioarray de ReceiverA place a prediction is wanted. It has a position, a resolved distance, or both.máx. 1000 elementos
calibrationCalibrationWhat the site has measured. This is what lets a kinematic model be calibrated rather than assumed.
measuredMeasuredPresent once the blast has fired and its records are in.
requestobligatorioOutputRequestThe question the case asks.
consentobligatorioConsentThe data owner’s terms for this case. A provider that cannot honour them must refuse the run.

What a model says about itself: capabilities, inputs, validity, execution, pricing and data handling.

CampoTipoDescripción
specVersionobligatorio"0.1"Version of the ShockAI Model API specification this document follows.
idobligatorioModelIdA model identifier in the form vendor/model, lower case, for example shockai/site-law.
versionobligatoriostringA semantic version. A result is always pinned to the exact version that produced it.patrón ^\d+\.\d+\.\d+(?:-[0-9A-Za-z.-]+)?$
nameobligatoriostringlongitud mín. 1 · longitud máx. 120
summaryobligatoriostringlongitud mín. 1 · longitud máx. 500
vendorobligatorioobject
vendor.nameobligatoriostringlongitud mín. 1 · longitud máx. 120
vendor.urlstring (uri)
methodobligatorioModelMethodThe family of method, so a user can tell a fitted law from a simulation.
capabilitiesobligatorioarray de CapabilityOne kind of output a model produces, and what it needs to produce it.mín. 1 elementos
executionobligatorioobject
execution.modeobligatorioenumSync models answer POST /runs within the timeout; async models accept the run and call back.syncasync
execution.typicalSecondsobligatorionumber> 0
execution.maxSecondsobligatorionumberHard limit. A run still going at this point is cancelled.> 0 · ≤ 604800
pricingobligatorioobject (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"stringlongitud mín. 3 · longitud máx. 3
pricing.unitAmountobligatoriomodel = "per_run"integerMinor units, e.g. cents.≥ 0
pricing.modelobligatoriomodel = "per_hole""per_hole"
pricing.currencyobligatoriomodel = "per_hole"stringlongitud mín. 3 · longitud máx. 3
pricing.unitAmountobligatoriomodel = "per_hole"integer≥ 0
pricing.modelobligatoriomodel = "quote""quote"
pricing.modelobligatoriomodel = "licence""licence"
pricing.notemodel = "licence"stringThe customer brings their own licence; the platform charges nothing on the run.longitud máx. 500
dataHandlingobligatorioobject
dataHandling.regionsobligatorioarray de stringWhere the case is processed, for example au, eu, us.mín. 1 elementos · cada elemento longitud mín. 2, longitud máx. 40
dataHandling.retentionobligatorioenumnone30dcontract
dataHandling.trainsOnCustomerDataobligatorioboolean
documentationUrlstring (uri)
signingobjectHow the provider signs what it sends the platform. Required of an async model, whose results arrive as signed callbacks.
signing.callbackKeysobligatorioarray de Ed25519JwkThe 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
buildobjectWhat is deployed behind this version.
build.hashobligatoriostringIdentifies 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._:+/@-]+$

What a model returns for one case.

CampoTipoDescripción
specVersionobligatorio"0.1"Version of the ShockAI Model API specification this document follows.
caseIdobligatoriostringA content hash: sha256: followed by 64 lower-case hex digits.patrón ^sha256:[0-9a-f]{64}$
outputsobligatorioarray de OutputOne answer, discriminated by kind.máx. 5000 elementos
unavailableobligatorioarray de UnavailableA requested output the model declined to produce, and why.máx. 5000 elementos
warningsobligatorioarray de WarningSomething the model wants a person to see.máx. 500 elementos
provenanceobligatorioProvenanceWhere a result came from. Reports cite it; the platform uses it to score the model later.

The body of POST /runs.

CampoTipoDescripción
caseobligatorioBlastCaseEverything a model may read about one blast: design, as-built record, site, receivers, calibration and the question asked.
quoteIdstringThe 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._:-]*$
callbackUrlstring (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.

CampoTipoDescripción
idobligatoriostringAn 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._:-]*$
caseIdobligatoriostringA content hash: sha256: followed by 64 lower-case hex digits.patrón ^sha256:[0-9a-f]{64}$
currencyobligatoriostringlongitud mín. 3 · longitud máx. 3
amountobligatoriointegerMinor units, e.g. cents.≥ 0
expiresAtobligatoriostring (date-time)An ISO 8601 timestamp in UTC, for example 2026-09-26T04:12:00Z.
estimatedSecondsobligatorionumber> 0

Every non-2xx response carries this body.

CampoTipoDescripción
errorobligatorioobject
error.typeobligatorioenumThe 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.codeobligatoriostringA stable machine-readable code within the family.longitud máx. 80 · patrón ^[a-z][a-z0-9_]*$
error.messageobligatoriostringlongitud mín. 1 · longitud máx. 1000
error.paramstringThe case field at fault, as a JSON Pointer.longitud máx. 200

Sent 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"
CampoTipoDescripción
idobligatoriostringUnique 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._:-]*$
createdAtobligatoriostring (date-time)An ISO 8601 timestamp in UTC, for example 2026-09-26T04:12:00Z.
typeobligatorio"run.running"
dataobligatorioobject
data.runobligatorioRunningRunStarted and not yet finished.
type = "run.succeeded"
CampoTipoDescripción
idobligatoriostringUnique 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._:-]*$
createdAtobligatoriostring (date-time)An ISO 8601 timestamp in UTC, for example 2026-09-26T04:12:00Z.
typeobligatorio"run.succeeded"
dataobligatorioobject
data.runobligatorioSucceededRunFinished with the model’s result.
type = "run.failed"
CampoTipoDescripción
idobligatoriostringUnique 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._:-]*$
createdAtobligatoriostring (date-time)An ISO 8601 timestamp in UTC, for example 2026-09-26T04:12:00Z.
typeobligatorio"run.failed"
dataobligatorioobject
data.runobligatorioFailedRunFinished without a result, and why.
type = "run.cancelled"
CampoTipoDescripción
idobligatoriostringUnique 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._:-]*$
createdAtobligatoriostring (date-time)An ISO 8601 timestamp in UTC, for example 2026-09-26T04:12:00Z.
typeobligatorio"run.cancelled"
dataobligatorioobject
data.runobligatorioCancelledRunStopped before it finished, by the platform or the provider.

ImportDocument

Descargar JSON Schema

Predictions made by another tool, brought onto the platform with their provenance.

CampoTipoDescripción
specVersionobligatorio"0.1"Version of the ShockAI Model API specification this document follows.
blastobligatorioobject
blast.platformBlastIdstringThe 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.externalRefstringThe blast’s name or number in the source tool.longitud mín. 1 · longitud máx. 200
sourceobligatorioobject
source.toolobligatoriostringThe software that produced the results.longitud mín. 1 · longitud máx. 120
source.versionobligatoriostringlongitud mín. 1 · longitud máx. 60
source.vendorstringlongitud mín. 1 · longitud máx. 120
source.methodModelMethodThe family of method, so a user can tell a fitted law from a simulation.
source.fileobject
source.file.nameobligatoriostringlongitud mín. 1 · longitud máx. 255
source.file.sha256obligatoriostringA content hash: sha256: followed by 64 lower-case hex digits.patrón ^sha256:[0-9a-f]{64}$
source.producedAtstring (date-time)An ISO 8601 timestamp in UTC, for example 2026-09-26T04:12:00Z.
outputsobligatorioarray de ImportedOutputOne prediction made elsewhere, discriminated by kind: every kind a prediction case asks.mín. 1 elementos · máx. 5000 elementos
unavailablearray de UnavailableA requested output the model declined to produce, and why.máx. 5000 elementos · predeterminado []
warningsarray de WarningSomething the model wants a person to see.máx. 500 elementos · predeterminado []

Airblast

Predicted peak overpressure at a receiver.

CampoTipoDescripción
kindobligatorio"airblast"
receiverIdobligatoriostringAn 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._:-]*$
peakPaobligatorioEstimatePeak overpressure, Pa. dB(L) = 20·log10(Pa / 20 µPa).
peakDbLEstimateThe same peak in dB(L), as the model computed it, so a limit in decibels is read without a round trip.
scaledDistancenumberThe cube-root scaled distance the prediction was made at.> 0
validityobligatorioValidityHow far to trust one output.

AirblastLaw

A fitted airblast attenuation law on cube-root scaled distance.

CampoTipoDescripción
scalingobligatorio"cube_root"
kPaobligatorionumberSite constant in P = K·SD^−β, pascals.> 0
betaobligatorionumberAttenuation exponent β.> 0
sigmaLnobligatorionumberResidual standard deviation in ln(Pa).≥ 0
nobligatorionumberReadings in the fit.> 0
fitobligatorioLawFitStatisticsThe least-squares statistics of a log-log fit, for prediction intervals: ln y ± t(p, dof)·σ·√(1 + 1/n + (ln SD − mean)²/sxx).
scaledDistanceobligatorioRangeThe scaled-distance range the fit was made over.
sourceobligatorioenumplatform_fituserprior

AsBuiltHole

A hole as drilled and loaded. Fields left out are as designed.

CampoTipoDescripción
idobligatoriostringThe design hole this record amends.longitud mín. 1 · longitud máx. 128 · patrón ^[A-Za-z0-9][A-Za-z0-9._:-]*$
collarPoint3A position in the case coordinate system, metres.
toePoint3A position in the case coordinate system, metres.
waterDepthMnumberStanding water measured at loading, m.≥ 0
decksarray de DeckThe 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.

CampoTipoDescripción
distanceMobligatorionumberHow 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
holeIdsobligatorioarray de stringThe 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._:-]*$
methodenumHow it was measured: taped, surveyed, read from a scan, or estimated by eye.tapesurveyscanestimate
notestringAnything a reader should know.longitud máx. 500

BlobRef

A large payload passed by reference rather than inline: terrain, point clouds, long waveforms.

CampoTipoDescripción
uriobligatoriostring (uri)A signed HTTPS URL. It expires; fetch it once when the run starts.
sha256obligatoriostringA content hash: sha256: followed by 64 lower-case hex digits.patrón ^sha256:[0-9a-f]{64}$
mediaTypeobligatoriostringIANA media type, for example image/tiff or application/vnd.las.longitud mín. 3 · longitud máx. 120
bytesintegerSize in bytes.≥ 0

Calibration

What the site has measured. This is what lets a kinematic model be calibrated rather than assumed.

CampoTipoDescripción
siteLawSiteLawA fitted scaled-distance attenuation law.
airblastLawAirblastLawA fitted airblast attenuation law on cube-root scaled distance.
seedWaveformsarray de SeedWaveformA single-hole ground-motion record: the kinematic input a superposition model is calibrated from.máx. 500 elementos
vodarray de VodMeasurementA measured velocity of detonation.máx. 5000 elementos
outcomesarray de MeasuredOutcomeA reading from an earlier blast at this site.máx. 10000 elementos
strainAmplitudeStrainAmplitudeThe 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.

CampoTipoDescripción
idobligatoriostringAn 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._:-]*$
modelIdobligatorioModelIdA model identifier in the form vendor/model, lower case, for example shockai/site-law.
modelVersionobligatoriostringA semantic version. A result is always pinned to the exact version that produced it.patrón ^\d+\.\d+\.\d+(?:-[0-9A-Za-z.-]+)?$
caseIdobligatoriostringA content hash: sha256: followed by 64 lower-case hex digits.patrón ^sha256:[0-9a-f]{64}$
createdAtobligatoriostring (date-time)An ISO 8601 timestamp in UTC, for example 2026-09-26T04:12:00Z.
updatedAtobligatoriostring (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.

CampoTipoDescripción
outputobligatorioOutputKindA 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.
inputsobligatorioobject
inputs.requiredobligatorioarray de InputPathA 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.requiredAnyOfarray de array de InputPathInputs 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.optionalarray de InputPathA 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 []
validityobjectThe domain the model is validated on. Outputs outside it must be marked outside or declined.
validity.distanceMRangeAn 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.scaledDistanceRangeAn 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.rockClassesarray de RockClassCoarse rock class used when no measured properties are available.
validity.notesstringlongitud máx. 1000

CaseUnavailable

A kind answered once for the case that the model declined.

CampoTipoDescripción
kindobligatorioenumppv_fielddamage_envelopestrain_fieldflyrock_zonefragmentation_curvemovement_fieldtiming_proposalhole_diagnosisstrain_amplitude
reasonobligatorioenumWhy the model did not answer.not_supportedmissing_inputoutside_validityinsufficient_calibration
detailstringlongitud máx. 500

The data owner’s terms for this case. A provider that cannot honour them must refuse the run.

CampoTipoDescripción
purposeobligatorioenumWhat 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
retentionobligatorioenumHow long the provider may keep the case after the run.none30dcontract
allowTrainingobligatoriobooleanWhether 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"
CampoTipoDescripción
kindobligatorio"epsg"
codeobligatoriointegerEPSG code of a projected system, for example 28350 (GDA94 / MGA zone 50).> 0
kind = "local"
CampoTipoDescripción
kindobligatorio"local"
nameobligatoriostringThe mine grid name.longitud mín. 1 · longitud máx. 120
gridBearingDegnumberBearing of grid north from true north, degrees clockwise.≥ -360 · ≤ 360
originobjectWGS 84 position of the local origin, when known.
origin.latitudeobligatorionumber≥ -90 · ≤ 90
origin.longitudeobligatorionumber≥ -180 · ≤ 180

DamageEnvelope

The zone around the charges where rock is expected to be damaged: the basis for wall control.

CampoTipoDescripción
kindobligatorio"damage_envelope"
thresholdMmSobligatorionumberThe PPV taken as the onset of damage for this envelope.> 0
criterionobligatoriostringName of the damage criterion, for example holmberg-persson, charge-column-integration or hoek-brown-strain.longitud mín. 1 · longitud máx. 120
holesobligatorioarray de objectmáx. 5000 elementos
holes[].holeIdobligatoriostringAn 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[].radiusMobligatorioEstimateRadius from the hole axis at which the threshold is reached.
surfaceBlobRefThe envelope as a closed mesh, when available.
validityobligatorioValidityHow 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.

CampoTipoDescripción
namestringlongitud mín. 1 · longitud máx. 200
patternenumLayout family.squarerectangularstaggeredringdevelopmentother
holesobligatorioarray de DesignHoleEvery 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
productsobligatorioarray de ProductAn explosive product as loaded.máx. 50 elementos
initiationInitiationOmitted when the platform holds only a summary of the design.
maxInstantaneousChargeMaxInstantaneousChargeThe 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.
drillingDeviationMnumberOne standard deviation of collar and drilling error, m (Cunningham’s W): what fragmentation uniformity loses to imperfect drilling.≥ 0

DesignHole

A hole as designed.

CampoTipoDescripción
idobligatoriostringAn 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._:-]*$
rowinteger> 0
columninteger> 0
collarobligatorioPoint3A position in the case coordinate system, metres.
toeobligatorioPoint3A position in the case coordinate system, metres.
diameterMmnumberHole diameter, mm. Left out when the plan does not state it.> 0 · ≤ 2000
domainIdstringThe rock domain the hole sits in.longitud mín. 1 · longitud máx. 128 · patrón ^[A-Za-z0-9][A-Za-z0-9._:-]*$
burdenMnumberBurden this hole breaks, m.> 0
spacingMnumberSpacing to its neighbour in the row, m.> 0
subdrillMnumberDrilled length below grade, m.
decksobligatorioarray de DeckThe hole from collar to toe. Stemming is a deck like any other.mín. 1 elementos · máx. 32 elementos
delayobligatorioHoleDelayWhen a hole is designed to fire.

DiagnosedHole

One hole’s diagnosis.

CampoTipoDescripción
holeIdobligatoriostringThe design hole.longitud mín. 1 · longitud máx. 128 · patrón ^[A-Za-z0-9][A-Za-z0-9._:-]*$
verdictobligatorioHoleVerdictWhat 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.
confidenceobligatorionumberThe 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
alternativesarray de objectThe 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[].verdictobligatorioHoleVerdictWhat 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[].confidenceobligatorionumber≥ 0 · ≤ 1
timingobjectWhen the hole fired. Left out for a hole not detected.
timing.offsetMsobligatorionumberThe firing time the model found less the design hole’s delay.totalMs, ms.
timing.sigmaMsnumberOne standard deviation of that time, ms.≥ 0
sizeobjectHow big the hole was. Left out for a hole not detected.
size.relativeobligatorionumberIts ground motion over the blast’s typical hole’s: 1 is typical.≥ 0
size.sigmaLnnumberOne standard deviation of ln(relative).≥ 0
size.callobjectThe size as a claim of its own, where the records resolve sizes. A weak or strong verdict makes the same call.
size.call.valueobligatorioenumweaktypicalstrong
size.call.confidenceobligatorionumberThe model’s probability that the call is right.≥ 0 · ≤ 1
confinementobjectHow much shear the hole carried, which is what confinement shows as. Only where a record’s heading is known.
confinement.relativeobligatorionumberIts shear over its compression (motion across the ray over motion along it) against the blast’s typical hole: 1 is typical.≥ 0
confinement.sigmaLnnumber≥ 0
clarityDbnumberThe hole’s motion over the noise at its clearest record, dB.
dominantFrequencyHznumber> 0
resolvedWitharray de stringThe 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._:-]*$
flagsarray de stringWhat 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_.-]*$
evidenceHoleEvidenceThe 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).

CampoTipoDescripción
ktyobligatorio"OKP"
crvobligatorio"Ed25519"
xobligatoriostringThe 32-byte public key, base64url without padding.longitud mín. 43 · longitud máx. 43 · patrón ^[A-Za-z0-9_-]+$
kidstringIgnored: 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.

CampoTipoDescripción
medianobligatorionumberThe best estimate (P50).
percentilesarray de objectFurther points on the predictive distribution, usually those the request asked for.máx. 99 elementos
percentiles[].pobligatorionumberPercentile, 0 to 100.≥ 0 · ≤ 100
percentiles[].valueobligatorionumberThe value at that percentile, in the unit of the parent quantity.
ensemblearray de numberRaw ensemble members, for providers that sample rather than summarise.máx. 10000 elementos

ExplosiveDeck

An interval of a hole loaded with explosive.

CampoTipoDescripción
kindobligatorio"explosive"
topDepthMobligatorionumberDepth of the top of the deck along the hole, from the collar.≥ 0
bottomDepthMobligatorionumberDepth of the bottom of the deck along the hole.≥ 0
productIdobligatoriostringThe product loaded.longitud mín. 1 · longitud máx. 128 · patrón ^[A-Za-z0-9][A-Za-z0-9._:-]*$
massKgobligatorionumberCharge mass.≥ 0

FailedRun

Finished without a result, and why.

CampoTipoDescripción
idobligatoriostringAn 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._:-]*$
modelIdobligatorioModelIdA model identifier in the form vendor/model, lower case, for example shockai/site-law.
modelVersionobligatoriostringA semantic version. A result is always pinned to the exact version that produced it.patrón ^\d+\.\d+\.\d+(?:-[0-9A-Za-z.-]+)?$
caseIdobligatoriostringA content hash: sha256: followed by 64 lower-case hex digits.patrón ^sha256:[0-9a-f]{64}$
createdAtobligatoriostring (date-time)An ISO 8601 timestamp in UTC, for example 2026-09-26T04:12:00Z.
updatedAtobligatoriostring (date-time)An ISO 8601 timestamp in UTC, for example 2026-09-26T04:12:00Z.
statusobligatorio"failed"
errorobligatorioobject
error.typeobligatorioenumThe 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.codeobligatoriostringA stable machine-readable code within the family.longitud máx. 80 · patrón ^[a-z][a-z0-9_]*$
error.messageobligatoriostringlongitud mín. 1 · longitud máx. 1000
error.paramstringThe case field at fault, as a JSON Pointer.longitud máx. 200

FiringRecord

What actually fired, and when.

CampoTipoDescripción
sourceobligatorioenumWhere the firing times come from: a detonator log, an imported timing file, or the design itself.det_logtiming_importdesign
firedAtstring (date-time)Wall-clock time of T0.
holesobligatorioarray de objectmáx. 5000 elementos
holes[].idobligatoriostringAn 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[].firedMsobligatorionumber | nullMeasured firing time from T0, ms; null when the hole did not fire.
holes[].statusobligatorioenumfiredmisfirecutoffunknown

FlyrockZone

Predicted flyrock range and clearance.

CampoTipoDescripción
kindobligatorio"flyrock_zone"
maxThrowMobligatorioEstimateMaximum expected throw, m.
mechanismobligatorioenumface_burstcrateringriflingcombined
clearanceobjectRecommended clearance distances.
clearance.personnelMobligatorionumber> 0
clearance.equipmentMobligatorionumber> 0
holesarray de objectmáx. 5000 elementos
holes[].holeIdobligatoriostringAn 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[].maxThrowMobligatorionumber≥ 0
holes[].faceBurstMnumberHow far the face would throw rock out through the hole’s burden, m.≥ 0
holes[].crateringMnumberHow 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[].stemmingMnumberThe 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[].stemmingAsLoadedbooleanTrue where stemmingM is the as-built record’s.
validityobligatorioValidityHow far to trust one output.

FragmentationCurve

Predicted size distribution of the broken rock.

CampoTipoDescripción
kindobligatorio"fragmentation_curve"
domainIdstringAn 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._:-]*$
curveobligatorioarray de objectThe curve, by ascending sieve size.mín. 2 elementos · máx. 200 elementos
curve[].sizeMmobligatorionumberSieve size, mm.> 0
curve[].passingPercentobligatorionumberPercent of the rock passing that size.≥ 0 · ≤ 100
x50MmobligatorioEstimateA 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.
x80MmobligatorioEstimateA 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.
uniformityIndexnumber≥ 0
validityobligatorioValidityHow far to trust one output.

FrequencyBin

One band of log10(scaled distance) and the median dominant frequency the site recorded in it.

CampoTipoDescripción
log10SdMinobligatorionumber
log10SdMaxobligatorionumber
medianHzobligatorionumberMedian dominant frequency of the readings in the band, Hz.> 0
countobligatoriointeger> 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.

CampoTipoDescripción
minXobligatorionumber
minYobligatorionumber
maxXobligatorionumber
maxYobligatorionumber
cellMobligatorionumberCell size, m.> 0
elevationobligatorioenumWhere grid points sit vertically.terraincollar_plane

HoleDelay

When a hole is designed to fire.

CampoTipoDescripción
totalMsobligatorionumberDesigned firing time from T0, milliseconds.
surfaceMsnumberDelay carried by the surface connector.≥ 0
downholeMsnumberDelay of the in-hole unit.≥ 0
tieInFromstringThe 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.

CampoTipoDescripción
kindobligatorio"hole_diagnosis"
holesobligatorioarray de DiagnosedHoleEvery design hole with an explosive deck, once each.máx. 5000 elementos
recordsarray de objectWhat became of each record the model was given.máx. 64 elementos
records[].recordIdobligatoriostringAn 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[].useobligatorioenumWhat 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[].residualFractionnumberFor a record read: the energy left in it once every hole’s motion is taken out, over what was there.≥ 0
validityobligatorioValidityHow 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.

CampoTipoDescripción
recordIdobligatoriostringThe 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._:-]*$
sampleRateHzobligatorionumberThe rate of the rows, which is the model’s own and need not be the record’s.> 0
startMsobligatorionumberTime of the first row from T0, ms, as the model aligned the record.
samplesobligatorioarray 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.

Valoreson_timelateearlynot_detectedweakstrongunrelievedunresolved

ImportedOutput

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.

CampoTipoDescripción
systemobligatorioInitiationSystemThe detonator technology. It sets the delay scatter a model should assume when none is given.
delayScatterobjectOne standard deviation of detonator timing error: a fixed part plus a percentage of the nominal delay.
delayScatter.fixedMsnumber≥ 0
delayScatter.percentnumber≥ 0

InitiationSystem

The detonator technology. It sets the delay scatter a model should assume when none is given.

Valoreselectronicnonelelectricdetonating_cord

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.

Valoresdesign.holesdesign.productsdesign.initiationdesign.maxInstantaneousChargedesign.drillingDeviationasBuilt.holesasBuilt.firingsite.domainssite.terrainreceiverscalibration.siteLawcalibration.airblastLawcalibration.seedWaveformscalibration.vodcalibration.outcomescalibration.strainAmplitudemeasured.recordsmeasured.backbreak

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).

CampoTipoDescripción
dofobligatorionumberResidual degrees of freedom of the fit.> 0
meanLnScaledDistanceobligatorionumberMean of ln(scaled distance) over the readings.
sxxobligatorionumber | 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.

CampoTipoDescripción
kindobligatorio"max_charge"
receiverIdobligatoriostringAn 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._:-]*$
limitMmSobligatorionumberThe PPV limit the charge was held to: the receiver’s own limit.> 0
percentileobligatorionumberThe percentile the limit was read at.≥ 50 · ≤ 99.9
maxChargeKgobligatorionumber | nullThe largest maximum instantaneous charge whose prediction at that percentile stays at or under the limit. Null when even a token charge exceeds it.> 0
scaledDistancenumberThe scaled distance at that charge.> 0
validityobligatorioValidityHow 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.

CampoTipoDescripción
massKgobligatorionumberThe largest charge detonating inside any one window, kg.> 0
windowMsobligatorionumberThe 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.

CampoTipoDescripción
recordsarray de MeasuredRecordA 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
backbreakarray de BackbreakReadingHow 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.

CampoTipoDescripción
blastRefobligatoriostringWhich earlier blast this came from.longitud mín. 1 · longitud máx. 200
receiverIdobligatoriostringAn 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._:-]*$
distanceMnumber> 0
micKgnumberMaximum instantaneous charge of that blast, kg.> 0
ppvMmSnumber≥ 0
basisPpvBasisHow peak particle velocity is taken: the largest single component (max_axis) or the peak vector sum (pvs).
dominantFrequencyHznumber> 0
airblastDbLnumber≥ 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.

CampoTipoDescripción
idobligatoriostringAn 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._:-]*$
receiverIdobligatoriostringThe 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._:-]*$
sampleRateHzobligatorionumber> 0
axesobligatorioenumHow 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
headingDegnumberBearing of the first component, degrees clockwise from grid north. Given for oriented axes only.≥ 0 · ≤ 360
quietUntilIndexobligatoriointegerThe rows before this index were recorded before the blast’s motion arrived: what a model measures the noise from.≥ 0
dominantFrequencyHznumberDominant frequency of the record, Hz, as the platform’s analysis found it.> 0
clipMmSnumberThe recorder’s full scale, mm/s. A sample at it was clipped.> 0
recordedAtstring (date-time)Wall-clock time of the first row, by the recorder’s own clock.
samplesobligatorioParticleVelocityThree-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.

Valoresempiricalkinematicnumericalstatisticalhybrid

MovementField

Predicted displacement of the burden, and the muckpile it forms.

CampoTipoDescripción
kindobligatorio"movement_field"
pointsobligatorioarray de objectmáx. 50000 elementos
points[].idobligatoriostringNames the point within this field.longitud mín. 1 · longitud máx. 128 · patrón ^[A-Za-z0-9][A-Za-z0-9._:-]*$
points[].fromobligatorioPoint3A position in the case coordinate system, metres.
points[].toobligatorioPoint3A position in the case coordinate system, metres.
points[].flightobjectWhen 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.launchMsobligatorionumberWhen the point leaves from, milliseconds from T0.
points[].flight.durationMsobligatorionumberHow long it then takes to come to rest at to, milliseconds.≥ 0
points[].flight.touchdownobjectWhere 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.atobligatorioPoint3A position in the case coordinate system, metres.
points[].flight.touchdown.afterMsobligatorionumberWhen it gets there, milliseconds after it leaves from: never after durationMs.≥ 0
points[].sourceobjectThe 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.volumeM3obligatorionumberThe rock the point stands for as it stood in the bench, m³: in situ, before any swell.> 0
points[].source.massKgobligatorionumberThat rock’s mass, kg.> 0
points[].source.momentumobligatorioobjectThe 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.xobligatorionumberEastward, kg·m/s.
points[].source.momentum.yobligatorionumberNorthward, kg·m/s.
points[].source.carriedobligatoriobooleanTrue 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.
muckpileSurfaceBlobRefThe predicted muckpile surface.
validityobligatorioValidityHow 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.

Valoresreceiver_ppvmax_chargereceiver_waveformreceiver_spectrumppv_fieldairblastdamage_envelopestrain_fieldflyrock_zonefragmentation_curvemovement_fieldtiming_proposalhole_diagnosisstrain_amplitude

OutputRequest

The question the case asks.

CampoTipoDescripción
outputsobligatorioarray de OutputKindWhat the caller wants back.mín. 1 elementos
receiverIdsarray de stringReceivers 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._:-]*$
gridGridA 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.
percentilesarray de numberPoints of the predictive distribution to report. 50 and 95 when omitted.máx. 20 elementos · predeterminado [50,95] · cada elemento ≥ 0, ≤ 100
designPercentilenumberThe 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
seedintegerSeed 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

array de [3 × number]máx. 200000 elementosOne row per sample, [a, b, c] in frame order, mm/s.

Point3

A position in the case coordinate system, metres.

CampoTipoDescripción
xobligatorionumberEasting, metres.
yobligatorionumberNorthing, metres.
zobligatorionumberElevation, metres. Up is positive.

PpvBasis

How peak particle velocity is taken: the largest single component (max_axis) or the peak vector sum (pvs).

Valoresmax_axispvs

PpvField

Peak particle velocity over a plan-view grid, at one percentile.

CampoTipoDescripción
kindobligatorio"ppv_field"
gridobligatorioGridA 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.
percentileobligatorionumber≥ 0 · ≤ 100
basisobligatorioPpvBasisHow peak particle velocity is taken: the largest single component (max_axis) or the peak vector sum (pvs).
columnsobligatoriointegerNodes along x: ⌊(maxX − minX) / cellM⌋ + 1.> 0
rowsobligatoriointegerNodes along y: ⌊(maxY − minY) / cellM⌋ + 1.> 0
valuesMmSobligatorioarray de (number | null) | BlobRefRow-major from the south-west corner; null where the model declines to predict.máx. 4000000 elementos · cada elemento ≥ 0
validityobligatorioValidityHow far to trust one output.

Product

An explosive product as loaded.

CampoTipoDescripción
idobligatoriostringAn 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._:-]*$
nameobligatoriostringlongitud mín. 1 · longitud máx. 120
classobligatorioenumProduct family.anfoheavy_anfoemulsionwatergelpackagedboosterother
densityGccnumberIn-hole density, g/cm³.> 0 · ≤ 3
relativeWeightStrengthnumberRelative weight strength, ANFO = 100.> 0
energyMjKgnumberRated energy, MJ/kg.> 0
nominalVodMsnumberNominal velocity of detonation, m/s.> 0

Provenance

Where a result came from. Reports cite it; the platform uses it to score the model later.

CampoTipoDescripción
modelIdobligatorioModelIdA model identifier in the form vendor/model, lower case, for example shockai/site-law.
modelVersionobligatoriostringA semantic version. A result is always pinned to the exact version that produced it.patrón ^\d+\.\d+\.\d+(?:-[0-9A-Za-z.-]+)?$
caseIdobligatoriostringA content hash: sha256: followed by 64 lower-case hex digits.patrón ^sha256:[0-9a-f]{64}$
startedAtobligatoriostring (date-time)An ISO 8601 timestamp in UTC, for example 2026-09-26T04:12:00Z.
finishedAtobligatoriostring (date-time)An ISO 8601 timestamp in UTC, for example 2026-09-26T04:12:00Z.
inputsUsedobligatorioarray de InputPathWhich parts of the case the model actually read, as input paths.máx. 50 elementos
parametersmapa de (string | number | boolean)Any parameters the model fitted or chose, so the result can be explained.
buildHashstringThe 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.

CampoTipoDescripción
idobligatoriostringAn 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._:-]*$
modelIdobligatorioModelIdA model identifier in the form vendor/model, lower case, for example shockai/site-law.
modelVersionobligatoriostringA semantic version. A result is always pinned to the exact version that produced it.patrón ^\d+\.\d+\.\d+(?:-[0-9A-Za-z.-]+)?$
caseIdobligatoriostringA content hash: sha256: followed by 64 lower-case hex digits.patrón ^sha256:[0-9a-f]{64}$
createdAtobligatoriostring (date-time)An ISO 8601 timestamp in UTC, for example 2026-09-26T04:12:00Z.
updatedAtobligatoriostring (date-time)An ISO 8601 timestamp in UTC, for example 2026-09-26T04:12:00Z.
statusobligatorio"queued"
progressnumberFraction 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.

CampoTipoDescripción
minnumber
maxnumber

Receiver

A place a prediction is wanted. It has a position, a resolved distance, or both.

Requiere al menos uno de position, distanceM

CampoTipoDescripción
idobligatoriostringAn 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._:-]*$
namestringlongitud mín. 1 · longitud máx. 200
kindobligatorioenumA seismograph location, a structure to protect, a lease or property boundary point, or any point of interest.monitorstructureboundarypoint
positionSurfacePositionWhere 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.
distanceMnumberThe 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
distanceSourcestringWhere distanceM came from, for example manual, placement or georeference.longitud mín. 1 · longitud máx. 40
limitsobjectThe limits that apply here: a model reports exceedance probability against them, and a charge limit is held to the PPV limit.
limits.ppvMmSnumber> 0
limits.airblastDbLnumber> 0
limits.standardstringThe standard the limit comes from, for example AS 2187.2.longitud máx. 120

ReceiverPpv

Predicted peak particle velocity at a receiver.

CampoTipoDescripción
kindobligatorio"receiver_ppv"
receiverIdobligatoriostringAn 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._:-]*$
basisobligatorioPpvBasisHow peak particle velocity is taken: the largest single component (max_axis) or the peak vector sum (pvs).
ppvMmSobligatorioEstimatePeak particle velocity, mm/s.
dominantFrequencyHzEstimateFrequency at the peak, Hz.
scaledDistancenumberThe scaled distance the prediction was made at.> 0
exceedanceProbabilitynumberProbability of exceeding the receiver’s PPV limit, when it has one.≥ 0 · ≤ 1
validityobligatorioValidityHow far to trust one output.

ReceiverSpectrum

A predicted amplitude spectrum at a receiver.

CampoTipoDescripción
kindobligatorio"receiver_spectrum"
receiverIdobligatoriostringAn 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._:-]*$
spectrumobligatorioarray de objectThe spectrum, by ascending frequency.máx. 10000 elementos
spectrum[].frequencyHzobligatorionumber> 0
spectrum[].amplitudeobligatorionumberFourier amplitude, mm/s·s.≥ 0
validityobligatorioValidityHow far to trust one output.

ReceiverUnavailable

A kind answered per receiver that the model declined, at one receiver or at all of them.

CampoTipoDescripción
kindobligatorioenumreceiver_ppvmax_chargereceiver_waveformreceiver_spectrumairblast
receiverIdobligatoriostring | nullThe 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._:-]*$
reasonobligatorioenumWhy the model did not answer.not_supportedmissing_inputoutside_validityinsufficient_calibration
detailstringlongitud máx. 500

ReceiverWaveform

A predicted ground-motion time history at a receiver.

CampoTipoDescripción
kindobligatorio"receiver_waveform"
receiverIdobligatoriostringAn 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._:-]*$
percentilenumberWhich member of the distribution this trace represents, when the model samples.≥ 0 · ≤ 100
sampleRateHzobligatorionumber> 0
startMsobligatorionumberTime of the first sample from T0, ms.
frameobligatorioenumxyztvl
samplesobligatorioParticleVelocityThree-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.
validityobligatorioValidityHow far to trust one output.

RockClass

Coarse rock class used when no measured properties are available.

Valoressuper_softsoftmediumhard

RockDomain

A zone of rock the site treats as one material. Holes name the domain they sit in.

CampoTipoDescripción
idobligatoriostringAn 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._:-]*$
namestringlongitud mín. 1 · longitud máx. 120
rockClassRockClassCoarse class when nothing better is known.
densityKgM3numberIn-situ density, kg/m³.> 0
ucsMPanumberUniaxial compressive strength, MPa.> 0
youngsModulusGPanumberYoung's modulus, GPa.> 0
hoekBrownMinumberHoek–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
poissonsRationumberPoisson's ratio of the intact rock, between 0 and 0.5.> 0 · < 0.5
strengthStageStrengthStageWhich 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.
strainCriterionStrainCriterionA 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.
pWaveVelocityMsnumberP-wave velocity, m/s.> 0
rmrnumberRock mass rating (Bieniawski).≥ 0 · ≤ 100
gsinumberGeological strength index.≥ 0 · ≤ 100
kuzRamRockFactornumberKuz-Ram rock factor A, when calibrated.> 0

RunningRun

Started and not yet finished.

CampoTipoDescripción
idobligatoriostringAn 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._:-]*$
modelIdobligatorioModelIdA model identifier in the form vendor/model, lower case, for example shockai/site-law.
modelVersionobligatoriostringA semantic version. A result is always pinned to the exact version that produced it.patrón ^\d+\.\d+\.\d+(?:-[0-9A-Za-z.-]+)?$
caseIdobligatoriostringA content hash: sha256: followed by 64 lower-case hex digits.patrón ^sha256:[0-9a-f]{64}$
createdAtobligatoriostring (date-time)An ISO 8601 timestamp in UTC, for example 2026-09-26T04:12:00Z.
updatedAtobligatoriostring (date-time)An ISO 8601 timestamp in UTC, for example 2026-09-26T04:12:00Z.
statusobligatorio"running"
progressnumberFraction 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.

Valoressquare_rootcube_root

SeedWaveform

A single-hole ground-motion record: the kinematic input a superposition model is calibrated from.

CampoTipoDescripción
idobligatoriostringAn 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._:-]*$
holeIdstringThe single hole that produced it.longitud mín. 1 · longitud máx. 128 · patrón ^[A-Za-z0-9][A-Za-z0-9._:-]*$
receiverIdstringWhere it was recorded.longitud mín. 1 · longitud máx. 128 · patrón ^[A-Za-z0-9][A-Za-z0-9._:-]*$
distanceMobligatorionumberCharge-to-sensor distance, m.> 0
chargeKgobligatorionumberCharge mass of the seed hole, kg.> 0
sampleRateHzobligatorionumber> 0
frameobligatorioenumComponent frame: instrument axes, or transverse / vertical / longitudinal to the source.xyztvl
samplesobligatorioParticleVelocityThree-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.
recordedAtstring (date-time)An ISO 8601 timestamp in UTC, for example 2026-09-26T04:12:00Z.

SiteLaw

A fitted scaled-distance attenuation law.

CampoTipoDescripción
metricobligatorio"ppv"
basisobligatorioPpvBasisHow peak particle velocity is taken: the largest single component (max_axis) or the peak vector sum (pvs).
scalingobligatorioScalingCharge scaling for scaled distance: D/√Q for ground vibration, D/∛Q for airblast and near-field work.
kobligatorionumberSite constant K in PPV = K·SD^−β, mm/s.> 0
betaobligatorionumberAttenuation exponent β.> 0
sigmaLnnumberResidual standard deviation in natural-log units.≥ 0
nnumberReadings in the fit. Fractional when a regional prior lends the fit its weight in readings.≥ 0
scaledDistanceRangeThe scaled-distance range the fit was made over.
fitLawFitStatisticsWhat a prediction interval needs beyond σ and n.
frequencyBinsarray de FrequencyBinDominant frequency by scaled distance, from the site’s own readings.máx. 60 elementos
sourceobligatorioenumA 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.

CampoTipoDescripción
factorobligatorionumberThe 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
basisobligatorioenumWhat 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
blastRefstringWhich blast it was fitted on.longitud mín. 1 · longitud máx. 200
fittedWithobjectThe 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.modelIdobligatorioModelIdA model identifier in the form vendor/model, lower case, for example shockai/site-law.
fittedWith.modelVersionobligatoriostringA semantic version. A result is always pinned to the exact version that produced it.patrón ^\d+\.\d+\.\d+(?:-[0-9A-Za-z.-]+)?$
notestringHow 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.

CampoTipoDescripción
kindobligatorio"strain_amplitude"
factorobligatorioEstimateThe 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.
basisobligatorioenumWhat it was fitted to: the backbreak measured behind the holes.backbreak
holesobligatorioarray de objectEach hole the fit read, once.máx. 5000 elementos
holes[].holeIdobligatoriostringAn 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[].observedMobligatorionumberThe backbreak seen behind it, m.≥ 0
holes[].factorobligatorionumberThe least factor at which the model reports its radius as the backbreak, stated rounded up.> 0
validityobligatorioValidityHow 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.

CampoTipoDescripción
stageStrengthStageThe stage of failure the criterion describes; peak when unstated.
sigmaCiMPaobligatorionumberThe σci the constants were fitted or derived with, MPa.> 0
aobligatorionumberPer MPa, for strain as a fraction (not percent).
bobligatorionumberPer 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
cobligatorionumberPer MPa, for strain as a fraction.
lesserStrainRangeThe 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.
greaterStrainRangeThe 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.
basisobligatorioenumWhether the constants were regressed from measured failure strains (their eq. 14) or derived from E, μ and m (their eqs 5–7).regressionderived
notestringWhere 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.

CampoTipoDescripción
kindobligatorio"strain_field"
gridobligatorioGridA 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.
depthMobligatorionumberHow 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
columnsobligatoriointegerNodes along x: ⌊(maxX − minX) / cellM⌋ + 1.> 0
rowsobligatoriointegerNodes along y: ⌊(maxY − minY) / cellM⌋ + 1.> 0
valuesMicrostrainobligatorioarray de (number | null) | BlobRefPeak 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
thresholdMicrostrainobligatorionumberThe 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
validityobligatorioValidityHow far to trust one output.

StrengthStage

A stage of the progressive failure of intact rock, from the first cracks to the peak load.

Valorescrack_initiationstrain_localisationpeak

SucceededRun

Finished with the model’s result.

CampoTipoDescripción
idobligatoriostringAn 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._:-]*$
modelIdobligatorioModelIdA model identifier in the form vendor/model, lower case, for example shockai/site-law.
modelVersionobligatoriostringA semantic version. A result is always pinned to the exact version that produced it.patrón ^\d+\.\d+\.\d+(?:-[0-9A-Za-z.-]+)?$
caseIdobligatoriostringA content hash: sha256: followed by 64 lower-case hex digits.patrón ^sha256:[0-9a-f]{64}$
createdAtobligatoriostring (date-time)An ISO 8601 timestamp in UTC, for example 2026-09-26T04:12:00Z.
updatedAtobligatoriostring (date-time)An ISO 8601 timestamp in UTC, for example 2026-09-26T04:12:00Z.
statusobligatorio"succeeded"
resultobligatorioModelResultWhat a model returns for one case.

SurfacePosition

A place on the ground in the case coordinate system, metres, whose elevation may not be known.

CampoTipoDescripción
xobligatorionumberEasting, metres.
yobligatorionumberNorthing, metres.
znumberElevation, metres. Up is positive. Left out where the height was never surveyed: unknown, not zero.

TimingProposal

A proposed set of firing times.

CampoTipoDescripción
kindobligatorio"timing_proposal"
objectiveobligatoriostringWhat the proposal optimises, for example minimise P95 PPV at receiver R3.longitud mín. 1 · longitud máx. 500
holesobligatorioarray de objectmáx. 5000 elementos
holes[].holeIdobligatoriostringAn 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[].totalMsobligatorionumber
expectedarray de objectWhat the model expects the proposed timing to achieve.máx. 1000 elementos
expected[].receiverIdobligatoriostringAn 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[].ppvMmSobligatorioEstimateA 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.
validityobligatorioValidityHow 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.

CampoTipoDescripción
kindobligatorioenumWhat fills this interval of the hole.stemmingairwaterinert
topDepthMobligatorionumberDepth of the top of the deck along the hole, from the collar.≥ 0
bottomDepthMobligatorionumberDepth of the bottom of the deck along the hole.≥ 0

Validity

How far to trust one output.

CampoTipoDescripción
statusobligatorioenumWhether the inputs sit inside the range the model was validated on.withinextrapolatedoutside
codestringWhich 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_]*$
notestringlongitud máx. 500

VodMeasurement

A measured velocity of detonation.

CampoTipoDescripción
holeIdobligatoriostringAn 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._:-]*$
productIdstringAn 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._:-]*$
vodMsobligatorionumberMeasured velocity of detonation, m/s.> 0
methodobligatorioenumcontinuous_resistancepoint_to_pointoptical

Warning

Something the model wants a person to see.

CampoTipoDescripción
codeobligatoriostringA 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_.-]*$
messageobligatoriostringlongitud mín. 1 · longitud máx. 1000
targetstringWhat the warning is about: a hole id, a receiver id or a field path.longitud máx. 200