Repository: planetlabs/planet-client-python
Pull request #1058 (2024-09-25 23:16:37)

Update included bundle spec to 2024-08-12 version.
**Related Issue(s):**

Closes #


**Proposed Changes:**

For inclusion in changelog (if applicable):

1. Update included bundle spec to allow ordering bundles defined in the last year, as well as allow searching the related item types.

Not intended for changelog:

1. 

**Diff of User Interface**

Old behavior:

New behavior:




**PR Checklist:**

- [] This PR is as small and focused as possible
- [] If this PR includes proposed changes for inclusion in the changelog, the title of this PR summarizes those changes and is ready for inclusion in the Changelog.
- [] I have updated docstrings for function changes and docs in the 'docs' folder for user interface / behavior changes
- [] This PR does not break any examples or I have updated them

**(Optional) @mentions for Notifications:**



Patch:
diff --git a/planet/data/README.md b/planet/data/README.md
index d780ca5..3def782 100644
--- a/planet/data/README.md
+++ b/planet/data/README.md
@@ -5,7 +5,7 @@ This directory contains static external resources used by the codebase.
 
 ### Files
 
-* `orders_product_bundle_2023-02-24.json`
+* `orders_product_bundle_2024-08-12.json`
 
 ### Description
 
diff --git a/planet/data/orders_product_bundle_2023-02-24.json b/planet/data/orders_product_bundle_2024-08-12.json
similarity index 78%
rename from planet/data/orders_product_bundle_2023-02-24.json
rename to planet/data/orders_product_bundle_2024-08-12.json
index f413cd5..06c2d20 100644
--- a/planet/data/orders_product_bundle_2023-02-24.json
+++ b/planet/data/orders_product_bundle_2024-08-12.json
@@ -64,6 +64,20 @@
         ]
       }
     },
+    "radiance_hdf5": {
+      "name": "Analytic Radiance (TOAR)",
+      "description": "Calibrated to top of atmosphere radiance.",
+      "bands": "all",
+      "rectification": "orthorectified",
+      "radiometry": "at-sensor",
+      "fileType": "HDF5",
+      "auxiliaryFiles": "udm",
+      "assets": {
+        "TanagerScene": [
+          "ortho_radiance_hdf5"
+        ]
+      }
+    },
     "analytic_udm2": {
       "name": "Analytic Radiance (TOAR)",
       "description": "Calibrated to top of atmosphere radiance",
@@ -93,6 +107,10 @@
           "ortho_analytic",
           "ortho_analytic_udm",
           "ortho_analytic_udm2"
+        ],
+        "PelicanScene": [
+          "ortho_analytic",
+          "ortho_analytic_udm2"
         ]
       }
     },
@@ -191,6 +209,12 @@
         ],
         "SkySatScene": [
           "ortho_visual"
+        ],
+        "TanagerScene": [
+          "ortho_visual"
+        ],
+        "PelicanScene": [
+          "ortho_visual"
         ]
       }
     },
@@ -273,6 +297,20 @@
         ]
       }
     },
+    "basic_radiance_hdf5": {
+      "name": "Basic Analytic Radiance (TOAR)",
+      "description": "Calibrated to top of atmosphere radiance. Includes geolocation array.",
+      "bands": "all",
+      "rectification": "non-orthorectified",
+      "radiometry": "at-sensor",
+      "fileType": "HDF5",
+      "auxiliaryFiles": "udm",
+      "assets": {
+        "TanagerScene": [
+          "basic_radiance_hdf5"
+        ]
+      }
+    },
     "basic_analytic_udm2": {
       "name": "Basic Analytic Radiance (TOAR)",
       "description": "Calibrated to top of atmosphere radiance - includes RPC text file for georeferencing",
@@ -293,6 +331,11 @@
           "basic_analytic_rpc",
           "basic_analytic_udm",
           "basic_analytic_udm2"
+        ],
+        "PelicanScene": [
+          "basic_analytic",
+          "basic_analytic_rpc",
+          "basic_analytic_udm2"
         ]
       }
     },
