From 0f414970e7fe23a28c44587aac4003adefb2362b Mon Sep 17 00:00:00 2001
From: lmichel <laurent.michel@astro.unistra.fr>
Date: Wed, 4 Sep 2024 16:21:05 +0200
Subject: [PATCH 01/14] Add the SkyCoord generation from the Mivot object

---
 docs/mivot/_images/mangoEpochPosition.png  | Bin 54869 -> 63202 bytes
 docs/mivot/index.rst                       |  21 +++
 pyvo/mivot/features/sky_coord_builder.py   | 162 +++++++++++++++++++++
 pyvo/mivot/tests/test_sky_coord_builder.py | 149 +++++++++++++++++++
 pyvo/mivot/viewer/mivot_instance.py        |  22 ++-
 pyvo/mivot/viewer/mivot_viewer.py          |   1 +
 6 files changed, 347 insertions(+), 8 deletions(-)
 create mode 100644 pyvo/mivot/features/sky_coord_builder.py
 create mode 100644 pyvo/mivot/tests/test_sky_coord_builder.py

diff --git a/docs/mivot/_images/mangoEpochPosition.png b/docs/mivot/_images/mangoEpochPosition.png
index 3d158c7362e47f0b23f159b2f51d1ba381c13061..04a4e748ff6f7a3554f7292cc225deac6efbb669 100644
GIT binary patch
literal 63202
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

literal 54869
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
CehYs9

diff --git a/docs/mivot/index.rst b/docs/mivot/index.rst
index 33eed9ea1..b444d1fdf 100644
--- a/docs/mivot/index.rst
+++ b/docs/mivot/index.rst
@@ -164,6 +164,27 @@ with the `astropy.io.votable` API:
 
 In this case, it is up to the user to ensure that the read data rows are those mapped by the Mivot annotations.
 
+Get a SkyCoord Instance Directly From the Annotations
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Once you get a ``MivotInstance`` representing the last row read, you can use it to create an ``astropy.SkyCoord`` object.
+
+.. code-block:: python
+    :caption: Accessing the model view of Astropy table rows
+
+	from pyvo.mivot import MivotViewer
+    from pyvo.mivot.utils.dict_utils import DictUtils
+    
+    m_viewer = MivotViewer(path_to_votable)
+    mivot_instance = m_viewer.dm_instance
+    print(mivot_instance.get_SkyCoord())
+    <SkyCoord (ICRS): (ra, dec) in deg(52.26722684, 59.94033461)
+          (pm_ra_cosdec, pm_dec) in mas / yr(-0.82, -1.85)>
+
+This feature works under the condition that the annotations contain a valid instance of ``mango:EPochPosition``. 
+Although not a standard at the time of writing, the class structure supported by this implementation must match the figure above.
+If the annotation do no contain any vali object, `None` is returned.
+
 For XML Hackers
 ---------------
 
diff --git a/pyvo/mivot/features/sky_coord_builder.py b/pyvo/mivot/features/sky_coord_builder.py
new file mode 100644
index 000000000..6b936b254
--- /dev/null
+++ b/pyvo/mivot/features/sky_coord_builder.py
@@ -0,0 +1,162 @@
+# Licensed under a 3-clause BSD style license - see LICENSE.rst
+"""
+Utility transforming MIVOT annotation into SKYCoord instances
+"""
+
+from astropy.coordinates import SkyCoord
+from astropy import units as u
+from astropy.coordinates import ICRS, Galactic, FK4, FK5
+
+
+class MangoRoles:
+    """
+    Place holder for the roles of the mango:EpochPosition roles
+    """
+    LONGITUDE = "longitude"
+    LATITUDE = "latitude"
+    PM_LONGITUDE = "pmLongitude"
+    PM_LATITUDE = "pmLatitude"
+    PARALLAX = "parallax"
+    RADIAL_VELOCITY = "radialVelocity"
+    EPOCH = "epoch"
+    FRAME = "frame"
+    EQUINOX = "equinox"
+    PMCOSDELTAPPLIED = "pmCosDeltApplied"
+
+
+# Mapping of the MANGO parameters on the SkyCoord parameters
+skycoord_param_default = {
+    MangoRoles.LONGITUDE: 'ra', MangoRoles.LATITUDE: 'dec', MangoRoles.PARALLAX: 'distance',
+    MangoRoles.PM_LONGITUDE: 'pm_ra_cosdec', MangoRoles.PM_LATITUDE: 'pm_dec',
+    MangoRoles.RADIAL_VELOCITY: 'radial_velocity', MangoRoles.EPOCH: 'obstime'}
+
+skycoord_param_galactic = {
+    MangoRoles.LONGITUDE: 'l', MangoRoles.LATITUDE: 'b', MangoRoles.PARALLAX: 'distance',
+    MangoRoles.PM_LONGITUDE: 'pm_l_cosb', MangoRoles.PM_LATITUDE: 'pm_b',
+    MangoRoles.RADIAL_VELOCITY: 'radial_velocity', MangoRoles.EPOCH: 'obstime'}
+
+
+class SkyCoordBuilder(object):
+    '''
+    Utility generating SkyCoord instances from MIVOT annotations
+
+    - SkyCoord instances can only be built from model classes containing the minimal
+    set of required parameters (a position).
+    - In this implementation, only the mango:EpochPosition class is supported since
+      it proposes anything required to compute the epoch propagation which is a major use-case
+    '''
+
+    def __init__(self, mivot_instance_dict):
+        '''
+        Constructor
+
+        parameters
+        -----------
+        - mivot_instance_dict: viewer.MivotInstance.to_dict()
+                               Internal dictionary of the dynamic Python object generated
+                               from the MIVOT block
+        '''
+        self._mivot_instance_dict = mivot_instance_dict
+        self._map_coord_names = None
+
+    def build_sky_coord(self):
+        """
+        Build a SkyCoord instance from the dynamic Python object attribute.
+
+        returns
+        -------
+        - SkyCoord instance or None
+        """
+        if not self._mivot_instance_dict:
+            return None
+        if self._mivot_instance_dict["dmtype"] == "mango:EpochPosition":
+            return self._build_sky_coord_from_mango()
+        return None
+
+    def _set_year_time_format(self, hk_field):
+        """
+        Format a date expressed in year as J-year
+
+        parameters
+        ----------
+        - hk_field: MIVOT instance parameter as a dict
+
+        returns
+        -------
+        - formatted string
+        """
+        return (f"j{hk_field['value']}" if hk_field["unit"] in ("yr", "year")
+                else hk_field["value"])
+
+    def _get_space_frame(self):
+        """
+        Build an astropy space frame instance from the MIVOT annotations.
+
+        - Equinox are supported fot FK4/5
+        - Ref location are not supported
+
+        returns
+        -------
+        - Astropy space frame
+        """
+        coo_sys = self._mivot_instance_dict["coordSys"]
+        equinox = None
+        frame = coo_sys["spaceRefFrame"]["value"].lower()
+
+        if frame == 'fk4':
+            self._map_coord_names = skycoord_param_default
+            if "equinox" in coo_sys:
+                equinox = self._set_year_time_format(coo_sys["equinox"])
+                return FK4(equinox=equinox)
+            return FK4()
+
+        if frame == 'fk5':
+            self._map_coord_names = skycoord_param_default
+            if "equinox" in coo_sys:
+                equinox = self._set_year_time_format(coo_sys["equinox"])
+                return FK5(equinox=equinox)
+            return FK5()
+
+        if frame == 'galactic':
+            self._map_coord_names = skycoord_param_galactic
+            return Galactic()
+
+        self._map_coord_names = skycoord_param_default
+        return ICRS()
+
+    def _build_sky_coord_from_mango(self):
+        """
+        Build silently a SlyCoord instance from the mango:EpochPosition instance.
+        No error is trapped, unconsistencies in the mango:EpochPosition instance will
+        raise Astropy errors.
+
+        - The epoch (obstime) is meant to be given as J-year.
+        - ICRS frame is taken by default
+        - The cos-delta correction is meant to be applied.
+          The case mango:pmCosDeltApplied = False is not suppored yet
+
+        returns
+        -------
+        - SkyCoord instance
+        """
+        kwargs = {}
+        kwargs["frame"] = self._get_space_frame()
+
+        for key, value in self._map_coord_names.items():
+            # ignore not set parameters
+            if key not in self._mivot_instance_dict:
+                continue
+            hk_field = self._mivot_instance_dict[key]
+            # format the observation time (J-year by default)
+            if value == "obstime":
+                kwargs[value] = self._set_year_time_format(hk_field)
+            # Convert the parallax (mango) into a distance
+            elif value == "distance":
+                kwargs[value] = (hk_field["value"]
+                                 * u.Unit(hk_field["unit"]).to(u.parsec, equivalencies=u.parallax()))
+                kwargs[value] = kwargs[value] * u.parsec
+            elif "unit" in hk_field and hk_field["unit"]:
+                kwargs[value] = hk_field["value"] * u.Unit(hk_field["unit"])
+            else:
+                kwargs[value] = hk_field["value"]
+        return SkyCoord(**kwargs)
diff --git a/pyvo/mivot/tests/test_sky_coord_builder.py b/pyvo/mivot/tests/test_sky_coord_builder.py
new file mode 100644
index 000000000..22d84e678
--- /dev/null
+++ b/pyvo/mivot/tests/test_sky_coord_builder.py
@@ -0,0 +1,149 @@
+'''
+The first service in operation the annotates query responses in the fly is Vizier
+https://cds/viz-bin/mivotconesearch/VizierParams
+Data are mapped on the mango:EpochPropagtion class as it is implemented in the current code.
+This test case is based on 2 VOTables:
+Both tests check the generation of SkyCoord instances from the MivotInstances buil
+for the output of this service.
+'''
+import pytest
+from pyvo.mivot.version_checker import check_astropy_version
+from pyvo.mivot.viewer.mivot_instance import MivotInstance
+from pyvo.mivot.features.sky_coord_builder import SkyCoordBuilder
+
+# annotations generated by Vizier as given to the MivotInstance
+vizier_dict = {
+    "dmtype": "mango:EpochPosition",
+    "longitude": {
+        "dmtype": "ivoa:RealQuantity",
+        "value": 52.26722684,
+        "unit": "deg",
+        "ref": "RAICRS",
+    },
+    "latitude": {
+        "dmtype": "ivoa:RealQuantity",
+        "value": 59.94033461,
+        "unit": "deg",
+        "ref": "DEICRS",
+    },
+    "pmLongitude": {
+        "dmtype": "ivoa:RealQuantity",
+        "value": -0.82,
+        "unit": "mas/yr",
+        "ref": "pmRA",
+    },
+    "pmLatitude": {
+        "dmtype": "ivoa:RealQuantity",
+        "value": -1.85,
+        "unit": "mas/yr",
+        "ref": "pmDE",
+    },
+    "epoch": {
+        "dmtype": "ivoa:RealQuantity",
+        "value": 1991.25,
+        "unit": "yr",
+        "ref": None,
+    },
+    "coordSys": {
+        "dmtype": "coords:SpaceSys",
+        "dmid": "SpaceFrame_ICRS",
+        "dmrole": "coords:Coordinate.coordSys",
+        "spaceRefFrame": {
+            "dmtype": "coords:SpaceFrame",
+            "value": "ICRS",
+            "unit": None,
+            "ref": None,
+        },
+    },
+}
+# The same edited by hand (parallax added and FK5 + Equinox frame)
+vizier_equin_dict = {
+    "dmtype": "mango:EpochPosition",
+    "longitude": {
+        "dmtype": "ivoa:RealQuantity",
+        "value": 52.26722684,
+        "unit": "deg",
+        "ref": "RAICRS",
+    },
+    "latitude": {
+        "dmtype": "ivoa:RealQuantity",
+        "value": 59.94033461,
+        "unit": "deg",
+        "ref": "DEICRS",
+    },
+    "pmLongitude": {
+        "dmtype": "ivoa:RealQuantity",
+        "value": -0.82,
+        "unit": "mas/yr",
+        "ref": "pmRA",
+    },
+    "pmLatitude": {
+        "dmtype": "ivoa:RealQuantity",
+        "value": -1.85,
+        "unit": "mas/yr",
+        "ref": "pmDE",
+    },
+    "parallax": {
+        "dmtype": "ivoa:RealQuantity",
+        "value": 0.6,
+        "unit": "mas",
+        "ref": "parallax",
+    },
+    "epoch": {
+        "dmtype": "ivoa:RealQuantity",
+        "value": 1991.25,
+        "unit": "yr",
+        "ref": None,
+    },
+    "coordSys": {
+        "dmtype": "coords:SpaceSys",
+        "dmid": "SpaceFrame_ICRS",
+        "dmrole": "coords:Coordinate.coordSys",
+        "spaceRefFrame": {
+            "dmtype": "coords:SpaceFrame.spaceRefFrame",
+            "value": "FK5",
+            "unit": None,
+            "ref": None,
+        },
+        "equinox": {
+            "dmtype": "coords:SpaceFrame.equinox",
+            "value": "2012",
+            "unit": "yr",
+        },
+    },
+}
+
+
+@pytest.mark.skipif(not check_astropy_version(), reason="need astropy 6+")
+def test_vizier_output():
+    """ Test the SkyCoord issued from the Vizier response
+    """
+    mivot_instance = MivotInstance(**vizier_dict)
+    scb = SkyCoordBuilder(mivot_instance.to_dict())
+    scoo = scb.build_sky_coord()
+    assert (str(scoo).replace("\n", "").replace("  ", "")
+            == "<SkyCoord (ICRS): (ra, dec) in deg(52.26722684, 59.94033461) "
+               "(pm_ra_cosdec, pm_dec) in mas / yr(-0.82, -1.85)>")
+    scoo = mivot_instance.get_SkyCoord()
+    assert (str(scoo).replace("\n", "").replace("  ", "")
+            == "<SkyCoord (ICRS): (ra, dec) in deg(52.26722684, 59.94033461) "
+               "(pm_ra_cosdec, pm_dec) in mas / yr(-0.82, -1.85)>")
+
+
+@pytest.mark.skipif(not check_astropy_version(), reason="need astropy 6+")
+def test_vizier_output_with_equinox_and_parallax():
+    """Test the SkyCoord issued from the modofier Vizier response *
+    (parallax added and FK5 + Equinox frame)
+    """
+    mivot_instance = MivotInstance(**vizier_equin_dict)
+    scb = SkyCoordBuilder(mivot_instance.to_dict())
+    scoo = scb.build_sky_coord()
+    assert (str(scoo).replace("\n", "").replace("  ", "")
+            == "<SkyCoord (FK5: equinox=J2012.000): (ra, dec, distance) in "
+               "(deg, deg, pc)(52.26722684, 59.94033461, 600.) "
+               "(pm_ra_cosdec, pm_dec) in mas / yr(-0.82, -1.85)>")
+    scoo = mivot_instance.get_SkyCoord()
+    assert (str(scoo).replace("\n", "").replace("  ", "")
+            == "<SkyCoord (FK5: equinox=J2012.000): (ra, dec, distance) in "
+               "(deg, deg, pc)(52.26722684, 59.94033461, 600.) "
+               "(pm_ra_cosdec, pm_dec) in mas / yr(-0.82, -1.85)>")
diff --git a/pyvo/mivot/viewer/mivot_instance.py b/pyvo/mivot/viewer/mivot_instance.py
index 2b6a14c32..8502ac900 100644
--- a/pyvo/mivot/viewer/mivot_instance.py
+++ b/pyvo/mivot/viewer/mivot_instance.py
@@ -10,11 +10,12 @@
 Although attribute values can be changed by users, this class is first
 meant to provide a convenient access the mapped VOTable data
 """
-from astropy import time
-from pyvo.mivot.utils.vocabulary import unit_mapping, Constant
+from pyvo.mivot.utils.vocabulary import Constant
 from pyvo.utils.prototype import prototype_feature
 from pyvo.mivot.utils.mivot_utils import MivotUtils
 from pyvo.mivot.utils.dict_utils import DictUtils
+from pyvo.mivot.features.sky_coord_builder import SkyCoordBuilder
+
 
 # list of model leaf parameters that must be hidden for the final user
 hk_parameters = ["astropy_unit", "ref"]
@@ -53,7 +54,7 @@ def to_hk_dict(self):
         housekeeping data such as column references. This might be used
         to apply the mapping out of the MivotViewer context
         """
