Add placeholder multi-source ID handling

Author: znichollscr

docs/dataset-overviews/anthropogenic-slcf-co2-emissions.md

@@ -27,7 +27,14 @@ The source ID that identifies the dataset to use in the different phases of CMIP
 
 #### Testing
 
-For the testing of CMIP7, use data with the source ID [CEDS-CMIP-2024-10-21](https://aims2.llnl.gov/search?project=input4MIPs&versionType=all&&activeFacets=%7B%22source_id%22%3A%22CEDS-CMIP-2024-10-21%22%7D)
+For the testing of CMIP7, you will need data from the following source IDs:
+
+- [CEDS-CMIP-2024-10-21](https://aims2.llnl.gov/search?project=input4MIPs&versionType=all&&activeFacets=%7B%22source_id%22%3A%22CEDS-CMIP-2024-10-21%22%7D)
+- [CEDS-CMIP-2024-11-30](https://aims2.llnl.gov/search?project=input4MIPs&versionType=all&&activeFacets=%7B%22source_id%22%3A%22CEDS-CMIP-2024-11-30%22%7D).
+
+Retrieving and only using valid data will require some care.
+Please make sure you read the guidance given at the start of this Summary section
+and process the data carefully.
 
 This data is for testing purposes only.
 Production simulations should not be started based on this data.

docs/dataset-overviews/cmip7_phases_source_ids.csv

@@ -1,5 +1,5 @@
 forcing_int_id,forcing,cmip7_phase,source_id_stub,source_id_stub_ignore,source_id,ok_if_not_latest
-1,Anthropogenic short-lived climate forcer (SLCF) and CO<sub>2</sub> emissions,testing,CEDS-CMIP,supplemental,CEDS-CMIP-2024-10-21,False
+1,Anthropogenic short-lived climate forcer (SLCF) and CO<sub>2</sub> emissions,testing,CEDS-CMIP,supplemental,"CEDS-CMIP-2024-10-21;CEDS-CMIP-2024-11-30",True
 1,Anthropogenic short-lived climate forcer (SLCF) and CO<sub>2</sub> emissions,ar7_fast_track,CEDS-CMIP,supplemental,,False
 1,Anthropogenic short-lived climate forcer (SLCF) and CO<sub>2</sub> emissions,cmip7,CEDS-CMIP,supplemental,,False
 2,Open biomass burning emissions,testing,DRES-CMIP-BB4CMIP7,,DRES-CMIP-BB4CMIP7-1-0,False

docs/dataset-overviews/fill-out-auto-generated-sections.py

@@ -263,11 +263,30 @@ def get_cmip7_phases_source_id_summary_for_forcing(forcing: str) -> tuple[str, .
             #     )
             #     raise ValueError(msg)
 
-            out.append(
-                f"For the {cmip7_phase_pretty} of CMIP7, "
-                "use data with the source ID "
-                f"[{row.source_id}](https://aims2.llnl.gov/search?project=input4MIPs&versionType=all&&activeFacets=%7B%22source_id%22%3A%22{row.source_id}%22%7D)"
-            )
+            if ";" in row.source_id:
+                # Multiple source IDs
+                source_id_sep = "\n- "
+                source_id_str = source_id_sep.join(
+                    [
+                        f"[{sid}](https://aims2.llnl.gov/search?project=input4MIPs&versionType=all&&activeFacets=%7B%22source_id%22%3A%22{sid}%22%7D)"
+                        for sid in row.source_id.split(";")
+                    ]
+                )
+                out.append(
+                    f"For the {cmip7_phase_pretty} of CMIP7, "
+                    f"you will need data from the following source IDs:\n{source_id_sep}{source_id_str}.\n\n"
+                    "Retrieving and only using valid data will require some care.\n"
+                    "Please make sure you read the guidance given at the start of this Summary section\n"
+                    "and process the data carefully."
+                )
+
+            else:
+                out.append(
+                    f"For the {cmip7_phase_pretty} of CMIP7, "
+                    "use data with the source ID "
+                    f"[{row.source_id}](https://aims2.llnl.gov/search?project=input4MIPs&versionType=all&&activeFacets=%7B%22source_id%22%3A%22{row.source_id}%22%7D)"
+                )
+
             out.append("")
 
         out.append(PHASES_COMMON_TEXT[row.cmip7_phase])

docs/dataset-overviews/index.md

@@ -36,7 +36,7 @@ If you have any feedback, please add it to the [relevant GitHub discussion](http
 
 #### Source IDs for use in this phase
 
-1. *Anthropogenic short-lived climate forcer (SLCF) and CO<sub>2</sub> emissions:* [CEDS-CMIP-2024-10-21](https://aims2.llnl.gov/search?project=input4MIPs&versionType=all&&activeFacets=%7B%22source_id%22%3A%22CEDS-CMIP-2024-10-21%22%7D)
+1. *Anthropogenic short-lived climate forcer (SLCF) and CO<sub>2</sub> emissions:* [CEDS-CMIP-2024-10-21;CEDS-CMIP-2024-11-30](https://aims2.llnl.gov/search?project=input4MIPs&versionType=all&&activeFacets=%7B%22source_id%22%3A%22CEDS-CMIP-2024-10-21;CEDS-CMIP-2024-11-30%22%7D)
 1. *Open biomass burning emissions:* [DRES-CMIP-BB4CMIP7-1-0](https://aims2.llnl.gov/search?project=input4MIPs&versionType=all&&activeFacets=%7B%22source_id%22%3A%22DRES-CMIP-BB4CMIP7-1-0%22%7D)
 1. *Land use:* [UofMD-landState-3-0](https://aims2.llnl.gov/search?project=input4MIPs&versionType=all&&activeFacets=%7B%22source_id%22%3A%22UofMD-landState-3-0%22%7D)
 1. *Greenhouse gas concentrations:* [CR-CMIP-0-3-0](https://aims2.llnl.gov/search?project=input4MIPs&versionType=all&&activeFacets=%7B%22source_id%22%3A%22CR-CMIP-0-3-0%22%7D)