@@ -443,6 +486,20 @@
         ]
       }
     },
+    "sr_hdf5": {
+      "name": "Surface Reflectance",
+      "description": "Corrected for surface reflectance.",
+      "bands": "all",
+      "rectification": "orthorectified",
+      "radiometry": "surface reflectance",
+      "fileType": "HDF5",
+      "auxiliaryFiles": "udm",
+      "assets": {
+        "TanagerScene": [
+          "ortho_sr_hdf5"
+        ]
+      }
+    },
     "analytic_sr_udm2": {
       "name": "Surface Reflectance 4b",
       "description": "Corrected for surface reflectance – recommended for most analytic applications, 4 band",
@@ -472,6 +529,10 @@
           "ortho_analytic_sr",
           "ortho_analytic_udm",
           "ortho_analytic_udm2"
+        ],
+        "PelicanScene": [
+          "ortho_analytic_sr",
+          "ortho_analytic_udm2"
         ]
       }
     },
@@ -514,6 +575,20 @@
         ]
       }
     },
+    "basic_sr_hdf5": {
+      "name": "Surface Reflectance",
+      "description": "Corrected for surface reflectance – recommended for most analytic applications. Includes geolocation array.",
+      "bands": "all",
+      "rectification": "non-orthorectified",
+      "radiometry": "surface reflectance",
+      "fileType": "HDF5",
+      "auxiliaryFiles": "udm",
+      "assets": {
+        "TanagerScene": [
+          "basic_sr_hdf5"
+        ]
+      }
+    },
     "basic_panchromatic": {
       "name": "Basic Panchromatic",
       "description": "Unrectified panchromatic band - includes RPC text file for georeferencing",
@@ -526,6 +601,11 @@
           "basic_panchromatic",
           "basic_panchromatic_rpc",
           "basic_panchromatic_udm2"
+        ],
+         "PelicanScene": [
+          "basic_panchromatic",
+          "basic_panchromatic_rpc",
+          "basic_panchromatic_udm2"
         ]
       }
     },
@@ -563,6 +643,29 @@
         ]
       }
     },
+    "panchromatic_udm2": {
+      "name": "Panchromatic",
+      "description": "Panchromatic band, calibrated to top of atmosphere radiance",
+      "bands": "panchromatic",
+      "rectification": "orthorectified",
+      "radiometry": "at-sensor",
+      "fileType": "GeoTIFF",
+      "auxiliaryFiles": "udm2",
+      "assets": {
+        "SkySatCollect": [
+          "ortho_panchromatic",
+          "ortho_panchromatic_udm2"
+        ],
+        "SkySatScene": [
+          "ortho_panchromatic",
+          "ortho_panchromatic_udm2"
+        ],
+        "PelicanScene": [
+          "ortho_panchromatic",
+          "ortho_pansharpened_udm2"
+        ]
+      }
+    },
     "panchromatic_dn": {
       "name": "Panchromatic DN",
       "description": "Uncalibrated panchromatic band - suitable for custom radiometric processing",
@@ -642,6 +745,10 @@
           "ortho_pansharpened",
           "ortho_pansharpened_udm",
           "ortho_pansharpened_udm2"
+        ],
+        "PelicanScene": [
+          "ortho_pansharpened",
+          "ortho_pansharpened_udm2"
         ]
       }
     },
