MAST Data Catalog

This is the documentation for using the MAST data catalog. MAST stands for the Mega Ampere Spherical Tokamak. This site provides documentation for accessing historical data and meta data from MAST. Here you can find descriptions and examples of the how to use the different APIs and endpoints that we provide for accessing data from MAST.

Warning

This documentation and the underlying catalog are still under construction! As such, the API may currently change without warning.

Tutorials

Below are tutorial notebooks showing examples of how to query metadata and load data from the catalog.

Overview

• Quickstart
• Bulk Download

Tutorials

• Tutorial: Exploring Shot Metadata
• Tutorial: Accessing Data with Intake & S3

Examples

• Data Gallery
• EFIT Data
• Thomson Scattering Data

APIs

• REST API Examples
• GraphQL Examples

Metadata API References

Below are quick links to documentation for different API endpoints

• REST API documentation

• GraphQL API documentation

License

Except where otherwise noted, the data hosted in the archive, the contents of the metadata database, and the content of this site is licensed under a Creative Commons Attribution-ShareAlike 4.0 International License.

Citing Us

If you use the data from this service for a scientific publication, we would appreciate citations to the service and the following paper:

@article{jackson2024fair,
  title={FAIR-MAST: A fusion device data management system},
  author={Jackson, Samuel and Khan, Saiful and Cummings, Nathan and Hodson, James and de Witt, Shaun and Pamela, Stanislas and Akers, Rob and Thiyagalingam, Jeyan and The MAST Team},
  journal={SoftwareX},
  volume={27},
  pages={101869},
  year={2024},
  publisher={Elsevier}
}