Saltar al contenido principal
Menú para desarrolladores
Acceso anticipado

Importar resultados

La mayor parte del software de voladura se ejecuta en el escritorio de un ingeniero. Aun así, sus predicciones deben estar junto a las mediciones, para que puedan verse en contexto y puntuarse como cualquier otra.

El documento de importación

Una importación lleva las mismas salidas tipadas que una ejecución en vivo, más su origen: la herramienta, su versión, la familia de métodos y el archivo del que se exportaron los resultados. Nombra la voladura por su id en la plataforma cuando se conoce, o por su referencia en la herramienta de origen.

Cómo se procesará una importación

  1. Exporte las predicciones desde su herramienta y escríbalas como un documento de importación, siguiendo el esquema publicado.
  2. Valide contra el JSON Schema publicado antes de enviar.
  3. La plataforma adjunta las salidas a la voladura y conserva la procedencia de la fuente.
  4. Después de la voladura, las predicciones importadas se puntúan frente a las mediciones exactamente igual que una ejecución en vivo.

Validar un documento

El esquema es JSON Schema estándar (draft 2020-12), así que sirve cualquier validador conforme.

import Ajv2020 from 'ajv/dist/2020';
import addFormats from 'ajv-formats';

const schema = await fetch('https://app.shockai.co/developers/schemas/v0/ImportDocument.json').then((response) => response.json());

const ajv = new Ajv2020({ allErrors: true, strict: false });
addFormats(ajv);
const validate = ajv.compile(schema);

if (!validate(importDocument)) {
  console.error(validate.errors);
}

Ejemplo

Predicciones de un paquete de diseño de escritorio: PPV en un receptor y un alcance de proyección de rocas.

ImportDocument
{
  "specVersion": "0.1",
  "blast": {
    "externalRef": "B12-0926"
  },
  "source": {
    "tool": "Acme Blast Designer",
    "version": "7.2.0",
    "vendor": "Acme Mining Software",
    "method": "empirical",
    "file": {
      "name": "B12-0926-predictions.csv",
      "sha256": "sha256:5e5e5e5e5e5e5e5e5e5e5e5e5e5e5e5e5e5e5e5e5e5e5e5e5e5e5e5e5e5e5e5e"
    },
    "producedAt": "2026-09-25T22:40:00Z"
  },
  "outputs": [
    {
      "kind": "receiver_ppv",
      "receiverId": "R1",
      "basis": "pvs",
      "ppvMmS": {
        "median": 14.2,
        "percentiles": [
          {
            "p": 95,
            "value": 23.1
          }
        ]
      },
      "validity": {
        "status": "within"
      }
    },
    {
      "kind": "flyrock_zone",
      "maxThrowM": {
        "median": 61
      },
      "mechanism": "combined",
      "clearance": {
        "personnelM": 500,
        "equipmentM": 300
      },
      "validity": {
        "status": "within"
      }
    }
  ],
  "unavailable": [],
  "warnings": []
}