diff --git a/docs/assets/img/MATE-diagram.png b/docs/assets/img/MATE-diagram.png new file mode 100644 index 00000000..65883510 Binary files /dev/null and b/docs/assets/img/MATE-diagram.png differ diff --git a/docs/assets/img/MATE.png b/docs/assets/img/MATE.png new file mode 100644 index 00000000..974e2dc3 Binary files /dev/null and b/docs/assets/img/MATE.png differ diff --git a/docs/pages/domains/climate_science.md b/docs/pages/domains/earth_science.md similarity index 63% rename from docs/pages/domains/climate_science.md rename to docs/pages/domains/earth_science.md index 75cbea80..d50d392e 100644 --- a/docs/pages/domains/climate_science.md +++ b/docs/pages/domains/earth_science.md @@ -1,8 +1,10 @@ --- title: Climate Science & Earth sciences -description: The study of climate and weather. +description: The study of the Earth, including geology, atmosphere, climate, hydrology, and more. icon: fa-cloud-sun -page_id: climate_science +page_id: earth_science +redirect_from: + - climate_science related_pages: tasks: [curation, data_handling, manage_data] roles: [data_analyst, researcher] diff --git a/docs/pages/roles/trainer.md b/docs/pages/roles/trainer.md new file mode 100644 index 00000000..f8870cb7 --- /dev/null +++ b/docs/pages/roles/trainer.md @@ -0,0 +1,11 @@ +--- +title: Trainer +description: A trainer is responsible for encouraging and guiding researchers and scientists in effectively managing their data. In this context, a trainer may develop and/or deliver training material which includes RO-Crate as a topic. +icon: fa-paperclip +page_id: trainer +--- +{% include item_details.html %} + +{% include related_use_cases.html %} + +{% include related_pages.html %} diff --git a/docs/pages/tasks/training.md b/docs/pages/tasks/training.md new file mode 100644 index 00000000..93be1769 --- /dev/null +++ b/docs/pages/tasks/training.md @@ -0,0 +1,11 @@ +--- +title: Training +description: Develop and/or deliver training material +icon: fa-list-check +page_id: training +--- +{% include item_details.html %} + +{% include related_use_cases.html %} + +{% include related_pages.html %} diff --git a/docs/pages/use_cases/autosubmit.md b/docs/pages/use_cases/autosubmit.md index 8c8b6c96..405fd289 100644 --- a/docs/pages/use_cases/autosubmit.md +++ b/docs/pages/use_cases/autosubmit.md @@ -6,7 +6,7 @@ title: Autosubmit description: Autosubmit is an open source Python experiment and workflow manager used to manage complex workflows on Cloud and HPC platforms. Autosubmit uses RO-Crate to package the configuration, traces (logs, metrics, databases, etc.), and data of experiments and workflows. url: https://autosubmit.readthedocs.io/ image: autosubmit.svg -domains: [climate_science] +domains: [earth_science] tasks: [conduct_research, data_handling] roles: [data_analyst, information_architect, managerial, researcher] --- diff --git a/docs/pages/use_cases/digital-twins.md b/docs/pages/use_cases/digital-twins.md index 7109346e..96a4acfb 100644 --- a/docs/pages/use_cases/digital-twins.md +++ b/docs/pages/use_cases/digital-twins.md @@ -2,7 +2,7 @@ page_id: digital-twins title: Digital Twins description: RO-Crate is used to describe digital twins in a number of projects studying earth systems and biodiversity. These include DT-GEO, BioDT, EDITO-Infra, and Destination Earth. -domains: [climate_science, ecology] # should match item(s) in pages/domains +domains: [earth_science, ecology] # should match item(s) in pages/domains tasks: [conduct_research, software_development] # should match item(s) in pages/tasks roles: [data_analyst, software_developer] # should match item(s) in pages/roles --- diff --git a/docs/pages/use_cases/galaxy.md b/docs/pages/use_cases/galaxy.md index d9460278..2c94c188 100644 --- a/docs/pages/use_cases/galaxy.md +++ b/docs/pages/use_cases/galaxy.md @@ -5,8 +5,8 @@ description: Galaxy is a platform for FAIR data analysis which supports the buil url: https://galaxyproject.org image: galaxy.png domains: [biology, biomedical_science, chemistry, climate_science, ecology, informatics, medicine, omics, social_science] # should match item(s) in pages/domains -tasks: [conduct_research, manage_data] # should match item(s) in pages/tasks -roles: [data_analyst, information_architect, researcher] # should match item(s) in pages/roles +tasks: [conduct_research, manage_data, training] # should match item(s) in pages/tasks +roles: [data_analyst, information_architect, researcher, trainer] # should match item(s) in pages/roles --- # Galaxy diff --git a/docs/pages/use_cases/mate.md b/docs/pages/use_cases/mate.md new file mode 100644 index 00000000..a35d58de --- /dev/null +++ b/docs/pages/use_cases/mate.md @@ -0,0 +1,59 @@ +--- +page_id: MATE +title: M@TE (Model Atlas of the Earth) +description: By adopting the RO-Crate standard, M@TE packages numerical Earth system models with comprehensive metadata describing code, inputs, outputs, provenance, and authorship. This makes models machine-actionable, reproducible, and citable, supporting open science and bridging the gap between traditional geology and numerical geosciences. +url: https://mate.science +image: MATE.png +domains: [earth_science] +tasks: [conduct_research, curation, data_handling, software_development, training] +roles: [researcher, software_developer, trainer, data_steward] +--- + +# M@TE (Model Atlas of the Earth) + +M@TE logo + +The **Model Atlas of the Earth (M@TE)** is a digital platform that provides access to a wide range of computational models and their outputs, focused on Earth’s evolution from the Geosphere to the Hydrosphere. +M@TE encapsulates the entire model development process — from setup to output and analysis — enabling discovery, data preservation, reproducibility and reuse, offering flexibility for users with varying levels of expertise. + +Purpose-built to meet the specific needs of the geoscience community, M@TE is a lasting, sustainable, and scalable resource that supports and leverages research infrastructure. It offers flexible tools for managing, sharing, and preserving numerical models, with built-in DOI creation to ensure persistent, citable access to results. Similar in spirit to Zenodo, but bigger and better for geoscientific modeling. + +M@TE is designed to meet geoscientists where they are: from educators and students using visualizations in the classroom to researchers developing and benchmarking new numerical models. It lowers the learning curve of numerical models and bridges the gap between traditional geology and numerical geosciences. + +M@TE encapsulates the full model life cycle — from code and input data to outputs, documentation, and publications — ensuring models are **machine-readable, reproducible, and reusable**. + +To achieve this, M@TE packages models with the RO-Crate standard. Each model is accompanied by structured metadata and references to its components (inputs, outputs, figures, animations, code, authorship). This makes it possible to discover, cite, and reuse computational Earth models at scale. + +![M@TE diagram. An RO-Crate is built from contextual entities, model outputs, scripts, and input data. The RO-Crate is hosted on GitHub and published via NCI Australia and given a DOI.](assets/img/MATE-diagram.png) + +## Examples of M@TE RO-Crates + +An example RO-Crate can be found in the [M@TE GitHub repository](https://github.com/ModelAtlasofTheEarth/polanco-2024-deltas/blob/main/ro-crate-metadata.json), which packages simulation code, input datasets, and output datasets with metadata for citation and reuse. + +Each crate includes: +- **Inputs**: code and configuration for simulations +- **Outputs**: model results (e.g. HDF5 datasets, XDMF time series) +- **Documentation and metadata**: descriptions, provenance, cross-links to publications, and persistent identifiers (DOIs) +- **Website materials**: figures and animations for educational and outreach use + +## Resources + +* [M@TE Homepage](https://mate.science) +* [M@TE GitHub Organization](https://github.com/ModelAtlasofTheEarth) + +## Publications + +Polanco, S., Sandiford, D., Alfonso, C. P., Ilano, L., Qin, X., Giordani, J., Rodríguez Corcho, A. F., & Mather, B. (2024): +**Model Atlas of the Earth (M@TE): enhancing the usability of integrated numerical models**. +_AGU Fall Meeting Abstracts 2024_, DI31B-2935 + + +Polanco, S., Sandiford, D., Qin, X., Rodríguez Corcho, A. F., Ilano, L., Alfonso, C. P., Giordani, J., Mather, B., Rees, N., & Farrington, R. (2024): +**Model Atlas of the Earth (M@TE): advancing the interoperability of digital twins**. +_EGU General Assembly 2024_, EGU24-12690 + + +Farrington, R., Wyborn, L., Croucher, J., Devaraju, A., Hunt, A., Hollmann, H., Klump, J., Nixon, A., Prent, A., Polanco, S., Rees, N., & Rawling, T. (2025): +**AuScope’s Research Data Systems: Operationalising FAIR place-based research through collaboration**. +_EGU General Assembly 2025_, EGU25-21367 + diff --git a/docs/pages/use_cases/rexafs.md b/docs/pages/use_cases/rexafs.md index 341741f6..f1de3f11 100644 --- a/docs/pages/use_cases/rexafs.md +++ b/docs/pages/use_cases/rexafs.md @@ -5,8 +5,8 @@ description: Reproducible XAFS Analyses publishes reproducible X-ray absorption url: https://zenodo.org/communities/rexas/records image: ReXAFS.png domains: [chemistry] # should match item(s) in pages/domains -tasks: [research, curation, data_management] # should match item(s) in pages/tasks -roles: [researcher, data_steward, data_analyst, software_developer, repository_manager] # should match item(s) in pages/roles +tasks: [research, curation, data_management, training] # should match item(s) in pages/tasks +roles: [researcher, data_steward, data_analyst, software_developer, repository_manager, trainer] # should match item(s) in pages/roles ---