-        return self._get_class_dict(self)
+        return self._get_class_dict(self, slim=False)
 
     def to_dict(self):
         """
@@ -98,10 +99,6 @@ def _create_class(self, **kwargs):
                 if key == 'unit':  # We convert the unit to astropy unit or to astropy time format if possible
                     # The first Vizier implementation used mas/year for the mapped pm unit: let's correct it
                     value = value.replace("year", "yr") if value else None
-                    if value in unit_mapping.keys():
-                        setattr(self, "astropy_unit", unit_mapping[value])
-                    elif value in time.TIME_FORMATS.keys():
-                        setattr(self, "astropy_unit_time", value)
 
     def update(self, row, ref=None):
         """
@@ -128,6 +125,14 @@ def update(self, row, ref=None):
                     setattr(self, self._remove_model_name(key),
                             MivotUtils.cast_type_value(row[ref], getattr(self, 'dmtype')))
 
+    def get_SkyCoord(self):
+        """        
+        returns
+        -------
+        - a SkyCoord instance or None
+        """
+        return SkyCoordBuilder(self.to_dict()).build_sky_coord()
+
     @staticmethod
     def _remove_model_name(value):
         """
@@ -178,6 +183,7 @@ def _get_class_dict(self, obj, classkey=None, slim=False):
         dict or object
             The serializable dictionary representation of the input.
         """
+
         if isinstance(obj, dict):
             data = {}
             for (k, v) in obj.items():
@@ -188,7 +194,7 @@ def _get_class_dict(self, obj, classkey=None, slim=False):
         elif hasattr(obj, "__iter__") and not isinstance(obj, str):
             return [self._get_class_dict(v, classkey, slim=slim) for v in obj]
         elif hasattr(obj, "__dict__"):
