EUCLIDSWRQ-250 Review documentation

Author: Jorge Fernandez Hernandez

astroquery/esa/euclid/core.py

@@ -1519,49 +1519,51 @@ def __is_multiple(self, value):
     def get_sia(self, *, coordinates, radius=1.0, search_type='CIRCLE', calibration=2, instrument='ALL', band=None,
                 collection='sedm', dsr_part1=None, dsr_part2=None, dsr_part3=None, output_file=None, verbose=False):
         """
-        Query the Euclid Observation Images service through the IVOA SIAP 2.0 interface. The service provides access to
-        public calibrated and stacked VIS and NISP images, MER mosaics, and Level 1 (raw) VIS and NISP observations.
+        Query the Euclid Observation Images service through the IVOA SIAP 2.0 interface.
+
+        The service provides access to public calibrated and stacked VIS and NISP images, MER mosaics, and Level 1 (raw)
+         VIS and NISP observations.
 
         Parameters
         ----------
         coordinates: str or SkyCoord, mandatory, default None
             Center of the search region.
         radius: float or quantity, optional, default value 1.0 degree
             Radius of the search region. If a numeric value is provided, it is interpreted in degrees. An
-            astropy.units.Quantity may also be supplied. If "BOX" uses this value as half-width or width
+            astropy.units.Quantity may also be supplied. If "BOX" uses this value as width
         search_type : str, optional, default CIRCLE
             Shape of the search region. Supported values are "CIRCLE" and "BOX".
         calibration: int, optional, default 2
             Calibration level following the ObsCore data model:
-                1: raw instrumental data
-                2: instrumental data in a standard format
-                3: science-ready data
-                4: enhanced data products
+            - 1: raw instrumental data
+            - 2: instrumental data in a standard format
+            - : science-ready data
+            - 4: enhanced data products
         instrument: str, optional, default ALL
             Instrument to query. Supported values are "ALL", "VIS", and "NISP".
         band: str, optional, default None
             Filter name. This parameter is ignored when instrument="ALL". Valid values are:
-                1: "VIS" for the VIS instrument
-                2: "NIR_Y", "NIR_J", "NIR_H", or "NISP" for the NISP instrument
+            - 1: "VIS" for the VIS instrument
+            - 2: "NIR_Y", "NIR_J", "NIR_H", or "NISP" for the NISP instrument
         collection : str, optional, default sedm
             Name of the data collection.
         dsr_part1: str, optional, default None
-            the data set release part 1: for OTF environment, the activity code; for REG and IDR, the target environment
+            First component of the dataset release identifier: for OTF environment, the activity code; for REG and IDR,
+            the target environment
         dsr_part2: str, optional, default None
-            the data set release part 2: for OTF environment, the patch id (a positive integer); for REG and IDR,
-            the activity code
+            Second component of the dataset release identifier: for OTF environment, the patch id (a positive integer);
+            for REG and IDR, the activity code
         dsr_part3: str, optional, default None
-            the data set release part 3: for OTF, REG and IDR environment, the version (an integer greater than 1)
-        output_file : string, optional, default None
-            Path of the output file. If provided, the query results are written to this file.
+            Third component of the dataset release identifier: for OTF, REG and IDR environment, the version (an integer
+             greater than 1) output_file : string, optional, default None
+            Output file where the query results are written.
         verbose : bool, optional, default 'False'
             flag to display information about the process
 
         Returns
         -------
         astropy.table.Table or str
-            Query results as an `astropy.table.Table`. If `output_file` is
-            specified, the results are also written as a VOTable to the given file.
+            Query results. If ``output_file`` is specified, the results are also written as a VOTable.
         """
 
         valid_search_types = {'CIRCLE', 'BOX'}