diff --git a/changelog/165.feature.md b/changelog/165.feature.md new file mode 100644 index 00000000..6210d25c --- /dev/null +++ b/changelog/165.feature.md @@ -0,0 +1 @@ +Added guidance for aerosol optical properties, i.e. MAC simple plumes users. diff --git a/docs/dataset-overviews/aerosol-optical-properties-macv2-sp.md b/docs/dataset-overviews/aerosol-optical-properties-macv2-sp.md index d7188dfd..90ea295c 100644 --- a/docs/dataset-overviews/aerosol-optical-properties-macv2-sp.md +++ b/docs/dataset-overviews/aerosol-optical-properties-macv2-sp.md @@ -3,65 +3,57 @@ # Aerosol optical properties/MACv2-SP -**This section is a work in progress.** -**For a first draft, see https://github.com/PCMDI/input4MIPs_CVs/pull/146** - ## Key contacts -- Names: Stephanie Fielder -- Emails: \[TBD (provider moving institutes)\] +- Names: Stephanie Fiedler +- Emails: stephanie.fiedler@uni-heidelberg.de ## Summary - - -### Source IDs for CMIP7 phases - -The source ID that identifies the dataset to use in the different phases of CMIP7 is given below. +The aerosol optical properties, simple plumes data set does not follow the usual practice for input4MIPs datasets. +The reason is that these files are directly used by Fortran forcing routines, +so making them fit the usual specification helps no-one. +As a result, the information provided here is limited. +For questions, please use the contact information at the top of this page. -#### Testing +That said, we can offer some pointers. +The methods used for producing this data are stable +(see [Stevens et al., 2017](https://gmd.copernicus.org/articles/10/433/2017/)). +However, the data is entirely dependent on the emissions +(both biomass burning and anthropogenic), +so this dataset can only be considered stable once these input emissions are stable. -No data available for this phase yet. +### Datasets for CMIP7 phases -This data is for testing (both of the forcing data and of modelling workflows) only. -Production simulations should not be started based on any data that has a `mip_era` value equal to 'CMIP6Plus'. -(The `mip_era` metadata value appears both in each file's global attributes as well as its metadata on ESGF.) +#### Testing -If you have any feedback, please add it to the [relevant GitHub discussion](https://github.com/PCMDI/input4MIPs_CVs/discussions). +For testing, please use the data at this zenodo record: +[https://doi.org/10.5281/zenodo.14512962](https://doi.org/10.5281/zenodo.14512962). #### CMIP7 AR7 fast track No data available for this phase yet. -This data will be for the CMIP7 AR7 fast track. -All data sets for use in the fast track will be published with a `mip_era` metadata value of 'CMIP7'. -This metadata value will appear both in the file's global metadata as well as its metadata on ESGF. - Further details will follow in early 2025. #### CMIP7 No data available for this phase yet. -This data will be for CMIP7. -All data sets for use in CMIP7 will be published with a `mip_era` metadata value of 'CMIP7'. -This metadata value will appear both in the file's global metadata as well as its metadata on ESGF. - Further details will follow after the fast track is underway (including details about how updates to this data will be handled over the lifetime of CMIP7). - - - ## Navigating the data ### Recommendation for pre-industrial control -Apply the 1850 value as a constant. +Use the same approach as is used for anthropogenic emissions. - +### Grids and frequencies provided - - - - +The aerosol optical properties provides scaling factors/parameters +to calculate aerosol plumes associated with aerosol emissions +for models that do not calculate this themselves. +The provided data is only parameters. +As a data user, you have to calculate gridded data/input yourself using the relevant Fortran routines. +For details, see the Zenodo records provided. diff --git a/docs/dataset-overviews/cmip7_phases_source_ids.csv b/docs/dataset-overviews/cmip7_phases_source_ids.csv index 904b1075..d8d1219c 100644 --- a/docs/dataset-overviews/cmip7_phases_source_ids.csv +++ b/docs/dataset-overviews/cmip7_phases_source_ids.csv @@ -29,9 +29,6 @@ forcing_int_id,forcing,cmip7_phase,source_id_stub,source_id_stub_ignore,source_i 10,AMIP sea-surface temperature and sea-ice boundary forcing,testing,,,,False 10,AMIP sea-surface temperature and sea-ice boundary forcing,ar7_fast_track,,,,False 10,AMIP sea-surface temperature and sea-ice boundary forcing,cmip7,,,,False -11,Aerosol optical properties/MACv2-SP,testing,,,,False -11,Aerosol optical properties/MACv2-SP,ar7_fast_track,,,,False -11,Aerosol optical properties/MACv2-SP,cmip7,,,,False 12,Population density,testing,,,,False 12,Population density,ar7_fast_track,,,,False 12,Population density,cmip7,,,,False diff --git a/docs/dataset-overviews/fill-out-auto-generated-sections.py b/docs/dataset-overviews/fill-out-auto-generated-sections.py index b7c895d0..0bf4bd47 100644 --- a/docs/dataset-overviews/fill-out-auto-generated-sections.py +++ b/docs/dataset-overviews/fill-out-auto-generated-sections.py @@ -134,6 +134,16 @@ def get_cmip7_phase_source_id_summary(cmip7_phase: str) -> tuple[str, ...]: f"1. *{row.forcing}:* [{row.source_id}](https://aims2.llnl.gov/search?project=input4MIPs&versionType=all&&activeFacets=%7B%22source_id%22%3A%22{row.source_id}%22%7D)" ) + # The simple plumes exception + out.insert( + 10, + "1. *Aerosol optical properties/MACv2-SP*: " + "This is not managed via ESGF. " + "Please see the " + "[aerosol optical properties/MACv2-SP specific page](aerosol-optical-properties-macv2-sp) " + "for details.", + ) + return tuple(out) diff --git a/docs/dataset-overviews/index.md b/docs/dataset-overviews/index.md index a95ed8f2..1f9f0bca 100644 --- a/docs/dataset-overviews/index.md +++ b/docs/dataset-overviews/index.md @@ -45,7 +45,7 @@ If you have any feedback, please add it to the [relevant GitHub discussion](http 1. *Nitrogen deposition:* No data available for this phase yet 1. *Solar:* [SOLARIS-HEPPA-CMIP-4-5](https://aims2.llnl.gov/search?project=input4MIPs&versionType=all&&activeFacets=%7B%22source_id%22%3A%22SOLARIS-HEPPA-CMIP-4-5%22%7D) 1. *AMIP sea-surface temperature and sea-ice boundary forcing:* No data available for this phase yet -1. *Aerosol optical properties/MACv2-SP:* No data available for this phase yet +1. *Aerosol optical properties/MACv2-SP*: This is not managed via ESGF. Please see the [aerosol optical properties/MACv2-SP specific page](aerosol-optical-properties-macv2-sp) for details. 1. *Population density:* No data available for this phase yet