-            data = dict([(key, self._get_class_dict(value, classkey, slim=slim))
+            data = dict([(key, obj._get_class_dict(value, classkey, slim=slim))
                          for key, value in obj.__dict__.items()
                          if not callable(value) and not key.startswith('_')])
             # remove the house keeping parameters
diff --git a/pyvo/mivot/viewer/mivot_viewer.py b/pyvo/mivot/viewer/mivot_viewer.py
index a6f1224f7..08202c30b 100644
--- a/pyvo/mivot/viewer/mivot_viewer.py
+++ b/pyvo/mivot/viewer/mivot_viewer.py
@@ -93,6 +93,7 @@ def __init__(self, votable_path, tableref=None):
         self._mapped_tables = []
         self._resource_seeker = None
         self._dm_instance = None
+        self._sky_coord = None
         try:
             self._set_resource()
             self._set_mapping_block()

From df9aa22f6d1d49ae500d6a1cb4319019b6e3f3f6 Mon Sep 17 00:00:00 2001
From: lmichel <laurent.michel@astro.unistra.fr>
Date: Wed, 4 Sep 2024 16:24:11 +0200
Subject: [PATCH 02/14] remove unused attribute

---
 pyvo/mivot/viewer/mivot_viewer.py | 1 -
 1 file changed, 1 deletion(-)

diff --git a/pyvo/mivot/viewer/mivot_viewer.py b/pyvo/mivot/viewer/mivot_viewer.py
index 08202c30b..a6f1224f7 100644
--- a/pyvo/mivot/viewer/mivot_viewer.py
+++ b/pyvo/mivot/viewer/mivot_viewer.py
@@ -93,7 +93,6 @@ def __init__(self, votable_path, tableref=None):
         self._mapped_tables = []
         self._resource_seeker = None
         self._dm_instance = None
-        self._sky_coord = None
         try:
             self._set_resource()
             self._set_mapping_block()

From 7b906fb31487bcae6a84a8d2ef6f2330ee901508 Mon Sep 17 00:00:00 2001
From: lmichel <laurent.michel@astro.unistra.fr>
Date: Fri, 6 Sep 2024 09:50:03 +0200
Subject: [PATCH 03/14] Fix for the PR

---
 docs/mivot/index.rst                       |  2 +-
 pyvo/mivot/features/sky_coord_builder.py   | 29 +++++++++++++++-------
 pyvo/mivot/tests/test_mivot_instance.py    |  2 --
 pyvo/mivot/tests/test_sky_coord_builder.py | 19 +++++++++++++-
 pyvo/mivot/tests/test_user_api.py          |  4 ---
 pyvo/mivot/viewer/mivot_instance.py        |  4 +--
 6 files changed, 41 insertions(+), 19 deletions(-)

diff --git a/docs/mivot/index.rst b/docs/mivot/index.rst
index b444d1fdf..ce1f50a24 100644
--- a/docs/mivot/index.rst
+++ b/docs/mivot/index.rst
@@ -165,7 +165,7 @@ with the `astropy.io.votable` API:
 In this case, it is up to the user to ensure that the read data rows are those mapped by the Mivot annotations.
 
 Get a SkyCoord Instance Directly From the Annotations
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+-----------------------------------------------------
 
 Once you get a ``MivotInstance`` representing the last row read, you can use it to create an ``astropy.SkyCoord`` object.
 
diff --git a/pyvo/mivot/features/sky_coord_builder.py b/pyvo/mivot/features/sky_coord_builder.py
index 6b936b254..3711034be 100644
--- a/pyvo/mivot/features/sky_coord_builder.py
+++ b/pyvo/mivot/features/sky_coord_builder.py
@@ -67,13 +67,11 @@ def build_sky_coord(self):
         -------
         - SkyCoord instance or None
         """
-        if not self._mivot_instance_dict:
-            return None
-        if self._mivot_instance_dict["dmtype"] == "mango:EpochPosition":
+        if self._mivot_instance_dict and self._mivot_instance_dict["dmtype"] == "mango:EpochPosition":
             return self._build_sky_coord_from_mango()
         return None
 
-    def _set_year_time_format(self, hk_field):
+    def _set_year_time_format(self, hk_field, besselian=False):
         """
         Format a date expressed in year as J-year
 
@@ -85,16 +83,22 @@ def _set_year_time_format(self, hk_field):
         -------
         - formatted string
         """
-        return (f"j{hk_field['value']}" if hk_field["unit"] in ("yr", "year")
+        scale = "J" if not besselian else "B"
+        return (f"{scale}{hk_field['value']}" if hk_field["unit"] in ("yr", "year")
                 else hk_field["value"])
 
-    def _get_space_frame(self):
+    def _get_space_frame(self, obstime=None):
         """
         Build an astropy space frame instance from the MIVOT annotations.
 
         - Equinox are supported fot FK4/5
         - Ref location are not supported
 
+        parameters
+        ----------
+        - obstime: string
+                   Observation time is given here because KF4 set an default value
+                   if it is not given
         returns
         -------
         - Astropy space frame
@@ -106,8 +110,10 @@ def _get_space_frame(self):
         if frame == 'fk4':
             self._map_coord_names = skycoord_param_default
             if "equinox" in coo_sys:
-                equinox = self._set_year_time_format(coo_sys["equinox"])
-                return FK4(equinox=equinox)
+                equinox = self._set_year_time_format(coo_sys["equinox"], True)
+                print(coo_sys["equinox"])
+                print(FK4(equinox=equinox, obstime="B345"))
+                return FK4(equinox=equinox, obstime=obstime)
             return FK4()
 
         if frame == 'fk5':
@@ -149,7 +155,12 @@ def _build_sky_coord_from_mango(self):
             hk_field = self._mivot_instance_dict[key]
             # format the observation time (J-year by default)
             if value == "obstime":
-                kwargs[value] = self._set_year_time_format(hk_field)
+                # obstime must be set into the KK4 frame but not as an input parameter
+                fobstime = self._set_year_time_format(hk_field)
+                if isinstance(kwargs["frame"], FK4):
+                    kwargs["frame"] = self._get_space_frame(obstime=fobstime)
+                else:
+                    kwargs[value] = fobstime
             # Convert the parallax (mango) into a distance
             elif value == "distance":
                 kwargs[value] = (hk_field["value"]
diff --git a/pyvo/mivot/tests/test_mivot_instance.py b/pyvo/mivot/tests/test_mivot_instance.py
index d79fae900..1e314bf44 100644
--- a/pyvo/mivot/tests/test_mivot_instance.py
+++ b/pyvo/mivot/tests/test_mivot_instance.py
@@ -19,14 +19,12 @@
                 "dmtype": "RealQuantity",
                 "value": 52.2340018,
                 "unit": "deg",
-                "astropy_unit": {},
                 "ref": "RAICRS"
             },
             "latitude": {
                 "dmtype": "RealQuantity",
                 "value": 59.8937333,
                 "unit": "deg",
-                "astropy_unit": {},
                 "ref": "DEICRS"
             }
 }
diff --git a/pyvo/mivot/tests/test_sky_coord_builder.py b/pyvo/mivot/tests/test_sky_coord_builder.py
index 22d84e678..06088985c 100644
--- a/pyvo/mivot/tests/test_sky_coord_builder.py
+++ b/pyvo/mivot/tests/test_sky_coord_builder.py
@@ -129,6 +129,20 @@ def test_vizier_output():
             == "<SkyCoord (ICRS): (ra, dec) in deg(52.26722684, 59.94033461) "
                "(pm_ra_cosdec, pm_dec) in mas / yr(-0.82, -1.85)>")
 
+    vizier_dict["coordSys"]["spaceRefFrame"]["value"] = "Galactic"
+    mivot_instance = MivotInstance(**vizier_dict)
+    scoo = mivot_instance.get_SkyCoord()
+    assert (str(scoo).replace("\n", "").replace("  ", "")
+            == "<SkyCoord (Galactic): (l, b) in deg(52.26722684, 59.94033461) "
+               "(pm_l_cosb, pm_b) in mas / yr(-0.82, -1.85)>")
+
+    vizier_dict["coordSys"]["spaceRefFrame"]["value"] = "QWERTY"
+    mivot_instance = MivotInstance(**vizier_dict)
+    scoo = mivot_instance.get_SkyCoord()
+    assert (str(scoo).replace("\n", "").replace("  ", "")
+            == "<SkyCoord (ICRS): (ra, dec) in deg(52.26722684, 59.94033461) "
+               "(pm_ra_cosdec, pm_dec) in mas / yr(-0.82, -1.85)>")
+
 
 @pytest.mark.skipif(not check_astropy_version(), reason="need astropy 6+")
 def test_vizier_output_with_equinox_and_parallax():
@@ -142,8 +156,11 @@ def test_vizier_output_with_equinox_and_parallax():
             == "<SkyCoord (FK5: equinox=J2012.000): (ra, dec, distance) in "
                "(deg, deg, pc)(52.26722684, 59.94033461, 600.) "
                "(pm_ra_cosdec, pm_dec) in mas / yr(-0.82, -1.85)>")
+
+    vizier_equin_dict["coordSys"]["spaceRefFrame"]["value"] = "FK4"
+    mivot_instance = MivotInstance(**vizier_equin_dict)
     scoo = mivot_instance.get_SkyCoord()
     assert (str(scoo).replace("\n", "").replace("  ", "")
-            == "<SkyCoord (FK5: equinox=J2012.000): (ra, dec, distance) in "
+            == "<SkyCoord (FK4: equinox=B2012.000, obstime=J1991.250): (ra, dec, distance) in "
                "(deg, deg, pc)(52.26722684, 59.94033461, 600.) "
                "(pm_ra_cosdec, pm_dec) in mas / yr(-0.82, -1.85)>")
diff --git a/pyvo/mivot/tests/test_user_api.py b/pyvo/mivot/tests/test_user_api.py
index 8ed6e9141..04277c0e6 100644
--- a/pyvo/mivot/tests/test_user_api.py
+++ b/pyvo/mivot/tests/test_user_api.py
@@ -234,28 +234,24 @@ def test_with_dict(path_to_votable):
             "dmtype": "ivoa:RealQuantity",
             "value": 359.94372764,
             "unit": "deg",
-            "astropy_unit": {},
             "ref": "RAICRS",
         },
         "latitude": {
             "dmtype": "ivoa:RealQuantity",
             "value": -0.28005255,
             "unit": "deg",
-            "astropy_unit": {},
             "ref": "DEICRS",
         },
         "pmLongitude": {
             "dmtype": "ivoa:RealQuantity",
             "value": -5.14,
             "unit": "mas/yr",
-            "astropy_unit": {},
             "ref": "pmRA",
         },
         "pmLatitude": {
             "dmtype": "ivoa:RealQuantity",
             "value": -25.43,
             "unit": "mas/yr",
-            "astropy_unit": {},
             "ref": "pmDE",
         },
         "epoch": {
diff --git a/pyvo/mivot/viewer/mivot_instance.py b/pyvo/mivot/viewer/mivot_instance.py
index 8502ac900..47cfacdea 100644
--- a/pyvo/mivot/viewer/mivot_instance.py
+++ b/pyvo/mivot/viewer/mivot_instance.py
@@ -18,7 +18,7 @@
 
 
 # list of model leaf parameters that must be hidden for the final user
-hk_parameters = ["astropy_unit", "ref"]
+hk_parameters = ["ref"]
 
 
 @prototype_feature('MIVOT')
@@ -126,7 +126,7 @@ def update(self, row, ref=None):
                             MivotUtils.cast_type_value(row[ref], getattr(self, 'dmtype')))
 
     def get_SkyCoord(self):
-        """        
+        """
         returns
         -------
         - a SkyCoord instance or None

From a8c76245fb1072017f9ab290a09034b44dc86b83 Mon Sep 17 00:00:00 2001
From: lmichel <laurent.michel@astro.unistra.fr>
Date: Fri, 6 Sep 2024 09:51:27 +0200
Subject: [PATCH 04/14] Fix for the PR

---
 pyvo/mivot/features/sky_coord_builder.py | 1 -
 1 file changed, 1 deletion(-)

