TC PRIMED Products
What are the data products?
In TC PRIMED, low-Earth-orbiting satellite observations of tropical cyclones serve as the anchor of the dataset. As a whole, TC PRIMED includes the following data:
- Tropical cyclone characteristics
- Multi-agency inter-calibrated, multi-channel microwave brightness temperatures (NASA Level 1C)
- Retrieved precipitation from the NASA Goddard Profiling Algorithm (GPROF; NASA Level 2A)
- GPM DPR-GMI and TRMM PR-TMI Combined Radar-Radiometer Product (NASA Level 2B)
- Multi-agency geostationary Satellite Infrared Brightness Temperatures (NOAA/STAR TC IRAR)
- ECMWF ERA5 reanalysis fields and derived environmental diagnostics
For specific information about the source for each data product, see the dataset documentation Tropical Cyclone Precipitation, Infrared, Microwave, and Environmental Dataset (TC PRIMED) Dataset Documentation for Version v01r01 and the data sources page.
Where can I access the products?
TC PRIMED is currently available through the NOAA Open Data Dissemination and the NOAA National Centers for Environmental Information (NCEI) at https://doi.org/10.25921/dmy1-0595.
See information in the Registry of Open Data on AWS for TC PRIMED and the associated Amazon Web Services S3 bucket at https://noaa-nesdis-tcprimed-pds.s3.amazonaws.com/index.html.
How are the data products structured on AWS?
In the TC PRIMED Amazon Web Services S3 bucket, the data directory structure is as follows
<TC PRIMED AWS URL>/<TC PRIMED Version>/<TC PRIMED Version Type>/<season>/<basin>/<annual number>/
where
- <TC PRIMED AWS URL> is the following URL https://noaa-nesdis-tcprimed-pds.s3.amazonaws.com
- <TC PRIMED Version> is the version number, currently v01r01
- <TC PRIMED Type> is the final or preliminary type
- <season> is the four digit season.
- This is the calendar year for the Northern Hemisphere.
- For the Southern Hemisphere, the year begins July 1, with the calendar year plus one.
- <basin> is the ocean basin.
- AL – North Atlantic basin, north of the Equator;
- SL – South Atlantic basin, south of the Equator;
- EP – North East Pacific basin, eastward of 140 degrees west longitude;
- CP – North Central Pacific basin, between the dateline and 140 degrees west longitude;
- WP – North West Pacific basin, westward of the dateline;
- IO – North Indian Ocean basin, north of the Equator between 40 and 100 degrees east longitude;
- SH – South Pacific Ocean basin and South Indian Ocean basin.
- <annual number> is the annual cyclone number from 01 to 49.
Are there sample files that I could look at?
Here are a few specific sample files near the time of the lifetime maximum intensity of Hurricane Florence (2018).
- An overpass file per satellite
- TCPRIMED_v01r01-final_AL062018_AMSR2_GCOMW1_033628_20180912181212.nc (13 MB)
- TCPRIMED_v01r01-final_AL062018_ATMS_NOAA20_004227_20180912070612.nc (4 MB)
- TCPRIMED_v01r01-final_AL062018_ATMS_NPP_035622_20180912061712.nc (4 MB)
- TCPRIMED_v01r01-final_AL062018_GMI_GPM_025795_20180912184512.nc (14 MB)
- TCPRIMED_v01r01-final_AL062018_MHS_METOPA_061733_20180912004612.nc (3 MB)
- TCPRIMED_v01r01-final_AL062018_MHS_NOAA18_068603_20180912004912.nc (3 MB)
- TCPRIMED_v01r01-final_AL062018_MHS_NOAA19_049447_20180912090812.nc (3 MB)
- TCPRIMED_v01r01-final_AL062018_SSMIS_F16_076888_20180912093012.nc (6 MB)
- ERA5 environment and storm metadata file (env)
How do I pull an entire storm or all of TC PRIMED?
You can download TC PRIMED data in bulk from the AWS S3 bucket using a UNIX-like terminal.
- Download and install the AWS Command Line Interface (https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-welcome.html)
- After installing AWS CLI, you can pull a directory using the following
Since TC PRIMED is a public dataset, you do not need an AWS credential.aws s3 cp s3://noaa-nesdis-tcprimed-pds/<path>/<to>/<aws>/<directory>/ /<path>/<to>/<local>/<directory>/ --recursive --no-sign-request
If you just want 2015 tropical cyclones in the North Atlantic, you would replace /<path>/<to>/<aws>/<directory>/ with
aws s3 cp s3://noaa-nesdis-tcprimed-pds/v01r01/final/2015/AL/ /<path>/<to>/<local>/<directory>/ --recursive --no-sign-request
Note: TC PRIMED is big (1.6 TB and growing) so you may not want to pull the entire dataset. The example above lets you pull a subset of files.
How do I interact with TC PRIMED files?
To help you learn how to interact with TC PRIMED files, the TC PRIMED development team has created a Learning Journey in partnership with the NOAA Center for Artificial Intelligence (NCAI).
In the NCAI concept, multiple Jupyter notebooks create a Learning Journey. Each notebook in the journey is independent of the other notebooks, which allows users to pick their entry point or notebooks of interest. The TC PRIMED Learning Journey contains seven notebooks split into five chapters.
-
Chapter 0: What is TC PRIMED?
-
Chapter 1a: NetCDF Files
-
Chapter 1b: The Overpass File
-
Chapter 1c: The Environmental File
-
Chapter 2: Composite Analysis
- Chapter 3: Pixel-based Artificial Neural Network Application
-
Chapter 4: Regridding Satellite Swath Data
Launch all notebooks in the Learning Journey using Jupyter lab via Binder via the badge below.
If you go through the learning journey material using Binder or Google Colab, your changes will not be saved unless you download the notebooks before exiting your browser tab.
Is TC PRIMED ready for my AI/ML application?
What is AI-ready data?
The NOAA Center for Artificial Intelligence (NCAI) is exploring the creation of an AI-ready data standard to assist in facilitating the use of NOAA data in artificial intelligence (AI) and machine learning. NCAI is working with stakeholders to identify requirements for an AI-ready dataset standard using guidelines provided by the Earth Science Information Partners Data Readiness Cluster. The cluster has produced a Checklist to Examine AI-readiness for Open Environmental Datasets and an AI-ready assessment matrix. These tools and guidelines are designed to help data providers and data users determine if the dataset is ready and applicable to their AI applications.
The questions and answers below provide information on how TC PRIMED addresses relevant AI-ready elements.
What is the data access for TC PRIMED?
TC PRIMED is in the machine-readable Network Common Data Form (NetCDF) file format. While this is the only file format available, NetCDF is easily converted to other file formats.
Once the data is available through NCEI, TC PRIMED users can use the NCEI search functionality to find subsets of the dataset. Users can interact with the data through the application programming interface via Thematic Real-time Environmental Distributed Data Services (THREDDS) Data Server (TDS). Both options allow users to avoid downloading the entire dataset.
Are there restrictions or restricted data in TC PRIMED?
No, there are no restrictions or restricted data in TC PRIMED.
Does TC PRIMED have standardized metadata?
Yes, TC PRIMED uses several machine-readable standards for metadata and naming conventions. These conventions, standard naming, and keywords provide information on the spatial and temporal extent, names for variables, standardized variable attributes, and instruments & platforms.
Does TC PRIMED have geospatial and temporal bound information?
TC PRIMED is a global dataset where subsets are provided for single tropical cyclones. For each file type, we provide geospatial and temporal bound information using standardized global and group-level attributes.
Where is TC PRIMED's data provenance information?
Each group provides provenance information through the source attribute. For detailed provenance information, see the Data Source.
Does TC PRIMED have quality control monitoring and uncertainty quantification?
Yes, the TC PRIMED team has taken steps to quality control the data sources while creating the dataset. For uncertainty quantification, we do not provide new uncertainty quantification information beyond what is available from our upstream data providers.
Is TC PRIMED data processed/derived/regridded?
Yes. Different parts of the dataset include different processing, derivation, and regridding steps and procedures. See the Data Source page for information.
Is TC PRIMED being used in other AI applications?
Yes. See the Publications page for publications using TC PRIMED. NOAA Center for Satellite Applications and Research and CIRA/CSU projects are actively using TC PRIMED in AI applications. More details forthcoming.
Does TC PRIMED have targets/labels?
TC PRIMED is a general dataset that is suitable for multiple AI/ML applications. As a result, TC PRIMED does not contain one set of targets/labels. However, it is common to use the Naval Research Laboratory Automated Tropical Cyclone Forecast (ATCF) system best-track database information from NOAA/NWS National Hurricane Center, NOAA/NWS Central Pacific Hurricane Center, and DOD Joint Typhoon Warning Center that is in the storm metadata group as targets/labels for tropical cyclone applications. But, other projects may end up using infrared or microwave brightness temperatures as the targets/labels.
Resolved Issues
— Helicity
We have fixed a variable in the TC PRIMED environmental files that was miscalculated. That variable is the helicity in the diagnostics group of the environmental files. In the previous calculation, we had used the u-wind variable for both the u-wind and v-wind components of the calculation. We have fixed this calculation to now use the u-wind variable and the v-wind variable for the respective u-wind component and v-wind component of the calculation. Please read the following Q and A to understand how this bug may impact you.
I’m not planning to use diagnostics/helicity. Do I need to do anything?
No.
How do I know if I have the latest files?
Files generated prior to 19 September contain information about the update in the global history attribute. Since TC PRIMED files are continually being created, files with the date_created attribute with dates after 19 September are unaffected.
— Best Track Changes
We updated TC PRIMED files to include post-season best-track changes by the US Department of Defense Joint Typhoon Warning Center. These changes affect the tropical cyclone central pressure and storm type, which may affect the environmental diagnostic calculations and storm metadata in all files. Please read the following Q and A to understand how this update may impact you.
Which storms are impacted?
IO052023 and IO082023
How big are the changes?
The tropical cyclone center latitude and longitude changes can differ relative to the previous version anywhere from 0.1 degrees to 0.8 degrees. Whereas the biggest difference in intensity from the previous version is 15 knots for SH192021. For EP082023, the National Hurricane Center updated the tropical cyclone position information from the Central Pacific Hurricane center, which adds two additional best-track entries on top of the described changes.
How do the changes affect TC PRIMED files?
The changes result in new values for the central pressure and storm type in both the TC PRIMED overpass files and environmental files.
— API and NCEI Archive Update
The screening step for the TC PRIMED API and NCEI Archive did not allow for DMSP-F08 and DMSP-F10 platform/satellite overpass files.
How were API users impacted?
API users would have seen an error setting the platform to F08 or F10. But, if they didn't specify these in file_type, then they would have received these overpasses. Version 1.0b of the API accepted the F08 or F10 platforms as the file_type value.
How was the NCEI Archive impacted?
The NCEI Archive rejected overpasses from the F08 or F10 platforms. These data have been backfilled.
Were files on NODD impacted?
No. If you pulled the files from NODD directly, you would not have experienced a problem, and no files were updated with this issue.
— Best Track Changes
We recently updated several TC PRIMED files to include post-season best-track changes by the NOAA NWS National Hurricane Center and Central Pacific Hurricane Center, and the US Department of Defense Joint Typhoon Warning Center. These changes affect the tropical cyclone center latitude and longitude, and/or intensity which, subsequently, may affect the environmental diagnostic calculations and passive microwave overpass availability. Please read the following Q and A to understand how this update may impact you.
Which storms are impacted?
WP092019, IO012020, SH062020, SH242020, SH262020, WP132020, SH012021, SH052021, SH122021, SH132021, SH152021, SH172021, SH192021, SH242021, WP062021, WP182021, WP222021, WP232021, and EP082023
How big are the changes?
The tropical cyclone center latitude and longitude changes can differ relative to the previous version anywhere from 0.1 degrees to 0.8 degrees. Whereas the biggest difference in intensity from the previous version is 15 knots for SH192021. For EP082023, the National Hurricane Center updated the tropical cyclone position information from the Central Pacific Hurricane center, which adds two additional best-track entries on top of the described changes.
How do the changes affect TC PRIMED files?
Environmental files: The changes in the tropical cyclone best-track position may affect the calculation of the environmental diagnostics.
Overpass files: The changes in the tropical cyclone best-track position affect the calculation of the overpass coverage fraction, and result in the inclusion of new overpasses and the exclusion of old overpasses, most prominently evident in EP082023.
Both environmental and overpass files: The differences in tropical cyclone best-track intensity results in new values for the tropical cyclone intensity and intensity change.
Is there a detailed documentation of the changes?
Users can find a list of detailed changes in the global “history” attribute in both the environmental and overpass files for the affected storms.
— Storm Heading
The TC PRIMED team discovered and addressed an issue in how a variable in the TC PRIMED files was calculated. That variable is the storm_heading in the overpass_storm_metadata group and it involves the conversion of the zonal and meridional components of storm motion to direction.
The team has fixed that variable and have uploaded the fixed TC PRIMED files onto the AWS S3 bucket. The fixed files are currently being uploaded to the NCEI repository.
I’m not planning to use overpass_storm_metadata/storm_heading. Do I need to do anything?
No. You are not impacted.
I don’t want to redownload the data. How can I address this in my copy of the files?
If you don't want to redownload and need overpass_storm_metadata/storm_heading, you can calculate the storm_heading yourself by using the storm_speed_meridional_component and storm_speed_zonal_component with something like
I've decided that I want to redownload the files. What’s the best way?
If you want to redownload all files, see details on this page for using the AWS Command Line Interface. If you only want a subset of files, check out our tcprimedapi Python API.
I see storm_heading in two groups in the env files: 1) overpass_storm_metadata and 2) storm_metadata. Is storm_heading impacted in both?
No. storm_metadata/storm_heading is unaffected. Only overpass_storm_metadata/storm_heading contained incorrect values.
How do I know if I have the latest files?
Files generated prior to 19 November contain information about the update in the global history attribute as well as the date_modified and date_metadata_modified global/group attributes. Since TC PRIMED files are continually being created, files with the date_created attribute with dates after 19 November are unaffected.
When will the fixed files be available?
We have uploaded the fixed files onto the AWS S3 bucket. We are also pushing the fixed files to NCEI. However, due to procedures internal to NCEI in making files available, we do not know when the files on NCEI will be updated. Again, please check the file metadata, as described above, to know if you have the latest update.
