Final project for CAP 6737: Interactive Data Visualization by Luis A. Rivera (2018).
This project visualizes two global coral datasets from ReefBase: 6,190 coral bleaching observations (1963–2012) and 7,354 coral disease observations. The raw data were cleaned and recoded in R, then published as two interactive Tableau Public workbooks with maps, distributions, and scatter plots of bleaching and disease against water temperature, mortality, and area affected.
What the data shows:
- Disease records are concentrated in the Americas (69%, mostly the Caribbean). After "No disease" (1,494 records), the most reported diseases are black-band (1,248) and white-band (1,151).
- Mortality is unknown for 92% of bleaching observations, and water temperature is recorded for only 1,046 (17%), so the mortality and temperature views rest on a small subset of the data.
The coral datasets are in the data directory, a March 2018 snapshot from ReefBase, which is now offline. See data/README.md for each file's contents, encoding, source, and how to cite it.
Coral bleaching is the process by which coral loses its main source of food: the algae living inside its tissue Figure 1. When algae leave the coral, it becomes vulnerable to diseases. This can be caused by many factors such as changes in ocean temperature, ocean pollution, overexposure to sunlight, extreme low tides, overall climate changes (CO2), ocean acidification (pH level changes), climate precipitation, altered ocean currents, storms, sea level rise, global warming, among many others Figure 2.
In addition, coral can be affected by diseases caused by infections from bacteria, viruses or stressors as previously mentioned in Figure 2 which slowly kill the coral by consuming the living tissue or leaving large patches of coral tissue to slough off exposing coral’s skeleton. Some of these diseases are Black-band disease, Dark-spot disease, Patchy necrosis (white pox), White plague, White-band disease, Yellow-band disease, Algae disease, Fungal disease and many others. See Figure 3 to Figure 11 in Appendix for a visual picture of coral diseases.
The tables below describe how each cleaned file differs from its raw version (*Raw.csv). Blank changes mean the column was kept as is.
Data: CoralBleaching.csv (6,190 rows, from CoralBleachingRaw.csv by bleaching_analysis.R)
| Variable Name | Variable Changes |
|---|---|
| id | |
| region | Blanks recoded to the text "NA" (27 rows) |
| subregion | Blanks recoded to the text "NA" (27 rows) |
| country | |
| location | |
| lat | |
| lon | |
| month | Dropped |
| year | |
| depth | |
| severity_code | |
| bleaching_severity | Level "Severity Unknown" recoded to "Unknown" |
| coral_family | Families containing a comma or "and" grouped as "Mixed": 121 levels to 21 (counting blank). 95% of rows are blank |
| coral_species | |
| percentage_affected | Conversion to Numeric (74% of rows blank) |
| bleaching_duration | Dropped |
| mortality_code | Conversion to Categorical: codes 0–3 become No Mortality, Low, Medium, High; -1 and blank become Unknown (92% of rows) |
| mortality | Conversion to Numeric; values over 100 set to blank |
| recovery_code | Dropped |
| recovery | Dropped |
| survey_type | Dropped |
| survey_area | Dropped |
| water_temperature | Conversion to Numeric; values above 50 treated as Fahrenheit and converted to Celsius; capped at 32.22 °C (83% of rows blank) |
| other_factors | Dropped |
| remarks | Dropped |
| source | |
| reference_code | Dropped |
| country_code |
Data: CoralDiseases.csv (7,354 rows, from CoralDiseasesRaw.csv by diseases_analysis.R)
| Variable Name | Variable Changes |
|---|---|
| id | |
| disease_type | Diseases with fewer than 125 records, and unspecified disease, grouped as "Other": 51 levels to 10 |
| year | |
| lat | |
| lon | |
| region | Blanks recoded to the text "NA" (41 rows) |
| subregion | Blanks recoded to the text "NA" (41 rows) |
| country | |
| location | |
| nearest_town | |
| genus_species | |
| percentage_incidence | |
| disease_remarks | Dropped |
| mortality_percentage | |
| diseased_percentage | |
| reference_id | Dropped |
| remarks | Dropped |
| country_code | |
| source |
- One bleaching record (Tuo village, Solomon Islands) has latitude -10269, likely -10.269. It appears near Antarctica on the bleaching map.
- 19 bleaching records have water temperatures below 5 °C. These are probably temperature anomalies (degrees above normal) recorded in the same field, not absolute temperatures.
- Six disease records are dated 1780.
- Both disease files,
MonitoringSitesRaw.csv, andReefLocationsRaw.csvare Latin-1 encoded, not UTF-8.
coralviz/
├── data/ Raw (*Raw.csv) and cleaned CSVs, ReefBase field notes (*.txt), citation
├── images/ Figures used in this README
├── tableau/ Tableau workbooks and data extracts
├── bleaching_analysis.R Cleans CoralBleachingRaw.csv into CoralBleaching.csv
├── diseases_analysis.R Cleans CoralDiseasesRaw.csv into CoralDiseases.csv
└── lower_header.py One-off helper that lowercased CSV headers (legacy; its input file no longer exists)
MonitoringSitesRaw.csv and ReefLocationsRaw.csv were downloaded with the other datasets but are not used in the visualizations.
The scripts were written in 2018 for R 3.x and need two small changes to run today.
- Install R and the packages
ggplot2andstringr. - In each script, replace the
setwd("C:/Users/groot/...")line with the path to your copy of this repository. - On R 4.0 or later, add
stringsAsFactors = TRUEto theread.csv()call. Since R 4.0, text columns no longer load as factors, and the recoding steps depend on factors. Fordiseases_analysis.R, also addfileEncoding = "latin1". - Run
bleaching_analysis.Randdiseases_analysis.R. They writedata/CoralBleaching.csvanddata/CoralDiseases.csv. - Open the workbooks in
tableau/with Tableau Desktop or Tableau Public Desktop.
| Dashboard | Description |
|---|---|
| Bleaching Observations Map | Coral reef observations colored by bleaching severity across the world. |
| Coral Severity Levels | Overall number of coral reefs per bleaching severity (class). |
| Coral Mortality Levels | Overall number of coral reefs per mortality level (class). |
| Water Temperature over Years | Average water temperature over the years captured. Also displays it by bleaching severity. |
| Percentage of Corals Bleached by Water Temperature | Percentage of corals bleached during observation as water temperature increases (hotter). |
| Percentage of Corals Bleached by Mortality Level | Percentage of corals bleached during observation as mortality level increases. |
More Coral Bleaching Data Viz dashboards
| Dashboard | Description |
|---|---|
| Disease Observations Map | Coral reef observations colored by disease type across the world. |
| Coral Diseases | Overall number of coral reefs per disease. |
| Percentage of Coral Disease by Area Affected | Percentage of coral disease incidence (rate) versus diseases area affected in the coral reef. |
| Percentage of Coral Disease by Mortality Level | Percentage of coral disease incidence (rate) as mortality level increases. |
More Coral Disease Data Viz dashboards
Screenshots of every dashboard are in images/dashboards (captured October 2026). The packaged workbooks, with their data embedded, are in tableau/ as .twbx files and open in Tableau Desktop or Tableau Public Desktop.
Go to LICENSE for more information. Any work from NOAA or ReefBase must follow their respective citation, licensing and terms accordingly. Go to NOAA.gov or ReefBase.org for more information.
Links checked October 31, 2026.
[1] NOAA National Ocean Service. "Are corals animals or plants?" https://oceanservice.noaa.gov/facts/coral.html. Accessed April 21, 2018.
[2] ReefBase: A Global Information System for Coral Reefs. http://www.reefbase.org. Accessed March 2018. The site is now offline; see data/README.md for how to cite the data.
[3] National Geographic. "Coral Reefs 101." YouTube, November 7, 2017. https://www.youtube.com/watch?v=ZiULxLLP32s.
[4] NOAA National Ocean Service. "What is coral bleaching?" https://oceanservice.noaa.gov/facts/coral_bleach.html. Accessed March 2018.
[5] NOAA National Ocean Service. "How does climate change affect coral reefs?" https://oceanservice.noaa.gov/facts/coralreef-climate.html. Accessed March 2018.
[6] WorldFish. "Coral Bleaching Data." Harvard Dataverse, 2016. https://doi.org/10.7910/DVN/KUVQKY.
[7] UNEP-WCMC and NOAA. "Global Coral Disease Database" (legacy). 2010. https://resources.unep-wcmc.org/products/WCMC_PT045.
These images are included for informational and educational purposes only. Figures 1 and 2 are from the NOAA National Ocean Service [4][5]. Figures 3 to 11 were collected from public web sources in 2018, possibly including the references above, and their original sources were not recorded. None of these images are covered by this repository's MIT license, which applies to the code and documentation. If you own one of these images and would like it credited or removed, please open an issue.




