diff --git a/pyvo/mivot/features/sky_coord_builder.py b/pyvo/mivot/features/sky_coord_builder.py
index 3711034be..2db2111c0 100644
--- a/pyvo/mivot/features/sky_coord_builder.py
+++ b/pyvo/mivot/features/sky_coord_builder.py
@@ -69,7 +69,6 @@ def build_sky_coord(self):
         """
         if self._mivot_instance_dict and self._mivot_instance_dict["dmtype"] == "mango:EpochPosition":
             return self._build_sky_coord_from_mango()
-        return None
 
     def _set_year_time_format(self, hk_field, besselian=False):
         """

From 094b51928b18b68689374442002066f6cbf2a24b Mon Sep 17 00:00:00 2001
From: Laurent MICHEL <laurent.michel@astro.unistra.fr>
Date: Thu, 19 Sep 2024 17:43:18 +0200
Subject: [PATCH 05/14] Typos in comment corrected (#591)

---
 pyvo/mivot/features/sky_coord_builder.py   | 2 +-
 pyvo/mivot/tests/test_sky_coord_builder.py | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/pyvo/mivot/features/sky_coord_builder.py b/pyvo/mivot/features/sky_coord_builder.py
index 2db2111c0..b07f70658 100644
--- a/pyvo/mivot/features/sky_coord_builder.py
+++ b/pyvo/mivot/features/sky_coord_builder.py
@@ -131,7 +131,7 @@ def _get_space_frame(self, obstime=None):
 
     def _build_sky_coord_from_mango(self):
         """
-        Build silently a SlyCoord instance from the mango:EpochPosition instance.
+        Build silently a SkyCoord instance from the mango:EpochPosition instance.
         No error is trapped, unconsistencies in the mango:EpochPosition instance will
         raise Astropy errors.
 
diff --git a/pyvo/mivot/tests/test_sky_coord_builder.py b/pyvo/mivot/tests/test_sky_coord_builder.py
index 06088985c..0a235c506 100644
--- a/pyvo/mivot/tests/test_sky_coord_builder.py
+++ b/pyvo/mivot/tests/test_sky_coord_builder.py
@@ -3,7 +3,7 @@
 https://cds/viz-bin/mivotconesearch/VizierParams
 Data are mapped on the mango:EpochPropagtion class as it is implemented in the current code.
 This test case is based on 2 VOTables:
-Both tests check the generation of SkyCoord instances from the MivotInstances buil
+Both tests check the generation of SkyCoord instances from the MivotInstances built
 for the output of this service.
 '''
 import pytest

From 0afbd2aed3f51df3be9a44d1a5456a05f33621ea Mon Sep 17 00:00:00 2001
From: Laurent MICHEL <laurent.michel@astro.unistra.fr>
Date: Thu, 19 Sep 2024 17:43:48 +0200
Subject: [PATCH 06/14] Typos corrected and unused import removed (#591)

---
 docs/mivot/index.rst | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/docs/mivot/index.rst b/docs/mivot/index.rst
index ce1f50a24..587c14552 100644
--- a/docs/mivot/index.rst
+++ b/docs/mivot/index.rst
@@ -173,7 +173,6 @@ Once you get a ``MivotInstance`` representing the last row read, you can use it
     :caption: Accessing the model view of Astropy table rows
 
 	from pyvo.mivot import MivotViewer
-    from pyvo.mivot.utils.dict_utils import DictUtils
     
     m_viewer = MivotViewer(path_to_votable)
     mivot_instance = m_viewer.dm_instance
@@ -183,7 +182,7 @@ Once you get a ``MivotInstance`` representing the last row read, you can use it
 
 This feature works under the condition that the annotations contain a valid instance of ``mango:EPochPosition``. 
 Although not a standard at the time of writing, the class structure supported by this implementation must match the figure above.
-If the annotation do no contain any vali object, `None` is returned.
+If the annotation do no contain any valid object, `None` is returned.
 
 For XML Hackers
 ---------------

From e0f61e7524f125e89e84aa219f7f5c4f743f6b4f Mon Sep 17 00:00:00 2001
From: Laurent MICHEL <laurent.michel@astro.unistra.fr>
Date: Tue, 24 Sep 2024 16:37:01 +0200
Subject: [PATCH 07/14] Damian's review + change log

---
 CHANGES.rst                                | 3 +++
 docs/mivot/index.rst                       | 2 +-
 pyvo/mivot/features/sky_coord_builder.py   | 4 +---
 pyvo/mivot/tests/test_sky_coord_builder.py | 2 +-
 4 files changed, 6 insertions(+), 5 deletions(-)

diff --git a/CHANGES.rst b/CHANGES.rst
index b7c78bfbc..12be5c7f3 100644
--- a/CHANGES.rst
+++ b/CHANGES.rst
@@ -45,6 +45,9 @@ Enhancements and Fixes
 
 - Tables returned by RegistryResource.get_tables() now have a utype
   attribute [#576]
+ 
+- MIVOT module: If the MIVOT annotation block contains a valid instance of the ``mango:EpochPosition` class,
+  the dynamic object describing the mapped data can generate a valid SkyCoord instance. [#591]
 
 Deprecations and Removals
 -------------------------
diff --git a/docs/mivot/index.rst b/docs/mivot/index.rst
index 587c14552..506a5689d 100644
--- a/docs/mivot/index.rst
+++ b/docs/mivot/index.rst
@@ -182,7 +182,7 @@ Once you get a ``MivotInstance`` representing the last row read, you can use it
 
 This feature works under the condition that the annotations contain a valid instance of ``mango:EPochPosition``. 
 Although not a standard at the time of writing, the class structure supported by this implementation must match the figure above.
-If the annotation do no contain any valid object, `None` is returned.
+If the annotations do not contain any valid object, `None` is returned.
 
 For XML Hackers
 ---------------
diff --git a/pyvo/mivot/features/sky_coord_builder.py b/pyvo/mivot/features/sky_coord_builder.py
index b07f70658..2a9abfe9a 100644
--- a/pyvo/mivot/features/sky_coord_builder.py
+++ b/pyvo/mivot/features/sky_coord_builder.py
@@ -43,7 +43,7 @@ class SkyCoordBuilder(object):
     - SkyCoord instances can only be built from model classes containing the minimal
     set of required parameters (a position).
     - In this implementation, only the mango:EpochPosition class is supported since
-      it proposes anything required to compute the epoch propagation which is a major use-case
+      it contains the information required to compute the epoch propagation which is a major use-case
     '''
 
     def __init__(self, mivot_instance_dict):
@@ -110,8 +110,6 @@ def _get_space_frame(self, obstime=None):
             self._map_coord_names = skycoord_param_default
             if "equinox" in coo_sys:
                 equinox = self._set_year_time_format(coo_sys["equinox"], True)
-                print(coo_sys["equinox"])
-                print(FK4(equinox=equinox, obstime="B345"))
                 return FK4(equinox=equinox, obstime=obstime)
             return FK4()
 
diff --git a/pyvo/mivot/tests/test_sky_coord_builder.py b/pyvo/mivot/tests/test_sky_coord_builder.py
index 0a235c506..79ed54a36 100644
--- a/pyvo/mivot/tests/test_sky_coord_builder.py
+++ b/pyvo/mivot/tests/test_sky_coord_builder.py
@@ -1,5 +1,5 @@
 '''
-The first service in operation the annotates query responses in the fly is Vizier
+The first service in operation that annotates query responses in the fly is Vizier
 https://cds/viz-bin/mivotconesearch/VizierParams
 Data are mapped on the mango:EpochPropagtion class as it is implemented in the current code.
 This test case is based on 2 VOTables:

From aad09bed9a094e7685e2cd2ea62e45c0e6cab539 Mon Sep 17 00:00:00 2001
From: Laurent MICHEL <laurent.michel@astro.unistra.fr>
Date: Tue, 24 Sep 2024 16:46:16 +0200
Subject: [PATCH 08/14] fix CI

---
 CHANGES.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/CHANGES.rst b/CHANGES.rst
index 12be5c7f3..e4b6f7758 100644
--- a/CHANGES.rst
+++ b/CHANGES.rst
@@ -46,7 +46,7 @@ Enhancements and Fixes
 - Tables returned by RegistryResource.get_tables() now have a utype
   attribute [#576]
  
-- MIVOT module: If the MIVOT annotation block contains a valid instance of the ``mango:EpochPosition` class,
+- MIVOT module: If the MIVOT annotation block contains a valid instance of the ``mango:EpochPosition`` class,
   the dynamic object describing the mapped data can generate a valid SkyCoord instance. [#591]
 
 Deprecations and Removals

From 833d9f1c252afe3c64dfcf772acd5c3f6af71dc4 Mon Sep 17 00:00:00 2001
From: lmichel <laurent.michel@astro.unistra.fr>
Date: Mon, 30 Sep 2024 09:19:34 +0200
Subject: [PATCH 09/14] raise a exception (NoMatchingDMType) when the API miss
 a Model object

---
 CHANGES.rst                                |  3 +
 docs/mivot/index.rst                       |  2 +-
 pyvo/mivot/features/sky_coord_builder.py   |  9 ++-
 pyvo/mivot/tests/test_sky_coord_builder.py | 68 ++++++++++++++++++++++
 pyvo/mivot/utils/exceptions.py             | 10 ++++
 5 files changed, 90 insertions(+), 2 deletions(-)

diff --git a/CHANGES.rst b/CHANGES.rst
index b7c78bfbc..42a08a399 100644
--- a/CHANGES.rst
+++ b/CHANGES.rst
@@ -46,6 +46,9 @@ Enhancements and Fixes
 - Tables returned by RegistryResource.get_tables() now have a utype
   attribute [#576]
 
+- The MIVOT model is able to automatically build SkyCoord instance from ``mango:EpochPosition`` instances [#591]
+
+
 Deprecations and Removals
 -------------------------
 
diff --git a/docs/mivot/index.rst b/docs/mivot/index.rst
index ce1f50a24..91c68127b 100644
--- a/docs/mivot/index.rst
+++ b/docs/mivot/index.rst
@@ -183,7 +183,7 @@ Once you get a ``MivotInstance`` representing the last row read, you can use it
 
 This feature works under the condition that the annotations contain a valid instance of ``mango:EPochPosition``. 
 Although not a standard at the time of writing, the class structure supported by this implementation must match the figure above.
-If the annotation do no contain any vali object, `None` is returned.
+If the annotation do no contain any valid object, a ``NoMatchingDMType`` exception is thrown.
 
 For XML Hackers
 ---------------
diff --git a/pyvo/mivot/features/sky_coord_builder.py b/pyvo/mivot/features/sky_coord_builder.py
index 2db2111c0..d3ed6dcfe 100644
--- a/pyvo/mivot/features/sky_coord_builder.py
+++ b/pyvo/mivot/features/sky_coord_builder.py
@@ -6,6 +6,7 @@
 from astropy.coordinates import SkyCoord
 from astropy import units as u
 from astropy.coordinates import ICRS, Galactic, FK4, FK5
+from pyvo.mivot.utils.exceptions import NoMatchingDMType
 
 
 class MangoRoles:
@@ -65,10 +66,16 @@ def build_sky_coord(self):
 
         returns
         -------
-        - SkyCoord instance or None
+        - SkyCoord instance
+
+        raises
+        ------
+        - NoMatchingDMType: if the SkyCoord instance cannot be built.
         """
         if self._mivot_instance_dict and self._mivot_instance_dict["dmtype"] == "mango:EpochPosition":
             return self._build_sky_coord_from_mango()
+        raise NoMatchingDMType("No INSTANCE with dmtype='mango:EpochPosition' has been found:"
+                               " cannot build a SkyCoord from annotations")
 
     def _set_year_time_format(self, hk_field, besselian=False):
         """
diff --git a/pyvo/mivot/tests/test_sky_coord_builder.py b/pyvo/mivot/tests/test_sky_coord_builder.py
index 06088985c..e0618a992 100644
--- a/pyvo/mivot/tests/test_sky_coord_builder.py
+++ b/pyvo/mivot/tests/test_sky_coord_builder.py
@@ -10,6 +10,7 @@
 from pyvo.mivot.version_checker import check_astropy_version
 from pyvo.mivot.viewer.mivot_instance import MivotInstance
 from pyvo.mivot.features.sky_coord_builder import SkyCoordBuilder
+from pyvo.mivot.utils.exceptions import NoMatchingDMType
 
 # annotations generated by Vizier as given to the MivotInstance
 vizier_dict = {
@@ -113,6 +114,73 @@
     },
 }
 
+# The same edited mapped on a dummy class
+vizier_dummy_type = {
+    "dmtype": "mango:DumyType",
+    "longitude": {
+        "dmtype": "ivoa:RealQuantity",
+        "value": 52.26722684,
+        "unit": "deg",
+        "ref": "RAICRS",
+    },
+    "latitude": {
+        "dmtype": "ivoa:RealQuantity",
+        "value": 59.94033461,
+        "unit": "deg",
+        "ref": "DEICRS",
+    },
+    "pmLongitude": {
+        "dmtype": "ivoa:RealQuantity",
+        "value": -0.82,
+        "unit": "mas/yr",
+        "ref": "pmRA",
+    },
+    "pmLatitude": {
+        "dmtype": "ivoa:RealQuantity",
+        "value": -1.85,
+        "unit": "mas/yr",
+        "ref": "pmDE",
+    },
+    "parallax": {
+        "dmtype": "ivoa:RealQuantity",
+        "value": 0.6,
+        "unit": "mas",
+        "ref": "parallax",
+    },
+    "epoch": {
+        "dmtype": "ivoa:RealQuantity",
+        "value": 1991.25,
+        "unit": "yr",
+        "ref": None,
+    },
+    "coordSys": {
+        "dmtype": "coords:SpaceSys",
+        "dmid": "SpaceFrame_ICRS",
+        "dmrole": "coords:Coordinate.coordSys",
+        "spaceRefFrame": {
+            "dmtype": "coords:SpaceFrame.spaceRefFrame",
+            "value": "FK5",
+            "unit": None,
+            "ref": None,
+        },
+        "equinox": {
+            "dmtype": "coords:SpaceFrame.equinox",
+            "value": "2012",
+            "unit": "yr",
+        },
+    },
+}
+
+
+def test_no_matching_mapping():
+    """
+    Test that a NoMatchingDMType is raised not mapped on mango:EpochPosition
+    """
+    with pytest.raises(NoMatchingDMType):
+        mivot_instance = MivotInstance(**vizier_dummy_type)
+        scb = SkyCoordBuilder(mivot_instance.to_dict())
+        scb.build_sky_coord()
+
 
 @pytest.mark.skipif(not check_astropy_version(), reason="need astropy 6+")
 def test_vizier_output():
diff --git a/pyvo/mivot/utils/exceptions.py b/pyvo/mivot/utils/exceptions.py
index 624e88680..049ba8a33 100644
--- a/pyvo/mivot/utils/exceptions.py
+++ b/pyvo/mivot/utils/exceptions.py
@@ -25,6 +25,16 @@ class MappingException(Exception):
     """
 
 
+class NoMatchingDMType(Exception):
+    """
+    Exception thrown when some PyVO code misses MIVOT element:
+    - When trying to build a SkyCoord while there is no position in the annotations
+    - is mapped to a model unknown to the PyVO code.
+    This exception is never caught by the mivot package.
+    It must be handled by the calling code.
+    """
+
+
 class AstropyVersionException(Exception):
     """
     Exception raised if the version of astropy is not compatible with MIVOT.

From 9a7263fcbf69340c56e9b70938d2b1f36fad7763 Mon Sep 17 00:00:00 2001
From: Laurent MICHEL <laurent.michel@astro.unistra.fr>
Date: Thu, 19 Sep 2024 17:43:18 +0200
Subject: [PATCH 10/14] Damian's review + change log

---
 CHANGES.rst                                | 3 +++
 docs/mivot/index.rst                       | 1 -
 pyvo/mivot/features/sky_coord_builder.py   | 6 ++----
 pyvo/mivot/tests/test_sky_coord_builder.py | 4 ++--
 4 files changed, 7 insertions(+), 7 deletions(-)

diff --git a/CHANGES.rst b/CHANGES.rst
index 42a08a399..1b7daaa5f 100644
--- a/CHANGES.rst
+++ b/CHANGES.rst
@@ -45,6 +45,9 @@ Enhancements and Fixes
 
 - Tables returned by RegistryResource.get_tables() now have a utype
   attribute [#576]
+ 
+- MIVOT module: If the MIVOT annotation block contains a valid instance of the ``mango:EpochPosition` class,
+  the dynamic object describing the mapped data can generate a valid SkyCoord instance. [#591]
 
 - The MIVOT model is able to automatically build SkyCoord instance from ``mango:EpochPosition`` instances [#591]
 
diff --git a/docs/mivot/index.rst b/docs/mivot/index.rst
index 91c68127b..82227ee16 100644
--- a/docs/mivot/index.rst
+++ b/docs/mivot/index.rst
@@ -173,7 +173,6 @@ Once you get a ``MivotInstance`` representing the last row read, you can use it
     :caption: Accessing the model view of Astropy table rows
 
 	from pyvo.mivot import MivotViewer
-    from pyvo.mivot.utils.dict_utils import DictUtils
     
     m_viewer = MivotViewer(path_to_votable)
     mivot_instance = m_viewer.dm_instance
diff --git a/pyvo/mivot/features/sky_coord_builder.py b/pyvo/mivot/features/sky_coord_builder.py
index d3ed6dcfe..acbd7ac24 100644
--- a/pyvo/mivot/features/sky_coord_builder.py
+++ b/pyvo/mivot/features/sky_coord_builder.py
@@ -44,7 +44,7 @@ class SkyCoordBuilder(object):
     - SkyCoord instances can only be built from model classes containing the minimal
     set of required parameters (a position).
     - In this implementation, only the mango:EpochPosition class is supported since
-      it proposes anything required to compute the epoch propagation which is a major use-case
+      it contains the information required to compute the epoch propagation which is a major use-case
     '''
 
     def __init__(self, mivot_instance_dict):
@@ -117,8 +117,6 @@ def _get_space_frame(self, obstime=None):
             self._map_coord_names = skycoord_param_default
             if "equinox" in coo_sys:
                 equinox = self._set_year_time_format(coo_sys["equinox"], True)
-                print(coo_sys["equinox"])
-                print(FK4(equinox=equinox, obstime="B345"))
                 return FK4(equinox=equinox, obstime=obstime)
             return FK4()
 
@@ -138,7 +136,7 @@ def _get_space_frame(self, obstime=None):
 
     def _build_sky_coord_from_mango(self):
         """
-        Build silently a SlyCoord instance from the mango:EpochPosition instance.
+        Build silently a SkyCoord instance from the mango:EpochPosition instance.
         No error is trapped, unconsistencies in the mango:EpochPosition instance will
         raise Astropy errors.
 
diff --git a/pyvo/mivot/tests/test_sky_coord_builder.py b/pyvo/mivot/tests/test_sky_coord_builder.py
index e0618a992..e10e78253 100644
--- a/pyvo/mivot/tests/test_sky_coord_builder.py
+++ b/pyvo/mivot/tests/test_sky_coord_builder.py
@@ -1,9 +1,9 @@
 '''
-The first service in operation the annotates query responses in the fly is Vizier
+The first service in operation that annotates query responses in the fly is Vizier
 https://cds/viz-bin/mivotconesearch/VizierParams
 Data are mapped on the mango:EpochPropagtion class as it is implemented in the current code.
 This test case is based on 2 VOTables:
-Both tests check the generation of SkyCoord instances from the MivotInstances buil
+Both tests check the generation of SkyCoord instances from the MivotInstances built
 for the output of this service.
 '''
 import pytest

From cfdac89516c3a4bc0090ac8307384a61c31edb8a Mon Sep 17 00:00:00 2001
From: Laurent MICHEL <laurent.michel@astro.unistra.fr>
Date: Tue, 24 Sep 2024 16:46:16 +0200
Subject: [PATCH 11/14] fix CI

---
 CHANGES.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/CHANGES.rst b/CHANGES.rst
index 1b7daaa5f..5c58eddb9 100644
--- a/CHANGES.rst
+++ b/CHANGES.rst
@@ -46,7 +46,7 @@ Enhancements and Fixes
 - Tables returned by RegistryResource.get_tables() now have a utype
   attribute [#576]
  
-- MIVOT module: If the MIVOT annotation block contains a valid instance of the ``mango:EpochPosition` class,
+- MIVOT module: If the MIVOT annotation block contains a valid instance of the ``mango:EpochPosition`` class,
   the dynamic object describing the mapped data can generate a valid SkyCoord instance. [#591]
 
 - The MIVOT model is able to automatically build SkyCoord instance from ``mango:EpochPosition`` instances [#591]

From c614ee40c661521b274b8fb73677e9356b1cd4a6 Mon Sep 17 00:00:00 2001
From: lmichel <laurent.michel@astro.unistra.fr>
Date: Tue, 1 Oct 2024 09:28:11 +0200
Subject: [PATCH 12/14] NoMatchingDMType renamed as NoMatchingDMTypeError

---
 docs/mivot/index.rst                       | 3 ++-
 pyvo/mivot/features/sky_coord_builder.py   | 6 +++---
 pyvo/mivot/tests/test_sky_coord_builder.py | 6 +++---
 pyvo/mivot/utils/exceptions.py             | 2 +-
 4 files changed, 9 insertions(+), 8 deletions(-)

diff --git a/docs/mivot/index.rst b/docs/mivot/index.rst
index f19bae385..c86b6df8a 100644
--- a/docs/mivot/index.rst
+++ b/docs/mivot/index.rst
@@ -180,7 +180,8 @@ Once you get a ``MivotInstance`` representing the last row read, you can use it
     <SkyCoord (ICRS): (ra, dec) in deg(52.26722684, 59.94033461)
           (pm_ra_cosdec, pm_dec) in mas / yr(-0.82, -1.85)>
 
-This feature works under the condition that the annotations contain a valid instance of ``mango:EPochPosition``. 
+This feature works under the condition that the annotations contain a valid instance of ``mango:EPochPosition``, otherwise
+a ``NoMatchingDMTypeError`` is thrown. 
 Although not a standard at the time of writing, the class structure supported by this implementation must match the figure above.
 
 
diff --git a/pyvo/mivot/features/sky_coord_builder.py b/pyvo/mivot/features/sky_coord_builder.py
index acbd7ac24..898353c51 100644
--- a/pyvo/mivot/features/sky_coord_builder.py
+++ b/pyvo/mivot/features/sky_coord_builder.py
@@ -6,7 +6,7 @@
 from astropy.coordinates import SkyCoord
 from astropy import units as u
 from astropy.coordinates import ICRS, Galactic, FK4, FK5
-from pyvo.mivot.utils.exceptions import NoMatchingDMType
+from pyvo.mivot.utils.exceptions import NoMatchingDMTypeError
 
 
 class MangoRoles:
@@ -70,11 +70,11 @@ def build_sky_coord(self):
 
         raises
         ------
-        - NoMatchingDMType: if the SkyCoord instance cannot be built.
+        - NoMatchingDMTypeError: if the SkyCoord instance cannot be built.
         """
         if self._mivot_instance_dict and self._mivot_instance_dict["dmtype"] == "mango:EpochPosition":
             return self._build_sky_coord_from_mango()
-        raise NoMatchingDMType("No INSTANCE with dmtype='mango:EpochPosition' has been found:"
+        raise NoMatchingDMTypeError("No INSTANCE with dmtype='mango:EpochPosition' has been found:"
                                " cannot build a SkyCoord from annotations")
 
     def _set_year_time_format(self, hk_field, besselian=False):
diff --git a/pyvo/mivot/tests/test_sky_coord_builder.py b/pyvo/mivot/tests/test_sky_coord_builder.py
index e10e78253..346bc6769 100644
--- a/pyvo/mivot/tests/test_sky_coord_builder.py
+++ b/pyvo/mivot/tests/test_sky_coord_builder.py
@@ -10,7 +10,7 @@
 from pyvo.mivot.version_checker import check_astropy_version
 from pyvo.mivot.viewer.mivot_instance import MivotInstance
 from pyvo.mivot.features.sky_coord_builder import SkyCoordBuilder
-from pyvo.mivot.utils.exceptions import NoMatchingDMType
+from pyvo.mivot.utils.exceptions import NoMatchingDMTypeError
 
 # annotations generated by Vizier as given to the MivotInstance
 vizier_dict = {
@@ -174,9 +174,9 @@
 
 def test_no_matching_mapping():
     """
-    Test that a NoMatchingDMType is raised not mapped on mango:EpochPosition
+    Test that a NoMatchingDMTypeError is raised not mapped on mango:EpochPosition
     """
-    with pytest.raises(NoMatchingDMType):
+    with pytest.raises(NoMatchingDMTypeError):
         mivot_instance = MivotInstance(**vizier_dummy_type)
         scb = SkyCoordBuilder(mivot_instance.to_dict())
         scb.build_sky_coord()
diff --git a/pyvo/mivot/utils/exceptions.py b/pyvo/mivot/utils/exceptions.py
index 049ba8a33..7e688b57c 100644
--- a/pyvo/mivot/utils/exceptions.py
+++ b/pyvo/mivot/utils/exceptions.py
@@ -25,7 +25,7 @@ class MappingException(Exception):
     """
 
 
-class NoMatchingDMType(Exception):
+class NoMatchingDMTypeError(Exception):
     """
     Exception thrown when some PyVO code misses MIVOT element:
     - When trying to build a SkyCoord while there is no position in the annotations

From f60533be7ab126a3d604ab69eab636acdb566bdc Mon Sep 17 00:00:00 2001
From: lmichel <laurent.michel@astro.unistra.fr>
Date: Tue, 1 Oct 2024 11:00:41 +0200
Subject: [PATCH 13/14] Make docstrings compliant with the numpy style, make
 some comments more explicit

---
 pyvo/mivot/features/sky_coord_builder.py | 60 ++++++++++++++----------
 1 file changed, 35 insertions(+), 25 deletions(-)

diff --git a/pyvo/mivot/features/sky_coord_builder.py b/pyvo/mivot/features/sky_coord_builder.py
index 898353c51..7bdf48774 100644
--- a/pyvo/mivot/features/sky_coord_builder.py
+++ b/pyvo/mivot/features/sky_coord_builder.py
@@ -1,6 +1,6 @@
 # Licensed under a 3-clause BSD style license - see LICENSE.rst
 """
-Utility transforming MIVOT annotation into SKYCoord instances
+Utility transforming MIVOT annotation into SkyCoord instances
 """
 
 from astropy.coordinates import SkyCoord
@@ -11,7 +11,7 @@
 
 class MangoRoles:
     """
-    Place holder for the roles of the mango:EpochPosition roles
+    Place holder for the roles (attribute names) of the mango:EpochPosition class
     """
     LONGITUDE = "longitude"
     LATITUDE = "latitude"
@@ -42,7 +42,7 @@ class SkyCoordBuilder(object):
     Utility generating SkyCoord instances from MIVOT annotations
 
     - SkyCoord instances can only be built from model classes containing the minimal
-    set of required parameters (a position).
+      set of required parameters (a position).
     - In this implementation, only the mango:EpochPosition class is supported since
       it contains the information required to compute the epoch propagation which is a major use-case
     '''
@@ -53,41 +53,49 @@ def __init__(self, mivot_instance_dict):
 
         parameters
         -----------
-        - mivot_instance_dict: viewer.MivotInstance.to_dict()
-                               Internal dictionary of the dynamic Python object generated
-                               from the MIVOT block
+        mivot_instance_dict: viewer.MivotInstance.to_dict()
+            Internal dictionary of the dynamic Python object generated from the MIVOT block
         '''
         self._mivot_instance_dict = mivot_instance_dict
         self._map_coord_names = None
 
     def build_sky_coord(self):
         """
-        Build a SkyCoord instance from the dynamic Python object attribute.
+        Build a SkyCoord instance from the MivotInstance dictionary.
+        The operation requires the dictionary to have ``mango:EpochPosition`` as dmtype
+        This is a public method which could be extended to support other dmtypes.
 
         returns
         -------
-        - SkyCoord instance
+        SkyCoord
+            Instance built by the method
 
         raises
         ------
-        - NoMatchingDMTypeError: if the SkyCoord instance cannot be built.
+        NoMatchingDMTypeError
+            if the SkyCoord instance cannot be built.
         """
         if self._mivot_instance_dict and self._mivot_instance_dict["dmtype"] == "mango:EpochPosition":
             return self._build_sky_coord_from_mango()
-        raise NoMatchingDMTypeError("No INSTANCE with dmtype='mango:EpochPosition' has been found:"
-                               " cannot build a SkyCoord from annotations")
+        raise NoMatchingDMTypeError(
+            "No INSTANCE with dmtype='mango:EpochPosition' has been found:"
+            " cannot build a SkyCoord from annotations")
 
     def _set_year_time_format(self, hk_field, besselian=False):
         """
-        Format a date expressed in year as J-year
+        Format a date expressed in year as [scale]year
 
         parameters
         ----------
-        - hk_field: MIVOT instance parameter as a dict
+        hk_field: dict
+            MIVOT instance attribute
+        besselian: boolean
+            besselian time scale is used if True, otherwise Julian (default)
 
         returns
         -------
-        - formatted string
+        string
+            attribute value formatted as [scale]year
         """
         scale = "J" if not besselian else "B"
         return (f"{scale}{hk_field['value']}" if hk_field["unit"] in ("yr", "year")
@@ -97,17 +105,18 @@ def _get_space_frame(self, obstime=None):
         """
         Build an astropy space frame instance from the MIVOT annotations.
 
-        - Equinox are supported fot FK4/5
-        - Ref location are not supported
+        - Equinox are supported for FK4/5
+        - Reference location is not supported
 
         parameters
         ----------
-        - obstime: string
-                   Observation time is given here because KF4 set an default value
-                   if it is not given
+        obstime: str
+            Observation time is given to the space frame builder (this method) because
+            it must be set by the coordinate system constructor in case of FK4 frame.
         returns
         -------
-        - Astropy space frame
+        FK2, FK5, ICRS or Galactic
+            Astropy space frame instance
         """
         coo_sys = self._mivot_instance_dict["coordSys"]
         equinox = None
@@ -136,18 +145,19 @@ def _get_space_frame(self, obstime=None):
 
     def _build_sky_coord_from_mango(self):
         """
-        Build silently a SkyCoord instance from the mango:EpochPosition instance.
-        No error is trapped, unconsistencies in the mango:EpochPosition instance will
+        Build silently a SkyCoord instance from the ``mango:EpochPosition instance``.
+        No error is trapped, unconsistencies in the ``mango:EpochPosition`` instance will
         raise Astropy errors.
 
-        - The epoch (obstime) is meant to be given as J-year.
+        - The epoch (obstime) is meant to be given in year.
         - ICRS frame is taken by default
         - The cos-delta correction is meant to be applied.
-          The case mango:pmCosDeltApplied = False is not suppored yet
+          The case ``mango:pmCosDeltApplied = False`` is not supported yet
 
         returns
         -------
-        - SkyCoord instance
+        SkyCoord
+            instance built by the method
         """
         kwargs = {}
         kwargs["frame"] = self._get_space_frame()

From ff0eeeaf585a1492ba3233816e1f8e61cc0e8233 Mon Sep 17 00:00:00 2001
From: lmichel <laurent.michel@astro.unistra.fr>
Date: Tue, 1 Oct 2024 11:19:34 +0200
Subject: [PATCH 14/14] Rename Exceptions

- MappingException renamed as MappingError and MivotException as MivotError
- NoMatchingDMTypeError typed as child of TypeError.
- Both MappingError and MivotError keep children of Exception.
---
 .../features/static_reference_resolver.py     |  6 ++---
 pyvo/mivot/seekers/annotation_seeker.py       | 10 ++++-----
 pyvo/mivot/tests/test_mivot_viewer.py         |  6 ++---
 pyvo/mivot/tests/test_vizier_cs.py            |  4 ++--
 pyvo/mivot/tests/test_xml_viewer.py           | 14 ++++++------
 pyvo/mivot/utils/dict_utils.py                |  4 ++--
 pyvo/mivot/utils/exceptions.py                | 10 ++++-----
 pyvo/mivot/utils/xml_utils.py                 |  4 ++--
 pyvo/mivot/viewer/mivot_viewer.py             | 22 +++++++++----------
 pyvo/mivot/viewer/xml_viewer.py               |  8 +++----
 10 files changed, 44 insertions(+), 44 deletions(-)

diff --git a/pyvo/mivot/features/static_reference_resolver.py b/pyvo/mivot/features/static_reference_resolver.py
index 8e194c5c8..fd376e924 100644
--- a/pyvo/mivot/features/static_reference_resolver.py
+++ b/pyvo/mivot/features/static_reference_resolver.py
@@ -2,7 +2,7 @@
 Class used to resolve each static REFERENCE found in mivot_block.
 """
 from copy import deepcopy
-from pyvo.mivot.utils.exceptions import MivotException
+from pyvo.mivot.utils.exceptions import MivotError
 from pyvo.mivot.utils.xpath_utils import XPath
 from pyvo.utils.prototype import prototype_feature
 
@@ -33,7 +33,7 @@ def resolve(annotation_seeker, templates_ref, mivot_block):
             The number of references resolved.
         Raises
         ------
-        MappingException
+        MappingError
             If the reference cannot be resolved.
         NotImplementedError
             If the reference is dynamic.
@@ -50,7 +50,7 @@ def resolve(annotation_seeker, templates_ref, mivot_block):
                 target = annotation_seeker.get_templates_instance_by_dmid(templates_ref, dmref)
                 found_in_global = False
             if target is None:
-                raise MivotException(f"Cannot resolve reference={dmref}")
+                raise MivotError(f"Cannot resolve reference={dmref}")
             # Resolve static references recursively
             if not found_in_global:
                 StaticReferenceResolver.resolve(annotation_seeker, templates_ref, ele)
diff --git a/pyvo/mivot/seekers/annotation_seeker.py b/pyvo/mivot/seekers/annotation_seeker.py
index 4f74eca5c..5c0d718a6 100644
--- a/pyvo/mivot/seekers/annotation_seeker.py
+++ b/pyvo/mivot/seekers/annotation_seeker.py
@@ -3,7 +3,7 @@
 Utilities for extracting sub-blocks from a MIVOT mapping block.
 """
 import logging
-from pyvo.mivot.utils.exceptions import MivotException, MappingException
+from pyvo.mivot.utils.exceptions import MivotError, MappingError
 from pyvo.mivot.utils.vocabulary import Att, Ele
 from pyvo.mivot.utils.vocabulary import Constant
 from pyvo.mivot.utils.xpath_utils import XPath
@@ -73,7 +73,7 @@ def _find_templates_blocks(self):
                     logging.debug("Found " + Ele.TEMPLATES + " without " + Att.tableref)
                     self._templates_blocks["DEFAULT"] = child
                 else:
-                    raise MivotException(Ele.TEMPLATES + " without " + Att.tableref + " must be unique")
+                    raise MivotError(Ele.TEMPLATES + " without " + Att.tableref + " must be unique")
 
     def _rename_ref_and_join(self):
         """
@@ -391,7 +391,7 @@ def get_collection_item_by_primarykey(self, coll_dmid, key_value):
         Raises
         ------
         MivotElementNotFound: If no element matches the criteria.
-        MappingException: If more than one element matches the criteria.
+        MappingError: If more than one element matches the criteria.
         """
         eset = XPath.x_path(self._globals_block, ".//" + Ele.COLLECTION + "[@" + Att.dmid + "='"
                             + coll_dmid + "']/" + Ele.INSTANCE + "/" + Att.primarykey
@@ -400,14 +400,14 @@ def get_collection_item_by_primarykey(self, coll_dmid, key_value):
             message = (f"{Ele.INSTANCE} with {Att.primarykey} = {key_value} in "
                        f"{Ele.COLLECTION} {Att.dmid} {key_value} not found"
                        )
-            raise MivotException(message)
+            raise MivotError(message)
         if len(eset) > 1:
             message = (
                 f"More than one {Ele.INSTANCE} with {Att.primarykey}"
                 f" = {key_value} found in {Ele.COLLECTION} "
                 f"{Att.dmid} {key_value}"
             )
-            raise MappingException(message)
+            raise MappingError(message)
         logging.debug(Ele.INSTANCE + " with " + Att.primarykey + "=%s found in "
                      + Ele.COLLECTION + " "
                      + Att.dmid + "=%s", key_value, coll_dmid)
diff --git a/pyvo/mivot/tests/test_mivot_viewer.py b/pyvo/mivot/tests/test_mivot_viewer.py
index 866839c8e..20fb63f85 100644
--- a/pyvo/mivot/tests/test_mivot_viewer.py
+++ b/pyvo/mivot/tests/test_mivot_viewer.py
@@ -8,7 +8,7 @@
 from astropy.utils.data import get_pkg_data_filename
 from pyvo.mivot.utils.vocabulary import Constant
 from pyvo.mivot.utils.dict_utils import DictUtils
-from pyvo.mivot.utils.exceptions import MappingException
+from pyvo.mivot.utils.exceptions import MappingError
 from pyvo.mivot.version_checker import check_astropy_version
 from pyvo.mivot import MivotViewer
 from astropy import version as astropy_version
@@ -84,9 +84,9 @@ def test_no_mivot(path_no_mivot):
     assert m_viewer.get_globals_models() is None
 
     assert m_viewer.get_templates_models() is None
-    with pytest.raises(MappingException):
+    with pytest.raises(MappingError):
         m_viewer._connect_table('_PKTable')
-    with pytest.raises(MappingException):
+    with pytest.raises(MappingError):
         m_viewer._connect_table()
 
     assert m_viewer.next_table_row() is None
diff --git a/pyvo/mivot/tests/test_vizier_cs.py b/pyvo/mivot/tests/test_vizier_cs.py
index 52c5ed696..573430cec 100644
--- a/pyvo/mivot/tests/test_vizier_cs.py
+++ b/pyvo/mivot/tests/test_vizier_cs.py
@@ -21,7 +21,7 @@
 from urllib.request import urlretrieve
 from pyvo.mivot.version_checker import check_astropy_version
 from pyvo.mivot import MivotViewer
-from pyvo.mivot.utils.exceptions import MivotException
+from pyvo.mivot.utils.exceptions import MivotError
 
 
 @pytest.fixture
@@ -125,5 +125,5 @@ def test_bad_ref(path_to_badref, delt_coo):
     """ Test that the epoch propagation works with all FIELDs referenced by name or by ID
     """
     # Test with all FILELDs referenced by names
-    with (pytest.raises(MivotException, match="Attribute mango:EpochPosition.epoch can not be set.*")):
+    with (pytest.raises(MivotError, match="Attribute mango:EpochPosition.epoch can not be set.*")):
         MivotViewer(votable_path=path_to_badref)
diff --git a/pyvo/mivot/tests/test_xml_viewer.py b/pyvo/mivot/tests/test_xml_viewer.py
index 8431c500b..e0dde04ea 100644
--- a/pyvo/mivot/tests/test_xml_viewer.py
+++ b/pyvo/mivot/tests/test_xml_viewer.py
@@ -10,7 +10,7 @@
 from astropy.utils.data import get_pkg_data_filename
 from pyvo.mivot.version_checker import check_astropy_version
 from pyvo.mivot import MivotViewer
-from pyvo.mivot.utils.exceptions import MivotException
+from pyvo.mivot.utils.exceptions import MivotError
 
 
 @pytest.mark.skipif(not check_astropy_version(), reason="need astropy 6+")
@@ -18,27 +18,27 @@ def test_xml_viewer(m_viewer):
 
     m_viewer.next()
     xml_viewer = m_viewer.xml_viewer
-    with pytest.raises(MivotException,
+    with pytest.raises(MivotError,
                        match="Cannot find dmrole wrong_role in any instances of the VOTable"):
         xml_viewer.get_instance_by_role("wrong_role")
 
-    with pytest.raises(MivotException,
+    with pytest.raises(MivotError,
                        match="Cannot find dmrole wrong_role in any instances of the VOTable"):
         xml_viewer.get_instance_by_role("wrong_role", all_instances=True)
 
-    with pytest.raises(MivotException,
+    with pytest.raises(MivotError,
                        match="Cannot find dmtype wrong_dmtype in any instances of the VOTable"):
         xml_viewer.get_instance_by_type("wrong_dmtype")
 
-    with pytest.raises(MivotException,
+    with pytest.raises(MivotError,
                        match="Cannot find dmtype wrong_dmtype in any instances of the VOTable"):
         xml_viewer.get_instance_by_type("wrong_dmtype", all_instances=True)
 
-    with pytest.raises(MivotException,
+    with pytest.raises(MivotError,
                        match="Cannot find dmrole wrong_role in any collections of the VOTable"):
         xml_viewer.get_collection_by_role("wrong_role")
 
-    with pytest.raises(MivotException,
+    with pytest.raises(MivotError,
                        match="Cannot find dmrole wrong_role in any collections of the VOTable"):
         xml_viewer.get_collection_by_role("wrong_role", all_instances=True)
 
diff --git a/pyvo/mivot/utils/dict_utils.py b/pyvo/mivot/utils/dict_utils.py
index bd9d76e97..679c55a23 100644
--- a/pyvo/mivot/utils/dict_utils.py
+++ b/pyvo/mivot/utils/dict_utils.py
@@ -3,7 +3,7 @@
 """
 import json
 import logging
-from pyvo.mivot.utils.exceptions import MivotException
+from pyvo.mivot.utils.exceptions import MivotError
 from pyvo.mivot.utils.json_encoder import MivotJsonEncoder
 
 
@@ -31,7 +31,7 @@ def read_dict_from_file(filename, fatal=False):
                 return json.load(file, object_pairs_hook=OrderedDict)
         except Exception as exception:
             if fatal:
-                raise MivotException("reading {}".format(filename))
+                raise MivotError("reading {}".format(filename))
             else:
                 logging.error("{} reading {}".format(exception, filename))
 
diff --git a/pyvo/mivot/utils/exceptions.py b/pyvo/mivot/utils/exceptions.py
index 7e688b57c..16944d090 100644
--- a/pyvo/mivot/utils/exceptions.py
+++ b/pyvo/mivot/utils/exceptions.py
@@ -3,19 +3,19 @@
 
 3 exception classes
 - AstropyVersionException that prevent to use the package
-- MappingException if the annotation cannot be processed (e.g. no MIVOT block)
+- MappingError if the annotation cannot be processed (e.g. no MIVOT block)
   but the VOtable parsing can continue
-- MivotException in any other case (block the processing)
+- MivotError in any other case (block the processing)
 """
 
 
-class MivotException(Exception):
+class MivotError(Exception):
     """
     The annotation block is there but something went wrong with its processing
     """
 
 
-class MappingException(Exception):
+class MappingError(Exception):
     """
     Exception raised if a Resource or MIVOT element can't be mapped for one of these reasons:
     - It doesn't match with any Resource/MIVOT element expected.
@@ -25,7 +25,7 @@ class MappingException(Exception):
     """
 
 
-class NoMatchingDMTypeError(Exception):
+class NoMatchingDMTypeError(TypeError):
     """
     Exception thrown when some PyVO code misses MIVOT element:
     - When trying to build a SkyCoord while there is no position in the annotations
diff --git a/pyvo/mivot/utils/xml_utils.py b/pyvo/mivot/utils/xml_utils.py
index 7c3f40cc9..83f15a108 100644
--- a/pyvo/mivot/utils/xml_utils.py
+++ b/pyvo/mivot/utils/xml_utils.py
@@ -5,7 +5,7 @@
 import xml.etree.ElementTree as ET
 from pyvo.mivot.utils.vocabulary import Constant
 from pyvo.mivot.utils.vocabulary import Att
-from pyvo.mivot.utils.exceptions import MivotException
+from pyvo.mivot.utils.exceptions import MivotError
 
 
 class XmlUtils:
@@ -95,7 +95,7 @@ def add_column_indices(mapping_block, index_map):
                             break
                 if not field_desc:
                     if not ele.get(Att.value):
-                        raise MivotException(
+                        raise MivotError(
                             f"Attribute {ele.get(Att.dmrole)} can not be set:"
                             f" references a non existing column: {attr_ref} "
                             f"and has no default value")
diff --git a/pyvo/mivot/viewer/mivot_viewer.py b/pyvo/mivot/viewer/mivot_viewer.py
index a6f1224f7..2521036d2 100644
--- a/pyvo/mivot/viewer/mivot_viewer.py
+++ b/pyvo/mivot/viewer/mivot_viewer.py
@@ -29,8 +29,8 @@
 from pyvo.dal import DALResults
 from pyvo.mivot.utils.vocabulary import Ele, Att
 from pyvo.mivot.utils.vocabulary import Constant, NoMapping
-from pyvo.mivot.utils.exceptions import (MappingException,
-                                         MivotException,
+from pyvo.mivot.utils.exceptions import (MappingError,
+                                         MivotError,
                                          AstropyVersionException)
 from pyvo.mivot.utils.xml_utils import XmlUtils
 from pyvo.mivot.utils.xpath_utils import XPath
@@ -100,7 +100,7 @@ def __init__(self, votable_path, tableref=None):
             self._set_mapped_tables()
             self._connect_table(tableref)
             self._init_instance()
-        except MappingException as mnf:
+        except MappingError as mnf:
             logging.error(str(mnf))
 
     def __enter__(self):
@@ -325,7 +325,7 @@ def get_first_instance_dmtype(self, tableref=None):
             elif child[0] in collection:
                 return collection[0].get(Att.dmtype)
         else:
-            raise MivotException("Can't find the first " + Ele.INSTANCE
+            raise MivotError("Can't find the first " + Ele.INSTANCE
                                        + "/" + Ele.COLLECTION + " in " + Ele.TEMPLATES)
 
     def _connect_table(self, tableref=None):
@@ -340,7 +340,7 @@ def _connect_table(self, tableref=None):
             Identifier of the table. If None, connects to the first table.
         """
         if not self._resource_seeker:
-            raise MappingException("No mapping block found")
+            raise MappingError("No mapping block found")
 
         stableref = tableref
         if tableref is None:
@@ -350,7 +350,7 @@ def _connect_table(self, tableref=None):
                          "the mapping will be applied to the first table."
                          )
         elif tableref not in self._mapped_tables:
-            raise MappingException(f"The table {self._connected_tableref} doesn't match with any "
+            raise MappingError(f"The table {self._connected_tableref} doesn't match with any "
                                    f"mapped_table ({self._mapped_tables}) encountered in "
                                    + Ele.TEMPLATES
                                    )
@@ -359,11 +359,11 @@ def _connect_table(self, tableref=None):
 
         self._connected_table = self._resource_seeker.get_table(tableref)
         if self.connected_table is None:
-            raise MivotException(f"Cannot find table {stableref} in VOTable")
+            raise MivotError(f"Cannot find table {stableref} in VOTable")
         logging.debug("table %s found in VOTable", stableref)
         self._templates = deepcopy(self.annotation_seeker.get_templates_block(tableref))
         if self._templates is None:
-            raise MivotException("Cannot find " + Ele.TEMPLATES + f" {stableref} ")
+            raise MivotError("Cannot find " + Ele.TEMPLATES + f" {stableref} ")
         logging.debug(Ele.TEMPLATES + " %s found ", stableref)
         self._table_iterator = TableIterator(self._connected_tableref,
                                              self.connected_table.to_table())
@@ -432,7 +432,7 @@ def _set_resource(self):
         """
 
         if len(self._parsed_votable.resources) < 1:
-            raise MivotException("No resource detected in the VOTable")
+            raise MivotError("No resource detected in the VOTable")
         rnb = 0
         for res in self._parsed_votable.resources:
             if res.type.lower() == "results":
@@ -440,14 +440,14 @@ def _set_resource(self):
                 self._resource = self._parsed_votable.resources[rnb]
                 return
             rnb += 1
-        raise MivotException("No resource @type='results'detected in the VOTable")
+        raise MivotError("No resource @type='results'detected in the VOTable")
 
     def _set_mapping_block(self):
         """
         Set the mapping block found in the resource and set the annotation_seeker
         """
         if NoMapping.search(self._resource.mivot_block.content):
-            raise MappingException("Mivot block is not found")
+            raise MappingError("Mivot block is not found")
         # The namespace should be removed
         self._mapping_block = (
             etree.fromstring(self._resource.mivot_block.content
diff --git a/pyvo/mivot/viewer/xml_viewer.py b/pyvo/mivot/viewer/xml_viewer.py
index 75103a0ec..fd69e79ce 100644
--- a/pyvo/mivot/viewer/xml_viewer.py
+++ b/pyvo/mivot/viewer/xml_viewer.py
@@ -3,7 +3,7 @@
 XMLViewer provides several getters on XML instances built by
  `pyvo.mivot.viewer.mivot_viewer`.
 """
-from pyvo.mivot.utils.exceptions import MivotException
+from pyvo.mivot.utils.exceptions import MivotError
 from pyvo.mivot.utils.xpath_utils import XPath
 from pyvo.utils.prototype import prototype_feature
 
@@ -60,7 +60,7 @@ def get_instance_by_role(self, dmrole, all_instances=False):
             dmrole)
 
         if len(instances) == 0:
-            raise MivotException(
+            raise MivotError(
                 f"Cannot find dmrole {dmrole} in any instances of the VOTable")
 
         if all_instances is False:
@@ -98,7 +98,7 @@ def get_instance_by_type(self, dmtype, all_instances=False):
             dmtype)
 
         if len(instances) == 0:
-            raise MivotException(
+            raise MivotError(
                 f"Cannot find dmtype {dmtype} in any instances of the VOTable")
 
         if all_instances is False:
@@ -136,7 +136,7 @@ def get_collection_by_role(self, dmrole, all_instances=False):
             dmrole)
 
         if len(collections) == 0:
-            raise MivotException(
+            raise MivotError(
                 f"Cannot find dmrole {dmrole} in any collections of the VOTable")
 
         if all_instances is False: