Formato del Excel

TerrioLabs CAD lee el mismo formato que exporta TerrioLabs Drilling. Esta página describe qué hoja y qué columna busca cada dato — útil sobre todo si armas el Excel a mano en vez de exportarlo desde Drilling.

Si prefieres no armarlo desde cero, Connection tiene un botón para descargar una plantilla de ejemplo ya con el formato correcto.

Reglas generales

• Las columnas se leen por nombre, nunca por posición — el orden de las columnas no importa, solo sus encabezados.
• Los datos empiezan en la fila 3 de cada hoja (las dos primeras son encabezado).
• Una columna que el plugin no reconoce no rompe nada — simplemente se ignora.
• El plugin no valida tus datos (por ejemplo, que depth_from sea menor que depth_to). Revisarlos es responsabilidad de quien arma el Excel.

Hoja info

Formato de dos columnas (campo / valor), no tabular. Campo obligatorio:

Campo	Qué es
format_version	Versión del formato. El plugin exige la serie 4.x — un Excel 2.x o 3.x ya no carga.

Campos opcionales:

Campo	Qué es
project_name	Nombre del proyecto, que se muestra en Connection y en la tabla de coordenadas.
project_id	Identificador del proyecto. Es informativo —se muestra en Connection— y no una clave técnica: cambiarlo no rompe nada.
projection	Sistema de coordenadas, que se muestra en la tabla de coordenadas.

Desde v1.7 Las plantillas que descarga el plugin traen solo esos cuatro campos (formato 4.1.0). Un Excel con más campos —como los que exporta Drilling— carga igual: lo que el plugin no usa, lo ignora.

Hoja boreholes — un sondeo por fila

Columna	Obligatoria	Qué es
name	Sí	Nombre del sondeo. Debe ser único en la hoja.
group	No	Grupo al que pertenece el sondeo (ver abajo).
depth_total	Sí	Profundidad total perforada.
easting / northing	No	Coordenadas planas — necesarias para Ubicación en planta y Secciones.
latitude / longitude	No	Se guardan tal cual; el plugin no las reproyecta.
elevation	No	Cota de boca de pozo.

La columna group

Desde v1.7 Agrupa los sondeos en el árbol del panel Tool Space. Es texto libre: escribe el nombre que te sirva —“Apiques”, “Sondeos 20 m”, “Fase 2”— y los sondeos con el mismo texto quedan juntos. Una celda vacía va al grupo Sin grupo.

Cada grupo tiene su propio color y símbolo en planta, que eliges con clic derecho sobre el grupo en el árbol → Editar estilo… (ver Ubicación en planta). Ese estilo se guarda en el dibujo, no en el Excel, y está asociado al nombre del grupo: si lo renombras en el Excel, el grupo vuelve al estilo predeterminado.

Si tu Excel no tiene la columna group —por ejemplo uno exportado de Drilling—, los sondeos se agrupan por la columna status, como en versiones anteriores: in_progress, planned, paused, completed y cancelled se muestran como En progreso, Planeados, Pausados, Completados y Cancelados; cualquier otro valor va a Sin grupo.

Hoja materials — el estilo de cada material

Desde v1.7 Define una sola vez por material cómo se dibuja. Es opcional.

Columna	Obligatoria	Qué es
name	Sí	Nombre del material, igual al que usas en stratigraphy.material. Debe ser único en la hoja.
color	No	Color en hexadecimal. Si falta, el plugin asigna uno automáticamente.
pattern	No	Nombre del patrón de hatch de AutoCAD. Si no es válido, cae en SOLID.
pattern_scale	No	Escala del patrón. Si falta o es ≤ 0, usa 0.005.

El detalle de cada formato está en Perfil de sondeo.

• Con la hoja materials, el estilo sale de ahí, y las columnas color, pattern y pattern_scale de stratigraphy se ignoran. Un material que aparece en stratigraphy pero no en el catálogo se dibuja con color automático y relleno sólido.
• Sin la hoja, el estilo se sigue leyendo de esas columnas de stratigraphy, como en versiones anteriores.

Hoja stratigraphy — una capa por fila

Columna	Obligatoria	Qué es
borehole	Sí	Nombre del sondeo (debe existir en boreholes).
depth_from / depth_to	Sí	Profundidad inicial y final de la capa.
material	Sí	Nombre del tipo de material.
description	No	Descripción de la capa.
color / pattern / pattern_scale	No	Estilo del material, solo si el Excel no tiene la hoja materials.

Hoja water_tables — nivel freático

Columna	Obligatoria	Qué es
borehole	Sí	Nombre del sondeo.
water_level_depth	Sí	Profundidad del nivel de agua. Un sondeo puede tener varias filas: se dibujan todas.

Hojas samples e insitu_tests — dinámicas

Estas dos hojas son las más flexibles: solo tres columnas son fijas, el resto se lee dinámicamente y queda disponible para elegir en las gráficas y labels del perfil (ver Perfil de sondeo).

Hoja	Columnas fijas (obligatorias)
samples	borehole, depth_from, depth_to
insitu_tests	borehole, depth_top, depth_base

Cualquier otra columna —sample_type, recovery, rqd, los golpes crudos del SPT (n1/n2/n3), n, su_*, cu, o lo que necesites— se detecta sola, sea numérica o de texto. Los valores derivados (N del SPT, cu, sensibilidad…) se dibujan tal como llegan, sin que el plugin los recalcule — ese cálculo es responsabilidad de Drilling, no del plugin.