Merge pull request #556 from duckontheweb/update/gh-326-sar-extension

Update SAR Extension

Author: Jon Duckworth

CHANGELOG.md

@@ -7,6 +7,10 @@
 - `ProjectionExtension.crs_string` to provide a single string to describe the coordinate reference system (CRS).
   Useful because projections can be defined by EPSG code, WKT, or projjson.
   ([#548](https://github.com/stac-utils/pystac/pull/548))
+- SAR Extension summaries([#556](https://github.com/stac-utils/pystac/pull/556))
+- Migration for `sar:type` -> `sar:product_type` and `sar:polarization` ->
+  `sar:polarizations` for pre-0.9 catalogs
+  ([#556](https://github.com/stac-utils/pystac/pull/556))
 
 ### Removed
 

docs/api.rst

@@ -499,8 +499,63 @@ RasterExtension
    :show-inheritance:
    :inherited-members:
 
+SAR Extension
+-------------
+These classes are representations of the :stac-ext:`SAR Extension Spec
+<sar>`.
+
+FrequencyBand
+~~~~~~~~~~~~~
+
+.. autoclass:: pystac.extensions.sar.FrequencyBand
+   :members:
+   :undoc-members:
+   :show-inheritance:
+
+Polarization
+~~~~~~~~~~~~
+
+.. autoclass:: pystac.extensions.sar.Polarization
+   :members:
+   :undoc-members:
+   :show-inheritance:
+
+ObservationDirection
+~~~~~~~~~~~~~~~~~~~~
+
+.. autoclass:: pystac.extensions.sar.ObservationDirection
+   :members:
+   :undoc-members:
+   :show-inheritance:
+
+SarExtension
+~~~~~~~~~~~~
+
+.. autoclass:: pystac.extensions.sar.SarExtension
+   :members:
+   :show-inheritance:
+   :inherited-members:
+
+ItemSarExtension
+~~~~~~~~~~~~~~~~
+
+.. autoclass:: pystac.extensions.sar.ItemSarExtension
+   :members:
+   :show-inheritance:
+   :inherited-members:
+
+AssetSarExtension
+~~~~~~~~~~~~~~~~~
+
+.. autoclass:: pystac.extensions.sar.AssetSarExtension
+   :members:
+   :show-inheritance:
+   :inherited-members:
+
 Satellite Extension
 -------------------
+These classes are representations of the :stac-ext:`Satellite Extension Spec
+<sat>`.
 
 OrbitState
 ~~~~~~~~~~

pystac/extensions/eo.py

@@ -283,8 +283,7 @@ class EOExtension(
     :class:`~pystac.Item` or :class:`~pystac.Asset` with properties from the
     :stac-ext:`Electro-Optical Extension <eo>`. This class is generic over the type of
     STAC Object to be extended (e.g. :class:`~pystac.Item`,
-    :class:`~pystac.
-    Asset`).
+    :class:`~pystac.Asset`).
 
     To create a concrete instance of :class:`EOExtension`, use the
     :meth:`EOExtension.ext` method. For example: