Data & Researchers · open scienceMIT code · CC-BY data

Open data, open code.

Everything behind this project is public and reproducible. The models, the processed data, and the methods are on GitHub. If you study coral, symbionts, reef optics, or coastal oceanography, we would love your eyes on it, and there are specific measurements that would sharpen the science.

GitHub repository Methods & Data Open Questions Processed data
Start here

For the full, review-ready write-up, the Methods & Data page documents every dataset, the analysis pipeline, statistics, results (with figures), limitations, and data/code availability, written for scientific review and potential peer-reviewed publication. The Open Questions page is the live research agenda and data-request list.

What's in the repository

Repository layout. What lives in each folder of the public GitHub repository.
PathContents
/modelsEvery model as a runnable Python script: herbivory bistability, thermal/DHW, satellite ocean-color, turbidity shading, carbonate chemistry, sediment-plume + upwelling (Lagrangian), black-sand redox (PHREEQC), and the first-flush / dry-season-storm catalog + hypoxia setup-index.
/dataProcessed outputs: per-site metrics (CSV/JSON) and figures for each model.
/siteThis website (static HTML/CSS).
READMEMethods, data sources, and how to reproduce each result.

Code released under MIT; processed data and text under CC-BY 4.0. Large raw model fields (GLORYS subsets, particle trajectories) are available on request.

Data sources (all open)

Open data sources. The public datasets and field data behind the models, and where to get each. Full dataset table with resolutions is on the Methods & Data page.
SourceUsed forAccess
NOAA Coral Reef Watch 5 kmSST & Degree Heating Weeks, 1985, presentNOAA / PacIOOS ERDDAP
NASA MODIS-Aqua ocean colorTurbidity (Kd490) & chlorophyll, 2003-2022NOAA CoastWatch ERDDAP
Copernicus GLORYS12 reanalysisCurrents, subsurface temperature, upwellingCopernicus Marine Service
Airport METAR / ASOSJune-2023 storm ground-truth (La Ceiba, Roatán, San Pedro Sula)Iowa Environmental Mesonet
Black-sand XRF (6 scans, 2 sites)Sediment geochemistry driving the redox modelField XRF (Tela Coral), 2026
Field benthic surveysCoral cover, Diadema densityCoral Reef Alliance / Operation Wallacea

Reproducing the results

Quick start
Python 3.11 with numpy scipy pandas matplotlib PyCO2SYS runs the self-contained models (herbivory, thermal, ocean-color, turbidity, carbonate) directly. The Lagrangian sediment/upwelling model adds copernicusmarine + parcels + xarray. Each script prints its results and writes a CSV/figure. See the README for exact commands and parameters.

Where you could move the needle

The models make specific, falsifiable predictions. These measurements would confirm or kill them:

Where you could move the needle. Each falsifiable model prediction and the field measurement that would confirm or kill it.
Open questionMeasurement that would settle it
Acute-hypoxia trigger?In-situ dissolved-oxygen + CTD loggers on the reef, ideally before the next dry-season-break storm, to catch a stratification + oxygen crash in the act.
Is the black sand's manganese bioavailable?A benchtop leach assay of the iron-free lagoon sand (oxic vs anoxic), measuring dissolved Mn/Fe release plus its trace-metal profile. The single most useful next measurement for the treatment idea.
Heat-tolerant symbiont?Symbiodiniaceae typing (ITS2) of Banco Capiro corals, shallow vs deep. The one mechanism we cannot model.
Turbidity shading?In-situ PAR/temperature loggers by depth, and bleaching-vs-depth scoring during a heat event.
Carbonate subsidy?Total alkalinity, DIC and nutrients at the Ulúa mouth and over the reef; the alkalinity:DIC ratio.
Grazing budgetQuantitative Diadema and herbivore-fish transects to calibrate the bistability model.
Sub-bay circulationHigher-resolution or in-situ current/residence measurements the 1/12° model can't resolve.
Bleaching historyAny historical bleaching observations at Banco Capiro, by year and depth, to ground-truth the DHW record.

Draft outreach, for the team to send

Editable templates (not sent automatically). Add your own name, links and the recipient's specifics.

DRAFT · general collaboration
Subject: Banco Capiro reef, open models and a field trip

Hi [Name],

We are studying why Banco Capiro in Tela Bay holds 60 to 70% live coral in warm, turbid, nutrient-loaded water that is degrading the reefs nearby. We rebuilt the site from first principles and put the models and data online, and a team is going to measure the key clues on site.

Your work on [topic] lines up closely with what we are finding. If you are open to it, we would value your read on the approach, and there may be a natural collaboration around [symbiont genetics / reef optics / carbonate chemistry].

Everything is here: https://steps-re.github.io/rebel-reef and the code is at https://github.com/steps-re/rebel-reef

Thanks,
[Your name], Tela Coral
DRAFT · specific data or sample request
Subject: Symbiont typing for Banco Capiro corals

Hi [Name],

Quick, concrete ask. Our modeling can explain most of Banco Capiro's heat survival through shading, feeding and grazing, but not the shallow elkhorn, where we suspect a heat-tolerant symbiont. That is the one piece we cannot resolve without genetics.

On the upcoming trip we can collect tissue samples under the right permits. Would your lab be open to ITS2 typing of paired shallow and deep samples? We would share all data openly and credit the work.

Sampling window is [dates]. Details and methods: https://steps-re.github.io/rebel-reef/researchers.html

Thanks,
[Your name], Tela Coral

Who this might interest

coral, symbiont genetics labs turbidity / reef-optics refugia researchers Caribbean reef ecologists carbonate-chemistry / calcification groups Diadema / herbivory specialists coastal physical oceanographers

Reach out via Tela Coral or open an issue on the GitHub repository.