Ir al contenido

Empaquetar Registros

Use Empaquetar registros para reunir los datos del proyecto junto con sus metadatos y multimedia para publicación, archivo o análisis reproducible. Antes de escribir nada, Contenido del paquete muestra cada archivo, conteo de registros, columnas y advertencias.

FormatoElíjalo cuandoContieneNAHPU puede importarlo
Darwin Core Archive (.dwca.zip)Un museo o portal de biodiversidad (como GBIF) solicita DwC-AEspecímenes en una tabla central plana, con partes, medidas y multimedia en tablas de extensiónNo
Darwin Core Data Package (.dwc-dp.tar.gz)El destinatario admite el estándar relacional más reciente de Darwin CoreEspecímenes, eventos, identificaciones, partes y personas en tablas Darwin Core vinculadasNo
NAHPU Data Package (.nahpu-dp.tar.gz)Necesita todos los datos para análisis en R o Python, archivo a largo plazo o copia completaEl proyecto completo, todas las tablas pobladas de NAHPU, configuraciones de usuario y archivosSí, con Importar proyecto o Combinar proyecto

Los paquetes Darwin Core solo incluyen valores con un término exacto registrado en Darwin Core, Dublin Core o Audubon Core. Elija NAHPU Data Package cuando no pueda perderse ningún dato, incluidos los campos personalizados. Puede leerse con cualquier herramienta Frictionless; consulte el Tutorial 3.

  1. Abra el menú del proyecto y seleccione Empaquetar registros.
  2. Elija el formato del paquete B.
  3. Elija el formato de archivo comprimido C cuando el paquete admita más de un contenedor:
    • TAR.GZ es el predeterminado para paquetes de datos.
    • ZIP está disponible para herramientas y sistemas que prefieren archivos ZIP estándar.
    • Darwin Core Archive siempre usa ZIP.
  4. En un paquete Darwin Core, elija Todos los taxones A o Taxones seleccionados. Seleccionar mamíferos también incluye murciélagos.
  5. Escriba el nombre del archivo D (opcionalmente active Añadir fecha) y seleccione la carpeta de destino en escritorio.
  6. Revise Contenido del paquete E (en teléfonos, bajo la pestaña de contenido). Expanda cualquier recurso CSV F para inspeccionar sus columnas.
  7. Revise las advertencias, como multimedia faltante o el aviso de compatibilidad ZIP para DwC-DP.
  8. Seleccione Crear paquete G. Puede cancelar mientras se genera. Al terminar, compártalo, abra la carpeta, guarde una copia o elija Empaquetar otro.
ContenedorExtensiones típicasNotas
TAR.GZ.dwc-dp.tar.gz, .nahpu-dp.tar.gzPredeterminado para Data Packages y la opción recomendada por el estándar DwC-DP. Al extraer, datapackage.json y los metadatos quedan en la raíz.
ZIP.dwca.zip, .dwc-dp.zip, .nahpu-dp.zipObligatorio para Darwin Core Archive; opción normal para NAHPU Data Package; opción de compatibilidad para DwC-DP (muestra advertencia porque la guía DwC-DP prefiere gzip).

Las secciones siguientes explican qué archivos escribe cada paquete y cómo NAHPU asigna los registros. Úselas si un destinatario consulta la estructura o al procesar el paquete mediante scripts.

Un Darwin Core Archive (DwC-A) es un paquete de intercambio centrado en especímenes basado en las Darwin Core Text Guidelines.

Los grupos taxonómicos seleccionados determinan las ocurrencias incluidas. NAHPU sigue sus vínculos para añadir eventos de recolección, partes de especímenes y entidades materiales, mediciones, multimedia y personas (colectores, catalogadores, preparadores y creadores de multimedia). Los campos opcionales vacíos y las tablas de extensión vacías se omiten.

Solo se escriben columnas con un término exacto registrado de Darwin Core, Dublin Core o Audubon Core; los demás campos se omiten y se muestran como retenidos en Contenido del paquete. Use un NAHPU Data Package si necesita conservar absolutamente todos los valores.

  • meta.xml
  • eml.xml
  • occurrence.csv
  • material.csv
  • measurement_or_fact.csv
  • multimedia.csv
  • Directoriomedia/
    • …

Solo se crean los archivos con datos:

  • meta.xml describe el núcleo de ocurrencias, las extensiones, las posiciones de columna y las URI de términos Darwin Core.
  • eml.xml contiene metadatos a nivel de conjunto de datos.
  • occurrence.csv es siempre la tabla central.
  • Las extensiones apuntan al núcleo: las partes se exportan en material.csv, las medidas en measurement_or_fact.csv y multimedia.csv vincula cada ocurrencia con su ruta bajo media/.

