molsysmt.build.is_solvated#

molsysmt.build.is_solvated(molecular_system, skip_digestion=False)[source]#

Check whether a molecular system is solvated with an explicit solvent box.

A molecular system is considered solvated when it contains water molecules and has a periodic box, with a water number density above a physically meaningful threshold (> 15 molecules per nm³, consistent with liquid water at ambient conditions).

Parameters:
  • molecular_system (molecular system) – Molecular system in any of the supported forms.

  • skip_digestion (bool, default False) – If True, argument digestion is skipped (intended for internal use).

Returns:

True if the system contains water molecules inside a periodic box with a water number density greater than 15 molecules/nm³, False otherwise.

Return type:

bool

Notes

The number density threshold of 15 molecules/nm³ is well below the density of liquid water (approximately 33 molecules/nm³ at 300 K) but above values typical of gas-phase or vacuum simulations, making it a reliable discriminator for explicit solvation.

Added in version 1.0.0.