molsysmt.third_party.openmm.forces.add_plane_harmonic_restraint#

molsysmt.third_party.openmm.forces.add_plane_harmonic_restraint(molecular_system=None, selection='all', force_constant='5000 kilojoules/(mol*nanometers**2)', point=None, normal_vector=(0, 0, 1), pbc=False, return_force=False, syntax='MolSysMT', skip_digestion=False)[source]#

Adding a harmonic restraint pulling particles toward a reference geometric plane in OpenMM.

Parameters:

  • molecular_system (molecular system, default=None) – Molecular system in any supported MolSysMT format.

  • selection (str, list, tuple, or numpy.ndarray, default='all') – Selection string or boolean/integer array specifying elements.

  • force_constant (object, default='5000 kilojoules/(mol*nanometers**2)') – Argument force_constant.

  • point (object, default=None) – Argument point.

  • normal_vector (object, default=(0, 0, 1)) – Argument normal_vector.

  • pbc (bool, default=False) – Whether to take periodic boundary conditions into account.

  • return_force (object, default=False) – Argument return_force.

  • syntax (str, default='MolSysMT') – Selection syntax used to evaluate selection (e.g., ‘MolSysMT’, ‘MDTraj’).

  • skip_digestion (bool, default=False) – Whether to skip MolSysMT’s internal argument digestion mechanism.

Returns:

The added plane restraint force instance.

Return type:

openmm.CustomExternalForce

Added in version 1.0.0.