Salida: <nombre-archivo>.dwca.zip.

Un Darwin Core Data Package (DwC-DP) representa datos Darwin Core como tablas relacionales normalizadas según la especificación Darwin Core Data Package y el modelo Frictionless Data Package.

  • datapackage.json
  • eml.xml
  • occurrence.csv
  • identification.csv
  • event.csv
  • material.csv
  • occurrence-assertion.csv
  • media.csv
  • agent.csv
  • occurrence-agent-role.csv
  • event-agent-role.csv
  • material-agent-role.csv
  • media-agent-role.csv
  • occurrence-media.csv
  • Directoriomedia/
    • …

Las tablas opcionales solo se escriben si hay datos. datapackage.json declara el perfil DwC-DP, cada recurso CSV, orden de campos, claves primarias, claves foráneas y predicados de relación. Las columnas estructurales _pk y _fk preservan los enlaces relacionales junto con los identificadores legibles.

NAHPU distribuye cada dato en la clase que corresponde al estándar en lugar de repetirlo en occurrence.csv:

  • occurrence: ocurrencia del espécimen;
  • identification: determinación y rangos taxonómicos;
  • event: actividad de recolección y localidad;
  • material: partes del espécimen, catálogo y preparación;
  • occurrence-assertion: mediciones y aserciones sin columna propia (como asociación con hospedero);
  • agent y *-agent-role: personas y roles (priorizando URL canónicas de ORCID, con UUID de NAHPU como respaldo);
  • media y occurrence-media: metadatos y vínculos multimedia.

Se aplica la misma regla estricta de términos registrados que en DwC-A. Las coordenadas DDM, DMS o UTM originales se conservan como texto literal, la extensión positiva de captura se suma a la incertidumbre de coordenadas y se mantienen las unidades de peso elegidas.

En invertebrados, sexo, etapa de vida, casta, asociación con hospedero y observaciones son términos de ocurrencia; la parte del hospedero y las medidas morfométricas opcionales (ancho cefálico, longitud corporal y envergaduras alar superior e inferior) salen como aserciones MeasurementOrFact en milímetros. La cobertura del dosel y los parámetros ambientales se asocian al evento de recolección con unidades definidas (°C, %, mg/L, m/s, mm, okta).

Salida: <nombre-archivo>.dwc-dp.tar.gz (predeterminado) o <nombre-archivo>.dwc-dp.zip (compatibilidad, con advertencia).

NAHPU Data Package es el formato completo y reproducible de NAHPU: un Frictionless Data Package con metadatos propios. A diferencia de los paquetes Darwin Core, no filtra por grupo taxonómico: empaqueta el JSON completo de transferencia del proyecto activo, tablas CSV tipadas equivalentes, mapeos de enumeraciones, instantáneas de vocabularios controlados, configuraciones de usuario y archivos asociados.

Es el único paquete que conserva campos personalizados sin término Darwin Core. Solo se exportan las tablas con datos en el proyecto (un proyecto solo de mamíferos no incluye tablas de aves, herpetofauna, invertebrados ni peces) y mappings/sqlite_enums.csv incluye únicamente las columnas enumeradas de esas tablas pobladas.

  • datapackage.json
  • nahpu.toml
  • nahpu-project.json
  • Directoriotables/
    • project.csv
    • ...
  • Directorioconfigs/
    • user_configs.json
  • Directoriomappings/
    • sqlite_enums.csv
  • Directoriovocabularies/
    • site.csv
    • events.csv
    • specimens.csv
    • symbionts.csv
  • Directoriofiles/
    • ...
  • Directoriomedia/
    • ...

