# Heimdall Research data dictionary

Marine occurrence deliverables for environmental and marine technical services demos.
Attribute names on GIS layers follow a short Navy SDS-like style. The OBIS-SEAMAP CSV
keeps Darwin Core / SEAMAP-friendly names.

## Sources

- OBIS (Ocean Biodiversity Information System): https://api.obis.org
- GBIF (Global Biodiversity Information Facility): https://api.gbif.org
- Land mask: Natural Earth 50m land, clipped to the Hawaiian Islands

## OBIS-SEAMAP-ready CSV (`exports/obis_seamap_export.csv`)

| Field | Type | Description |
| --- | --- | --- |
| occurrenceID | text | Stable occurrence identifier |
| scientificName | text | Species or lowest taxon name |
| vernacularName | text | Common name when present |
| taxonID | integer | WoRMS AphiaID when available |
| eventDate | text | Observation date (ISO) |
| year | integer | Observation year |
| decimalLatitude | float | Latitude WGS84 |
| decimalLongitude | float | Longitude WGS84 |
| coordinateUncertaintyInMeters | float | Coordinate uncertainty |
| individualCount | integer | Count of individuals |
| basisOfRecord | text | Observation / specimen basis |
| datasetName | text | Source dataset title |
| catalogNumber | text | Provider catalog number |
| institutionCode | text | Institution code |
| speciesGroup | text | Cetacean / Pinniped / Sea turtle |
| dataSource | text | OBIS or GBIF |
| dataVersion | text | Heimdall versioned store id |

## GIS layers (GeoPackage and shapefile)

| SDS-like name | Source field | Description |
| --- | --- | --- |
| OCC_ID | occurrence_id | Occurrence identifier |
| SPEC_NAME | scientific_name | Scientific name |
| SPEC_GRP | species_group | Species group |
| COM_NAME | common_name | Common name |
| APHIA_ID | aphia_id | WoRMS AphiaID |
| OBS_DATE | event_date | Observation date |
| OBS_YEAR | year | Observation year |
| LAT | decimal_latitude | Latitude |
| LON | decimal_longitude | Longitude |
| INDIV_CNT | individual_count | Individual count |
| BASIS_REC | basis_of_record | Basis of record |
| DATASET | dataset_name | Dataset name |
| CAT_NUM | catalog_number | Catalog number |
| INST_CODE | institution_code | Institution code |
| SRC_SYS | data_source | OBIS or GBIF |
| QA_PASS | qa_pass | Passed all QA checks |
| QA_FLAGS | qa_flags | Semicolon-separated QA flags |

CRS for all geometries: EPSG:4326 (WGS 84).

## Related demo products

- `quicklook_report.html` / `.pdf`: one-page summary with tables, chart, and static map
- `figures/`: chart and static map PNG files behind the report
- `tables/`: species counts and top QA failure tables
- `occurrence_map.html`: interactive Leaflet map
- `qa/qa_report.csv`: per-record pass/fail with reasons
