Add information about oil type names

- add a dict for name to ID mapping
- add notes to the `docs/tutorial.md` about the oil types

Author: honzaflash

docs/tutorial.md

@@ -220,13 +220,24 @@ m.o.set_config('environment:constant:x_wind', -1)
 m.o.set_config('environment:constant:y_wind', 1)
 ```
 
-List available oil types from NOAA's ADIOS database (or check the database online):
+Note that `oil_type` was input by its oil id, in order to disambiguate the oils in ADIOS.
+
+List of available oil types can be found in the
+1. NOAA's ADIOS database https://adios.orr.noaa.gov/oils
+2. or in the library's `OIL_ID_TO_NAME` dictionary:
+    ```{code-cell} ipython3
+    ptm.models.opendrift.enums.oil_types.OIL_ID_TO_NAME
+    ```
+
+You can also find the oil IDs by name in said [database](https://adios.orr.noaa.gov/oils)
+or in the library's `NAME_TO_OIL_ID` dictionary. E.g.:
 
 ```{code-cell} ipython3
-ptm.OpenOilModelConfig.model_json_schema()["$defs"]["OilTypeEnum"]["enum"]
+ptm.models.opendrift.enums.oil_types.NAME_TO_OIL_ID["ALASKA NORTH SLOPE"]
 ```
 
-Note that `oil_type` was input by its oil id, in order to disambiguate the oils in ADIOS.
+Keep in mind that some oil types share the same name which is why `NAME_TO_OIL_ID`
+contains lists of IDs.
 
 The configuration parameters for this simulation are:
 

particle_tracking_manager/models/opendrift/enums/oil_types.py

@@ -1301,6 +1301,14 @@
 }
 
 
+# A dictionary provided for user's convenience
+NAME_TO_OIL_ID: dict[str, list[str]] = {}
+for oil_id, oil_name in OIL_ID_TO_NAME.items():
+    if oil_name not in NAME_TO_OIL_ID:
+        NAME_TO_OIL_ID[oil_name] = []
+    NAME_TO_OIL_ID[oil_name].append(oil_id)
+
+
 class OilTypeEnum(Enum):
     """Representation of oil types