Las tablas vacías se omiten de tables/ y datapackage.json, mientras que los recursos de metadatos (mappings/sqlite_enums.csv y vocabularies/*.csv) siempre se incluyen (solo con su fila de encabezados si no tienen registros).

nahpu-project.json es la misma carga versionada que genera Exportar proyecto (proyecto activo, registros relacionados, manifiesto multimedia, metadatos y advertencias), conservando distinciones como null frente a cadena vacía sin requerir SQLite. Los CSV bajo tables/ provienen de la misma carga para mantener coherencia; las colecciones vacías se conservan en nahpu-project.json para transferencia aunque se omitan como CSV.

mappings/sqlite_enums.csv traduce los índices enteros almacenados en las tablas exportadas. Cada fila registra tabla SQLite, columna, tipo de enumeración, índice entero desde cero, nombre estable en código y etiqueta legible de NAHPU.

Los mapeos incluidos (limitados a las tablas pobladas del paquete) cubren:

  • sexo del espécimen (mammalAttribute, birdAttribute, herpAttribute, invertebrateAttribute, fishAttribute y specimenIndividual), con códigos estables donde 0, 1 y 2 mantienen su significado histórico;
  • confianza de identificación (specimen.iDConfidence);
  • tipo de espécimen en peces (Individual / Lot) y casta en invertebrados;
  • campos reproductivos de mamíferos y categorías de ecolocalización;
  • campos reproductivos y de muda de aves.

Los enteros booleanos y las mediciones numéricas no son índices de enumeración y no aparecen en este archivo.

Cuatro recursos CSV registran los vocabularios controlados activos en la configuración de NAHPU (o los valores predeterminados si no se modificaron):

  • vocabularies/site.csv: tipos de sitio y tipos de hábitat;
  • vocabularies/events.csv: métodos de recolección y roles del personal;
  • vocabularies/specimens.csv: tipos de espécimen, tratamientos, condiciones, opciones habilitadas de sexo, métodos de identificación y etapas de vida;
  • vocabularies/symbionts.csv: tipos de interacción, categorías, métodos de detección, métodos de preparación, ubicaciones anatómicas, almacenamiento y tratamientos de simbiontes.

Cada fila incluye clave de configuración, nombre del vocabulario, posición desde cero y valor, permitiendo leerlos directamente sin analizar configs/user_configs.json.

datapackage.json usa el perfil estándar data-package, declarando cada tabla poblada como recurso tabular UTF-8 con orden de columnas, tipos, restricciones, claves primarias y foráneas, junto con los esquemas de enumeraciones, vocabularios y recursos no tabulares.

Extraiga el archivo comprimido antes de abrir datapackage.json, pues sus rutas son relativas a la raíz del paquete. Compruebe si existe una tabla opcional antes de leerla:

from collections import Counter
from frictionless import Package
package = Package("/path/to/extracted-package/datapackage.json")
print(package.resource_names)
if package.has_resource("specimen"):
specimens = package.get_resource("specimen").read_rows()
counts = Counter(row["taxonGroup"] or "Unspecified" for row in specimens)
print(counts)
library(frictionless)
package <- read_package("/path/to/extracted-package/datapackage.json")
resource_names(package)
if ("specimen" %in% resource_names(package)) {
specimens <- read_resource(package, "specimen")
print(table(specimens$taxonGroup, useNA = "ifany"))
}

Manifiesto de reproducibilidad, configuraciones y archivos

Sección titulada «Manifiesto de reproducibilidad, configuraciones y archivos»
  • nahpu.toml registra nombre y versión del formato, fecha y hora de exportación, versión y compilación de la aplicación, versiones de esquema de base de datos y configuraciones, conteos de tablas/enumeraciones/vocabularios y versiones de los crates de nahpu_api (nahpu_dp, nahpu_dwc, nahpu_db, nahpu_configs, entre otros).
  • configs/user_configs.json almacena la exportación versionada de configuraciones de usuario (configuración general, ajustes de exportación de registros, plantillas y diseños de documentos).
  • media/ y files/ incluyen la multimedia referenciada del proyecto, las fotos del personal referenciado (bajo media/ con rutas compatibles con transferencia) y las fuentes personalizadas instaladas (bajo files/). Los archivos faltantes generan advertencias.

Salida: <nombre-archivo>.nahpu-dp.tar.gz (predeterminado) o <nombre-archivo>.nahpu-dp.zip, con idéntico contenido interno.

Paquete Darwin CoreNAHPU Data PackageRespaldo de base de datos
Restaura un proyecto en NAHPUNoSí (Importar proyecto o Combinar proyecto)Sí (toda la instalación)
Propósito principalIntercambio con sistemas externosCopia documentada y reutilizable de un proyectoRecuperación completa del dispositivo

Un NAHPU Data Package abarca solo un proyecto, por lo que debe seguir creando respaldos de la base de datos periódicos.

Quienes deseen ampliar campos de paquetes o grupos taxonómicos pueden consultar Flujos de exportación y Agregar un grupo taxonómico.

Antes de escribir, NAHPU valida campos obligatorios y relaciones; al finalizar, reabre el archivo para confirmar que existan los metadatos raíz. Las advertencias —como multimedia faltante o modo de compatibilidad ZIP en DwC-DP— no siempre impiden la exportación, así que revíselas antes de compartir o depositar el paquete.