Backport fixes from PR #128. [ci skip]

demo/interactive_md.ipynb

@@ -336,14 +336,14 @@
    "outputs": [],
    "source": [
     "# Search the system for a residue named ALA. Since there is a single match, we take the first result.\n",
-    "residue = system.search(\"resname ALA\")[0]\n",
+    "atoms = system.search(\"resname ALA\")\n",
     "\n",
     "# Get the indices of the atoms in the molecule, relative to the original system.\n",
-    "indices = [system.getIndex(x) for x in residue.getAtoms()]\n",
+    "indices = [system.getIndex(atom) for atom in atoms]\n",
     "\n",
     "# Compute the RMSD for each frame and plot the result.\n",
     "BSS.Notebook.plot(\n",
-    "    y=process.getTrajectory().rmsd(frame=0, atoms=indices),\n",
+    "    y=process.getTrajectory(backend=\"mdtraj\").rmsd(frame=0, atoms=indices),\n",
     "    xlabel=\"Frame\",\n",
     "    ylabel=\"RMSD\",\n",
     ")"
@@ -352,7 +352,7 @@
  ],
  "metadata": {
   "kernelspec": {
-   "display_name": "Python 3",
+   "display_name": "Python 3 (ipykernel)",
    "language": "python",
    "name": "python3"
   },
@@ -366,7 +366,7 @@
    "name": "python",
    "nbconvert_exporter": "python",
    "pygments_lexer": "ipython3",
-   "version": "3.7.3"
+   "version": "3.10.11"
   }
  },
  "nbformat": 4,

python/BioSimSpace/Process/_amber.py

@@ -461,13 +461,18 @@ def getCurrentSystem(self):
         """
         return self.getSystem(block=False)
 
-    def getTrajectory(self, block="AUTO"):
+    def getTrajectory(self, backend="AUTO", block="AUTO"):
         """
         Return a trajectory object.
 
         Parameters
         ----------
 
+        backend : str
+            The backend to use for trajectory parsing. To see supported backends,
+            run BioSimSpace.Trajectory.backends(). Using "AUTO" will try each in
+            sequence.
+
         block : bool
             Whether to block until the process has finished running.
 
@@ -478,6 +483,12 @@ def getTrajectory(self, block="AUTO"):
             The latest trajectory object.
         """
 
+        if not isinstance(backend, str):
+            raise TypeError("'backend' must be of type 'str'")
+
+        if not isinstance(block, (bool, str)):
+            raise TypeError("'block' must be of type 'bool' or 'str'")
+
         # Wait for the process to finish.
         if block is True:
             self.wait()
@@ -489,7 +500,7 @@ def getTrajectory(self, block="AUTO"):
             _warnings.warn("The process exited with an error!")
 
         try:
-            return _Trajectory.Trajectory(process=self)
+            return _Trajectory.Trajectory(process=self, backend=backend)
 
         except:
             return None

python/BioSimSpace/Process/_gromacs.py

@@ -659,13 +659,18 @@ def getCurrentSystem(self):
         """
         return self.getSystem(block=False)
 
-    def getTrajectory(self, block="AUTO"):
+    def getTrajectory(self, backend="AUTO", block="AUTO"):
         """
         Return a trajectory object.
 
         Parameters
         ----------
 
+        backend : str
+            The backend to use for trajectory parsing. To see supported backends,
+            run BioSimSpace.Trajectory.backends(). Using "AUTO" will try each in
+            sequence.
+
         block : bool
             Whether to block until the process has finished running.
 
@@ -676,6 +681,12 @@ def getTrajectory(self, block="AUTO"):
             The latest trajectory object.
         """
 
+        if not isinstance(backend, str):
+            raise TypeError("'backend' must be of type 'str'")
+
+        if not isinstance(block, (bool, str)):
+            raise TypeError("'block' must be of type 'bool' or 'str'")
+
         # Wait for the process to finish.
         if block is True:
             self.wait()
@@ -695,7 +706,7 @@ def getTrajectory(self, block="AUTO"):
             else:
                 self._traj_file = traj_file
 
