Merge branch 'master' into pybullet_fk

Author: beverlylytle

.github/workflows/integration.yml

@@ -44,3 +44,14 @@ jobs:
         if: ${{ success() }}
         run: |
           invoke docs
+          mkdir -p deploy/compas_fab/edge && mv -T dist/docs deploy/compas_fab/edge/
+      - name: Deploy docs
+        if: success()
+        uses: crazy-max/ghaction-github-pages@v2
+        with:
+          repo: gramaziokohler/gramaziokohler.github.io
+          target_branch: master
+          build_dir: deploy
+          keep_history: true
+        env:
+          GH_PAT: ${{ secrets.GH_PAT }}

src/compas_fab/robots/configuration.py

@@ -11,16 +11,36 @@
 
 class Configuration(object):
     """Represents the configuration of a robot based on the state of its joints.
-    This concept is also refered to as `Joint State`.
 
-    Attributes
+    This concept is also refered to as \"Joint State\".
+
+    Parameters
     ----------
     values : :obj:`list` of :obj:`float`
-        Joint values expressed in radians or meters, depending on the respective type.
-    types : list of :class:`compas.robots.Joint.TYPE`
-        Joint types, e.g. a list of `compas.robots.Joint.REVOLUTE` for revolute joints.
+        Joint values expressed in radians or meters, depending on the respective
+        type.
+    types : :obj:`list` of :attr:`compas.robots.Joint.SUPPORTED_TYPES`
+        Joint types, e.g. a list of :attr:`compas.robots.Joint.REVOLUTE` for
+        revolute joints.
     joint_names : :obj:`list` of :obj:`str`, optional
-        Joint names list
+        List of joint names.
+
+    Attributes
+    ----------
+    values : :obj:`list` of :obj:`float`
+        Joint values expressed in radians or meters, depending on the respective
+        type.
+    types : :obj:`list` of :attr:`compas.robots.Joint.SUPPORTED_TYPES`
+        Joint types, e.g. a list of :attr:`compas.robots.Joint.REVOLUTE` for
+        revolute joints.
+    joint_names : :obj:`list` of :obj:`str`
+        List of joint names.
+    data : :obj:`dict`
+        The data representing the configuration.
+    prismatic_values : :obj:`list` of :obj:`float`
+        Prismatic joint values in meters.
+    revolute_values : :obj:`list` of :obj:`float`
+        Revolute joint values in radians.
 
     Examples
     --------
@@ -52,13 +72,15 @@ def __init__(self, values=None, types=None, joint_names=None):
                 len(self.values), len(self.values), len(self.types)))
 
     def __str__(self):
+        """Return a human-readable string representation of the instance."""
         v_str = ('(' + ", ".join(['%.' + self._precision] * len(self.values)) + ')') % tuple(self.values)
         if len(self.joint_names):
             return "Configuration({}, {}, {})".format(v_str, tuple(self.types), tuple(self.joint_names))
         else:
             return "Configuration({}, {})".format(v_str, tuple(self.types))
 
     def __repr__(self):
+        """Printable representation of :class:`Configuration`."""
         return self.__str__()
 
     @classmethod
@@ -92,7 +114,7 @@ def from_prismatic_and_revolute_values(cls, prismatic_values, revolute_values):
         Returns
         -------
         :class:`Configuration`
-             An instance of :class:`Configuration` instance.
+             An instance of :class:`Configuration`.
         """
         # Force iterables into lists
         prismatic_values = list(prismatic_values)
@@ -114,24 +136,33 @@ def from_data(cls, data):
         Returns
         -------
         :class:`Configuration`
-             An instance of :class:`Configuration` instance.
+             An instance of :class:`Configuration`.
         """
         config = cls()
         config.data = data
         return config
 
     def to_data(self):
-        """Return the data dictionary that represents the configuration, and from
-        which it can be reconstructed."""
+        """Get the data dictionary that represents the configuration.
+
+        This data can also be used to reconstruct the :class:`Configuration`
+        instance.
+
+        Returns
+        -------
+        :obj:`dict`
+            The data representing the configuration.
+        """
         return self.data
 
     @property
     def data(self):
         """:obj:`dict` : The data representing the configuration.
 
-        By assigning a data dictionary to this property, the current data of the
-        configuration will be replaced by the data in the dict. The data getter
-        and setter should always be used in combination with each other.
+        By assigning a data dictionary to this property, the current data of
+        the configuration will be replaced by the data in the :obj:`dict`. The
+        data getter and setter should always be used in combination with each
+        other.
         """
         return {
             'values': self.values,
@@ -149,7 +180,8 @@ def data(self, data):
     def prismatic_values(self):
         """:obj:`list` of :obj:`float` : Prismatic joint values in meters.
 
-        E.g. positions on the external axis system."""
+        E.g. positions on the external axis system.
+        """
         return [v for i, v in enumerate(self.values) if self.types[i] == Joint.PRISMATIC]
 
     @property
@@ -158,6 +190,13 @@ def revolute_values(self):
         return [v for i, v in enumerate(self.values) if self.types[i] == Joint.REVOLUTE]
 
     def copy(self):
+        """Create a copy of this :class:`Configuration`.
+
+        Returns
+        -------
+        :class:`Configuration`
+            An instance of :class:`Configuration`
+        """
         cls = type(self)
         return cls(self.values[:], self.types[:], self.joint_names[:])
 
@@ -168,8 +207,8 @@ def scale(self, scale_factor):
 
         Parameters
         ----------
-        scale_factor : float
-            Scale factor
+        scale_factor : :obj:`float`
+            Scale factor.
 
         Returns
         -------
@@ -185,13 +224,13 @@ def scale(self, scale_factor):
         self.values = values_scaled
 
     def scaled(self, scale_factor):
-        """Returns a scaled copy of this configuration.
+        """Return a scaled copy of this configuration.
 
         Only scalable joints are scaled, i.e. planar and prismatic joints.
 
         Parameters
         ----------
-        scale_factor : float
+        scale_factor : :obj:`float`
             Scale factor
 
         Returns