Estandarización con las extensiones Darwin Core

Objetivo

Conocer y utilizar las extensiones del estándar Darwin Core (DwC), siguiendo las buenas prácticas de documentación.

Convenciones

  • Los elementos del estándar Darwin Core aparecen en color verde y cursiva. Por ejemplo: measurementUnit.
  • Los archivos a utilizar en los ejercicios se muestran entre comillas angulares, negrita, y tienen una tipografía diferente. Por ejemplo: «archivo_Ejemplo.xls».
  • Las secciones, ventanas y componentes de las herramientas utilizadas se muestran entre comillas inglesas y en negrita. Por ejemplo: “Create Project”.
  • Las opciones de las herramientas que se asocian a instrucciones (dar clic, seleccionar, etc.) aparecen en color amarillo y cursiva. Por ejemplo: New project.
  • Las secuencias de instrucciones y pasos se muestran en color amarillo, cursiva y negrita. Por ejemplo: Paso 1 > Paso 2.
  • Las líneas que se escriben directamente en las herramientas, para programar o realizar algún proceso en específico, aparecen en formato de código, con una tipografía distinta de color negro. Por ejemplo: value.replace(“ sp.”,””).

Sobre la actividad

Utilizar tres de las extensiones más comunes del estándar DwC para incorporar información sobre rasgos funcionales, recursos multimedia y datos de la distribución de especies. Para esto se proporcionarán conjuntos de prueba y plantillas de publicación enfocadas en el uso de las extensiones DwC.

Requisitos

  • Para realizar este ejercicio, es necesario contar con un programa que procese archivos de texto. Por ejemplo, Excel.

Ejercicio 1 - Rasgos funcionales

Paso 1 - Caso de estudio

A partir de las notas de campo de algunos especímenes de la colección de la Universidad de Ciencias Naturales, la cual se encuentra publicada a través del SiB Colombia como un conjunto de datos de registros biológicos, se decide incorporar información sobre los rasgos funcionales de los especímenes. Usted cuenta con los datos de la colección, debidamente estructurados en DwC, y una tabla (sin estructurar) que relaciona rasgos funcionales de aves y reptiles a partir del número de catálogo. Su misión es estructurar los datos de los rasgos funcionales, utilizando la extensión Medidas o hechos (Measurement or Facts), para que estos puedan incluirse en la publicación de la colección.

Paso 2 - Exploración de la plantilla

Descargue y abra la «Plantilla de la extensión Medidas o hechos (Measurement or Facts, allí encontrará 4 pestañas:

  • Instrucciones: contiene la guía de uso y los puntos a tener en cuenta antes de iniciar la documentación de la extensión.
  • Plantilla: contiene la tabla con los elementos DwC para documentar la extensión.
  • Definiciones: contiene las descripciones de cada uno de los elementos del estándar DwC, recomendaciones de documentación y ejemplos.

2.1. Pestaña Instrucciones

Lea las instrucciones de esta primera pestaña para familiarizarse con el contenido y alcance de la misma. Encontrará una sección titulada Elementos obligatorios según el tipo de los datos (Fig. 1). De acuerdo a la lectura del Paso 1 y los datos de ejemplo «Ejercicio1_MedidasoHechos_porEstructurar.xlsx», identifique cuáles son los elementos obligatorios para el uso de la extensión y téngalos en cuenta para el paso 3.

Figura 1. Elementos obligatorios de la extensión para publicar registros biológicos

Figura 1. Elementos obligatorios de la extensión para publicar registros biológicos.

2.2. Plantilla

Explore los elementos de la extensión en la pestaña de plantilla. Allí encontrará algunos ejemplos pre-documentados en gris para facilitar la interpretación y el alcance de los elementos. Puede mantener estos ejemplos como referencia o eliminarlos antes de usar la plantilla. Estos marcan un punto de partida, pero no representan todas las posibilidades de la extensión, ya que las medidas pueden variar según las fuentes de datos.

2.3. Definiciones

Revise la definición de los elementos de la extensión, haciendo clic en los elementos de la plantilla. Esto le permitirá ver la definición del elemento y algunos ejemplos de documentación.

Paso 3 - Mapeo de los datos

Una vez que haya explorado la extensión e identificado los elementos obligatorios, revise detenidamente el archivo «Ejercicio1_MedidasoHechos_porEstructurar.xlsx» y ubique los elementos de la extensión que le permitirán estructurar las medidas. Esta actividad recibe el nombre de mapeo de datos. Revise la definición de los elementos y sus ejemplos para corroborar la correspondencia del mapeo.

3.1. Identificar el tipo de medidas o hechos

Teniendo en cuenta que las medidas se pueden dividir en dos categorías, identifique el tipo de cada una.

  • Cuantitativas (medidas): son variables cuantificables que cuenta con una unidad de medida. Por lo tanto, se asocian a los elementos measurementType, measurementValue y measurementUnit. Por ejemplo:
    • measurementType: largo del pico.
    • measurementValue: 20.
    • measurementUnit: mm.
  • Cualitativas (hechos): son variables categóricas que guardan algún tipo de lógica, pero no están asociadas directamente a una unidad de medida. Por consiguiente, se asocian a los elementos measurementType y measurementValue. Por ejemplo:
    • measurementType: color del pico.
    • measurementValue: amarillo.

3.2. Mapeo de elementos

De acuerdo al paso anterior, ahora deberá mapear las medidas en los elementos de la extensión. Puede duplicar los elementos tantas veces como se requiera. Por ejemplo, puede duplicar los elementos measurementType, measurementValue, measurementUnit y measurementDeterminatedBy para documentar las medidas de «Altura de percha» y «Longitud rostro cloacal» (Fig 2). Haga lo mismo para las medidas faltantes.

Figura 2. Mapeo de la medida 1 «Altura de la percha» y la medida 2 «Longitud rostro cloacal» con duplicación de los elementos de la plantilla

Figura 2. Mapeo de la medida 1 «Altura de la percha» y la medida 2 «Longitud rostro cloacal» con duplicación de los elementos de la plantilla.

3.3. Estructurar el elemento occurrenceID

Para usar cualquier extensión, es necesario contar con un identificador (ID). Este permite enlazar la extensión con los datos. En este ejercicio, el occurrenceID cumple el rol de identificador, ya que los datos corresponden a registros biológicos («Ejercicio1_Registrosbiológicos_Estructurado.xlsx»). Por lo tanto, es necesario asegurarse de que el occurrenceID de la extensión Medidas o hechos coincida exactamente con el del conjunto de datos estructurado. Haga los ajustes necesarios para que coincidan (Fig. 3).

Figura 3. Diferencia entre el occurrenceID del conjunto de datos de registros biológicos y el del elemento mapeado en la extensión

Figura 3. Diferencia entre el occurrenceID del conjunto de datos de registros biológicos y el del elemento mapeado en la extensión.

Paso 4 - Ajustar los datos

4.1. Ajustar según definiciones y ejemplos

Una vez mapeados los datos del archivo «Ejercicio1_MedidasoHechos_porEstructurar.xlsx» en la plantilla de la extensión, ajuste las columnas de acuerdo a las definiciones del estándar DwC para cada elemento (Fig. 4).

Figura 4. Datos ajustados según las definiciones y los vocabularios controlados

Figura 4. Datos ajustados según las definiciones y los vocabularios controlados.

4.2. Eliminar los elementos vacíos y filas de ejemplo

Elimine las columnas de los elementos DwC que quedaron vacías en la plantilla de Medidas o hechos. Recuerde que para la publicación solo debe mantener los elementos que hayan sido documentados (Fig. 5). También puede eliminar los ejemplos resaltados en gris, ya que que estos solo son una ayuda para el mapeo de los elementos en la plantilla.

Figura 5. Cómo eliminar los elementos vacíos

Figura 5. Cómo eliminar los elementos vacíos. Clic derecho en la columna > Eliminar.

Paso 5 - Verificación del resultado

Compare el siguiente «archivo estandarizado» con el archivo que trabajó en el ejercicio para identificar aciertos y posibilidades de mejora. ¿Logró construir correctamente las extensiones?

Tenga en cuenta que existen dos formas válidas de documentar esta extensión. La primera es añadir los elementos DwC tantas veces como sea necesario, al igual que en el ejercicio anterior. La segunda es insertar una fila para cada medida. Esto es posible porque cada fila se puede relacionar al espécimen por medio del identificador, en este caso, el occurrenceID (Fig. 6).

Figura 6. Segundo mecanismo de documentación de la extensión de Medidas o hechos en forma de filas sin duplicar elementos DwC

Figura 6. Segundo mecanismo de documentación de la extensión de Medidas o hechos en forma de filas sin duplicar elementos DwC.

En el archivo descargado, encontrará las dos formas de estructurar la extensión.

Ejercicio 2 - Distribución de especies

Paso 1 - Caso de estudio

Está participando en un proyecto para realizar una lista de especies de las aves en la reserva del Pantano de Martos, en el municipio de Guatavita (Código Divipola: 25326), y definir su estrategia de conservación. El investigador principal ha revisado los datos publicados a través del SiB Colombia y la literatura del municipio para crear y estructurar la lista de especies según el estándar DwC. Adicionalmente, usted quiere añadir los datos de la distribución de las especies y sus estados de amenaza. Estos datos deben ser incorporados en la publicación de la lista por medio de la extensión Distribución de especies (Species Distribution). Su misión es usar la extensión para estructurar los datos de distribución de especies.

Paso 2 - Exploración de la plantilla

Descargue y abra la «Plantilla de la extensión Distribución de especies (Species Distribution, allí encontrará 4 pestañas:

  • Instrucciones: contiene la guía de uso y los puntos a tener en cuenta antes de iniciar la documentación de la extensión.
  • Plantilla: contiene la tabla con los elementos DwC para documentar la extensión.
  • Definiciones: contiene las descripciones de cada uno de los elementos del estándar DwC, recomendaciones de documentación y ejemplos.
  • Vocabulario: contiene los vocabularios controlados para algunos elementos del Darwin Core.

En la pestaña de instrucciones, encontrará una sección adicional titulada “Elementos obligatorios según el tipo de los datos”. El único elemento obligatorio para esta extensión es el taxonID, el cual se construye a partir del archivo «Ejercicio2_ListadeEspecies_Estructurado.xlsx», como se indica en el siguiente paso.

Explore los elementos de la extensión en la plantilla, haciendo clic en los elementos para acceder a las definiciones y vocabularios controlados (cuando corresponda). Allí encontrará algunos ejemplos pre-documentados en gris para facilitar la interpretación y el alcance de los elementos. Puede mantener estos ejemplos como referencia o eliminarlos antes de usar la plantilla. Estos marcan un punto de partida, pero no representan todas las posibilidades de la extensión, ya que el alcance temático y geográfico de cada lista de especies es diferente.

Paso 3 - Mapeo de los datos

Observe detenidamente el nombre y contenido de cada columna del archivo «Ejercicio2_DistribuciónEspecies_porEstructurar.xlsx», identificando a cuál elemento de la extensión corresponde. Revise la definición de los elementos y sus ejemplos para corroborar la correspondencia del mapeo (Fig. 7).

Figura 7. Mapeo de datos en la plantilla Distribución de especies (Species Distribution)

Figura 7. Mapeo de datos en la plantilla Distribución de especies (Species Distribution).

Para usar cualquier extensión, es necesario contar con un identificador (ID). Este permite enlazar la extensión con los datos. En este ejercicio, el taxonID cumple el rol de identificador, ya que los datos corresponden a una lista de especies. Por consiguiente, a partir del nombre científico en «Ejercicio2_DistribucionEspecies_porEstructurar.xlsx», identifique el taxonID en el archivo «Ejercicio2_ListadeEspecies_Estructurado.xlsx» y cópielo en el elemento taxonID de la «Plantilla de la extensión Distribución de especies (Species Distribution (Fig. 8).

Figura 8. Documentación del taxonID en la plantilla Distribución de especies a partir de la lista de especies

Figura 8. Documentación del taxonID en la plantilla Distribución de especies a partir de la lista de especies.

Paso 4 - Ajustar los datos

4.1. Ajustar según definiciones y ejemplos

Una vez mapeados todos los datos del archivo «Ejercicio2_DistribucionEspecies_porEstructurar.xlsx» en la plantilla de la extensión, ajuste las columnas de acuerdo a las definiciones y vocabularios controlados del estándar para cada elemento.

4.2 Completar la información geográfica

En el caso de estudio se le proporcionó el ID de la geografía superior según Divipola. Documente los elementos countryCode y locationID, según esta información y la definición del elemento (Fig. 9).

Figura 9. Estandarización de elementos de acuerdo a las definiciones del estándar Darwin Core

Figura 9. Estandarización de elementos de acuerdo a las definiciones del estándar Darwin Core.

4.3. Eliminar los elementos vacíos y filas de ejemplo

Elimine las columnas de los elementos DwC que quedaron vacías en la «Plantilla de la extensión Distribución de especies (Species Distribution. Recuerde que para la publicación solo debe mantener los elementos que hayan sido documentados. También puede eliminar los ejemplos resaltados en gris, ya que que estos solo son una ayuda para el mapeo de los elementos en la plantilla.

Paso 5 - Verificación del resultado

Compare el siguiente archivo, estandarizado según las definiciones del Darwin Core, con el archivo que trabajó en el laboratorio para identificar aciertos y posibilidades de mejora. ¿Logró construir correctamente las extensiones?

Descargue el «archivo estandarizado».

Ejercicio 3. - Recursos multimedia

Paso 1 - Aplicar lo aprendido

A partir de los ejercicios previos, se puede deducir que las extensiones funcionan de forma similar. Por lo tanto, este ejercicio consiste en estructurar la extensión Multimedia simple (Simple Multimedia) a partir de lo aprendido anteriormente.

El archivo «Ejercicio3_Registrosbiológicos_Estructurado.xlsx» se encuentra estructurado en DwC y contiene los datos de una colección de microorganismos. Se desea asociar las cepas de dichos microorganismos a imágenes de referencia, las cuales se encuentran enlazadas en el archivo «Ejercicio3_Multimedia_porEstructurar.xlsx». El primer paso consiste en estructurar las imágenes, usando la «Plantilla de la extensión Multimedia simple (Simple Multimedia.

### Paso 2 - Verificación del resultado Compare el siguiente archivo, estandarizado según las definiciones del Darwin Core, con el archivo que trabajó en el laboratorio para identificar aciertos y posibilidades de mejora. ¿Logró construir correctamente las extensiones?

«Archivo estandarizado»

Ejercicio 4 - Datos propios

Si tiene datos propios que desee publicar, estandarícelos siguiendo los pasos de esta guía. Recuerde usar la plantilla de acuerdo al tipo y origen de los datos.

En este ejercicio, notará que las imágenes se encuentran en un repositorio. Si a futuro desea publicar imágenes asociadas a un registro biológico, es recomendable usar el recurso que mejor se adapte a sus necesidades. Algunos de los repositorios disponibles son:


¡Felicitaciones! Ha aprendido a estructurar datos adicionales con las extensiones del estándar Darwin Core. **

Atribución y uso de los laboratorios

La licencia CC-BY permite usar, redistribuir y construir sobre estos contenidos libremente.

¡La difusión de estos laboratorios contribuirá a la publicación de más y mejores conjuntos de datos sobre biodiversidad!

Citación sugerida

Plata C., Ortíz R., Marentes E., Lozano J. (2021). Laboratorio de datos, Ciclo de formación. Consultado a través del SiB Colombia. Disponible en https://biodiversidad.co/formacion/laboratorios.

Fuentes:

  • Datos y caso de uso del Ejercicio 2 basado en: Asociación Bogotana de Ornitología (2011). Aves del Pantano de Martos, Guatavita, Cundinamarca, 94 especies aportadas por Ruiz-Ovalle, J. (Coordinador de Proyecto), Camargo, P. (Investigador Principal, Proveedor de Contenido, Proveedor de Metadatos y Publicador), En línea, https://doi.org/10.15472/7p2n83.

  • Datos y caso de uso del Ejercicio 3 basado en: Alvarado Fernández A M, Rodríguez Gómez E R, Palacios Calderón L M, Trespalacios Rangel A A, Ballesteros Ballesteros J A (2021): Colección de Microorganismos-Pontificia Universidad Javeriana. v1.7. Pontificia Universidad Javeriana. Dataset/Occurrence. https://doi.org/10.15472/ppbz1y.