-            return _Trajectory.Trajectory(process=self)
+            return _Trajectory.Trajectory(process=self, backend=backend)
 
         except:
             return None

python/BioSimSpace/Process/_namd.py

@@ -813,13 +813,18 @@ def getCurrentSystem(self):
         """
         return self.getSystem(block=False)
 
-    def getTrajectory(self, block="AUTO"):
+    def getTrajectory(self, backend="AUTO", block="AUTO"):
         """
         Return a trajectory object.
 
         Parameters
         ----------
 
+        backend : str
+            The backend to use for trajectory parsing. To see supported backends,
+            run BioSimSpace.Trajectory.backends(). Using "AUTO" will try each in
+            sequence.
+
         block : bool
             Whether to block until the process has finished running.
 
@@ -829,6 +834,13 @@ def getTrajectory(self, block="AUTO"):
         trajectory : :class:`Trajectory <BioSimSpace.Trajectory>`
             The latest trajectory object.
         """
+
+        if not isinstance(backend, str):
+            raise TypeError("'backend' must be of type 'str'")
+
+        if not isinstance(block, (bool, str)):
+            raise TypeError("'block' must be of type 'bool' or 'str'")
+
         # Wait for the process to finish.
         if block is True:
             self.wait()
@@ -840,7 +852,7 @@ def getTrajectory(self, block="AUTO"):
             _warnings.warn("The process exited with an error!")
 
         try:
-            return _Trajectory.Trajectory(process=self)
+            return _Trajectory.Trajectory(process=self, backend=backend)
 
         except:
             return None

python/BioSimSpace/Process/_openmm.py

@@ -1109,7 +1109,7 @@ def _generate_config(self):
 
             # Create a dummy PLUMED input file so that we can bind PLUMED
             # analysis functions to this process.
-            self._plumed = _Plumed(self._work_dir)
+            self._plumed = _Plumed(str(self._work_dir))
             plumed_config, auxillary_files = self._plumed.createConfig(
                 self._system, self._protocol, self._property_map
             )
@@ -1350,13 +1350,18 @@ def getCurrentSystem(self):
         """
         return self.getSystem(block=False)
 
-    def getTrajectory(self, block="AUTO"):
+    def getTrajectory(self, backend="AUTO", block="AUTO"):
         """
         Return a trajectory object.
 
         Parameters
         ----------
 
+        backend : str
+            The backend to use for trajectory parsing. To see supported backends,
+            run BioSimSpace.Trajectory.backends(). Using "AUTO" will try each in
+            sequence.
+
         block : bool
             Whether to block until the process has finished running.
 
@@ -1367,6 +1372,12 @@ def getTrajectory(self, block="AUTO"):
             The latest trajectory object.
         """
 
+        if not isinstance(backend, str):
+            raise TypeError("'backend' must be of type 'str'")
+
+        if not isinstance(block, (bool, str)):
+            raise TypeError("'block' must be of type 'bool' or 'str'")
+
         # Wait for the process to finish.
         if block is True:
             self.wait()
@@ -1380,7 +1391,7 @@ def getTrajectory(self, block="AUTO"):
         if not _os.path.isfile(self._traj_file):
             return None
         else:
-            return _Trajectory.Trajectory(process=self)
+            return _Trajectory.Trajectory(process=self, backend=backend)
 
     def getFrame(self, index):
         """

python/BioSimSpace/Process/_plumed.py

@@ -106,6 +106,10 @@ def __init__(self, work_dir):
                     "PLUMED version >= 2.5 is required."
                 )
 
+            # Store the major and minor versions.
+            self._plumed_major = major
+            self._plumed_minor = minor
+
         else:
             raise _Exceptions.IncompatibleError("Could not determine PLUMED version!")
 
@@ -377,7 +381,9 @@ def _createMetadynamicsConfig(self, system, protocol, property_map={}):
 
                 # The funnel collective variable requires an auxiliary file for
                 # PLUMED versions < 2.7.
-                if self._plumed_version < 2.7:
+                if self._plumed_major < 2 or (
+                    self._plumed_major < 3 and self._plumed_minor < 7
+                ):
                     aux_file = "ProjectionOnAxis.cpp"
                     self._config.append(f"LOAD FILE={aux_file}")
                     aux_file = (

python/BioSimSpace/Process/_somd.py

@@ -585,13 +585,18 @@ def getCurrentSystem(self):
         """
         return self.getSystem(block=False)
 
