Frequently asked questions
The questions that come up most in CalCOFI meetings, each with a short answer and a link to where you do the thing. A word you do not know is probably in the glossary; anything missing here, ask with the feedback button (the speech bubble beside the light/dark switch).
What is CalCOFI.io, and how is it different from CalCOFI.org?
CalCOFI.org is the program: who we are, the cruises, how and where we sample, our publications and our policies. CalCOFI.io is the data: where you see it, download it and find out how to cite it. The two sites link to each other (CalCOFI.io’s pages carry a calcofi.org link in their header, and calcofi.org’s Visualize data page points here), so you should never need to know which one you are on to get a file. Where a dataset can also be downloaded from calcofi.org or from the group that collected it, its page on CalCOFI.io links to that original. Start at calcofi.io.
How do I download data?
Find the dataset in the list of datasets and press its Download button (on the dataset’s own page it is the yellow button near the top). CSV comes first: plain tables that open in Excel, Google Sheets, R or Python. An Excel workbook is offered too, wherever every table fits on an Excel sheet. Each download is one zip file holding the data tables, a readme, how to cite the data, its licence and a list of what every column means. If you want only one area or period, or one species or measurement from every dataset that has it, use the Explorer instead: choose what, when and where on the map, then press Download CSV.
Of the 20 datasets with a download, 16 come as an Excel workbook as well. Hydrographic Bottle, Bottle Derived Products, CTD Cast Files and CTD Derived Products have a table with more rows than an Excel sheet holds (just over a million), so they come as CSV, which Excel would cut short: open the CSV in R or Python, or use the Explorer to download only the years, area and measurements you need.
Which datasets are here?
The current release holds 20 datasets, each with its own page, its years and its provider. CalCOFI.io also lists 9 more that CalCOFI knows of but has not yet brought in (called holdings): their pages say where the data live today, but they cannot be downloaded from here yet. Both are in the list of datasets, which you can filter by kind of data, provider and licence; the front page’s Find and download a dataset (calcofi.io/#find) holds the same list with a search box.
Should I use the Explorer or a dataset’s page?
Use a dataset’s page when you want that one dataset whole, as its provider published it: what it is, who collected it, its years, how to cite it and its download. Use the Explorer when you want one species (say, sardine larvae) or one measurement (say, temperature or oxygen) from every dataset that has it, or only one area, period, season or depth: you see it on a map first, then download the table behind the map. Both read the same release, so their numbers agree.
What does “integrated” mean?
Each dataset arrives in its provider’s own format, with its own station names, cruise codes, species names and units. CalCOFI.io translates them all into one shared set: the same station grid, the same cruise identifiers, one species list tied to the World Register of Marine Species, and one list of measurements, each with its unit. That is what “integrated” means: a count of fish larvae and a bottle temperature from the same station on the same cruise can sit on one map and in one table without your having to match anything up. The provider’s own identifiers are kept beside the shared ones, so nothing is lost; The database explains how, for the curious.
Is this the official copy, and how current is it?
The original of each dataset belongs to its provider, the group that collected it: every dataset page names the provider and links the original (“Original at …”). CalCOFI.io holds a copy of them all in releases: dated snapshots of the whole database, each with a DOI (a permanent link to cite) and never changed once published. The current release is v2026.11.14, published 14 November 2026 (DOI 10.5281/zenodo.24223907); a new one comes out whenever the data change enough to matter, 20 in the last 90 days. If you know a provider has newer data than a dataset page shows, tell us with the feedback button. Every release is listed in Releases.
How do I cite it?
Cite two things: each dataset you used (the people who collected it) and the CalCOFI.io release you got it from (the work that put them together). Both citations are on every dataset page under Cite, in every download (the CITATION file in the zip), and behind How to cite in the Explorer. The current release’s citation is:
CalCOFI (2026). CalCOFI Integrated Database, release v2026.11.14 [Data set]. Scripps Institution of Oceanography, NOAA Fisheries, and California Department of Fish and Wildlife. https://doi.org/10.5281/zenodo.24223907
Cite this data has every dataset’s citation and how to cite from R or Python.
What am I allowed to do with the data?
Each dataset states its own licence, the terms on which you may reuse it, on its page and in its download, and they are not all the same. In v2026.11.14, 7 datasets are under CC BY 4.0 (reuse freely, with credit), 1 is in the public domain (CC0), 6 follow their provider’s own terms, and 6 have no licence established yet. For a dataset with none, the page says so and gives the address to ask (data@calcofi.io) before you redistribute it; CalCOFI does not choose a licence on a provider’s behalf. The Licence filter on the list of datasets shows which is which.
Do I need to sign up or fill in a form?
No. Nothing on CalCOFI.io asks you to sign in, register or fill in a form before you look at data or download it: not the dataset pages, not their downloads, not the Explorer, not the R and Python packages. If the data end up in something you publish or build, you are encouraged (never required) to register your use, so the providers get credit and your work can be linked back: Register a product in the Explorer’s Help menu does it (how).
How do I contribute data or report a problem?
To contribute a dataset, write to data@calcofi.io; Providing data to CalCOFI says what a dataset needs and what happens next, including that you see your data on a private copy of the site and say yes before anything is public. To report a problem (a value that looks wrong, a broken link, a page that confused you), use the feedback button on any CalCOFI.io page: the speech bubble at the top, or Send feedback at the foot of the page. It takes a picture of what you are looking at, lets you mark it up, and sends it with your note to the team. It is also filed as a public issue, so anyone can follow the fix; your email address is optional and never made public.
Is there a tutorial?
Yes. The Explorer has a guided tour that walks you through it in the app itself: open Help at the top and choose Take the tour, or press ?. The Explore chapter is the written version of the same walk, with a picture of what you should see at each stop.
Can I get the data in R or Python?
Yes. The calcofi4r package for R and calcofi4py for Python read the current release in a few lines, fetching only the rows you ask for rather than whole files, and cc_cite() in both gives the citations for exactly the datasets you used. Nothing needs a password or an account. Access the data shows how, with examples to copy.