@@ -659,9 +766,77 @@
         ],
         "SkySatCollect": [
           "basic_l1a_all_frames"
+        ],
+        "PelicanScene": [
+          "basic_l1a_panchromatic",
+          "basic_l1a_panchromatic_rpc"
+        ]
+      }
+    },
+    "methane_quicklook": {
+      "name": "Methane QuickLook",
+      "description": "Methane QuickLook will have all plumes in kg/hr within an image that can be identified by a human operator.",
+      "bands": "N/A",
+      "rectification": "orthorectified",
+      "radiometry": "N/A",
+      "fileType": "TIFF and JSON",
+      "assets": {
+        "TanagerMethane": [
+          "ortho_ql_ch4",
+          "ortho_visual",
+          "ortho_beta_udm",
+          "recent_monthly_basemap",
+          "ql_ch4_json"
         ]
       }
+    },
+    "quality_controlled_methane": {
+      "name": "Quality Controlled Methane",
+      "description": "Quality Controlled Methane product where all plumes in kg/hr have had additional reviews to wind speed, background and additional environmental contexts.",
+      "bands": "N/A",
+      "rectification": "orthorectified",
+      "radiometry": "N/A",
+      "fileType": "TIFF and JSON",
+      "assets": {
+        "TanagerMethane": [
+          "ortho_qc_ch4",
+          "qc_ch4_json"
+        ]
+      }
+    },
+  "methane": {
+    "name": "Methane",
+    "description": "Methane bundle includes both the Methane QuickLook and Quality Controlled products.",
+    "bands": "N/A",
+    "rectification": "orthorectified",
+    "radiometry": "N/A",
+    "fileType": "TIFF and JSON",
+    "assets": {
+      "TanagerMethane": [
+        "ortho_ql_ch4",
+        "ortho_visual",
+        "ortho_beta_udm",
+        "recent_monthly_basemap",
+        "ql_ch4_json",
+        "ortho_qc_ch4",
+        "qc_ch4_json"
+      ]
     }
   },
-  "version": "2023-02-24"
+  "integrated_methane_enhancement": {
+    "name": "Integrated Methane Enhancement",
+    "description": "Integrated Methane Enhancement (IME) in kg where all plumes have additional reviews to wind speed, background and additional environmental contexts.",
+    "bands": "N/A",
+    "rectification": "orthorectified",
+    "radiometry": "N/A",
+    "fileType": "TIFF and JSON",
+    "assets": {
+      "TanagerMethane": [
+        "ortho_ql_ime_ch4",
+        "ql_ime_ch4_json"
+      ]
+    }
+  }
+},
+  "version": "2024-08-12"
 }
diff --git a/planet/specs.py b/planet/specs.py
index 508fe30..93acc11 100644
--- a/planet/specs.py
+++ b/planet/specs.py
@@ -18,7 +18,7 @@ import logging
 import itertools
 from .constants import DATA_DIR
 
-PRODUCT_BUNDLE_SPEC_NAME = 'orders_product_bundle_2023-02-24.json'
+PRODUCT_BUNDLE_SPEC_NAME = 'orders_product_bundle_2024-08-12.json'
 SUPPORTED_TOOLS = [
     'bandmath',
     'clip',


Test patch:
diff --git a/tests/unit/test_specs.py b/tests/unit/test_specs.py
index bd30943..ffb302e 100644
--- a/tests/unit/test_specs.py
+++ b/tests/unit/test_specs.py
@@ -47,7 +47,16 @@ ALL_PRODUCT_BUNDLES = [
     'panchromatic_dn_udm2',
     'pansharpened',
     'pansharpened_udm2',
-    'basic_l1a_dn'
+    'basic_l1a_dn',
+    'radiance_hdf5',
+    'basic_radiance_hdf5',
+    'sr_hdf5',
+    'basic_sr_hdf5',
+    'panchromatic_udm2',
+    'methane_quicklook',
+    'quality_controlled_methane',
+    'integrated_methane_enhancement',
+    'methane',
 ]
 # must be a valid item type for TEST_PRODUCT_BUNDLE
 TEST_ITEM_TYPE = 'PSScene'
@@ -64,7 +73,10 @@ ALL_ITEM_TYPES = [
     'SkySatCollect',
     'Sentinel2L1C',
     'MYD09GQ',
-    'SkySatScene'
+    'SkySatScene',
+    'TanagerScene',
+    'TanagerMethane',
+    'PelicanScene',
 ]
 TEST_ASSET_TYPE = "basic_udm2"