-    def getTrajectory(self, block="AUTO"):
+    def getTrajectory(self, backend="AUTO", block="AUTO"):
         """
         Return a trajectory object.
 
         Parameters
         ----------
 
+        backend : str
+            The backend to use for trajectory parsing. To see supported backends,
+            run BioSimSpace.Trajectory.backends(). Using "AUTO" will try each in
+            sequence.
+
         block : bool
             Whether to block until the process has finished running.
 
@@ -602,6 +607,12 @@ def getTrajectory(self, block="AUTO"):
             The latest trajectory object.
         """
 
+        if not isinstance(backend, str):
+            raise TypeError("'backend' must be of type 'str'")
+
+        if not isinstance(block, (bool, str)):
+            raise TypeError("'block' must be of type 'bool' or 'str'")
+
         # Wait for the process to finish.
         if block is True:
             self.wait()
@@ -613,7 +624,7 @@ def getTrajectory(self, block="AUTO"):
             _warnings.warn("The process exited with an error!")
 
         try:
-            return _Trajectory.Trajectory(process=self)
+            return _Trajectory.Trajectory(process=self, backend=backend)
 
         except:
             return None

python/BioSimSpace/Sandpit/Exscientia/Process/_amber.py

@@ -708,13 +708,18 @@ def getCurrentSystem(self):
         """
         return self.getSystem(block=False)
 
-    def getTrajectory(self, block="AUTO"):
+    def getTrajectory(self, backend="AUTO", block="AUTO"):
         """
         Return a trajectory object.
 
         Parameters
         ----------
 
+        backend : str
+            The backend to use for trajectory parsing. To see supported backends,
+            run BioSimSpace.Trajectory.backends(). Using "AUTO" will try each in
+            sequence.
+
         block : bool
             Whether to block until the process has finished running.
 
@@ -725,6 +730,12 @@ def getTrajectory(self, block="AUTO"):
             The latest trajectory object.
         """
 
+        if not isinstance(backend, str):
+            raise TypeError("'backend' must be of type 'str'")
+
+        if not isinstance(block, (bool, str)):
+            raise TypeError("'block' must be of type 'bool' or 'str'")
+
         # Wait for the process to finish.
         if block is True:
             self.wait()
@@ -736,7 +747,7 @@ def getTrajectory(self, block="AUTO"):
             _warnings.warn("The process exited with an error!")
 
         try:
-            return _Trajectory.Trajectory(process=self)
+            return _Trajectory.Trajectory(process=self, backend=backend)
 
         except:
             return None

python/BioSimSpace/Sandpit/Exscientia/Process/_gromacs.py

@@ -704,13 +704,18 @@ def getCurrentSystem(self):
         """
         return self.getSystem(block=False)
 
-    def getTrajectory(self, block="AUTO"):
+    def getTrajectory(self, backend="AUTO", block="AUTO"):
         """
         Return a trajectory object.
 
         Parameters
         ----------
 
+        backend : str
+            The backend to use for trajectory parsing. To see supported backends,
+            run BioSimSpace.Trajectory.backends(). Using "AUTO" will try each in
+            sequence.
+
         block : bool
             Whether to block until the process has finished running.
 
@@ -721,6 +726,12 @@ def getTrajectory(self, block="AUTO"):
             The latest trajectory object.
         """
 
+        if not isinstance(backend, str):
+            raise TypeError("'backend' must be of type 'str'")
+
+        if not isinstance(block, (bool, str)):
+            raise TypeError("'block' must be of type 'bool' or 'str'")
+
         # Wait for the process to finish.
         if block is True:
             self.wait()
@@ -740,7 +751,7 @@ def getTrajectory(self, block="AUTO"):
             else:
                 self._traj_file = traj_file
 
-            return _Trajectory.Trajectory(process=self)
+            return _Trajectory.Trajectory(process=self, backend=backend)
 
         except:
             return None