Gmx Check — GROMACS 2022.2 Documentation

Contents Menu Expand Light mode Dark mode Auto light/dark, in light mode Auto light/dark, in dark mode Hide navigation sidebar Hide table of contents sidebar Skip to content Logo
  • Downloads
  • Release notesToggle navigation of Release notes
    • GROMACS 2026.1 release notes
    • Highlights
    • New and improved features
    • Performance improvements
    • Changes to the API
    • Improvements to GROMACS tools
    • Bugs fixed
    • Deprecated functionality
    • Removed functionality
    • Portability
    • Miscellaneous
    • GROMACS 2025.5 release notes
    • GROMACS 2025.4 release notes
    • GROMACS 2025.3 release notes
    • GROMACS 2025.2 release notes
    • GROMACS 2025.1 release notes
    • Highlights
    • New and improved features
    • Performance improvements
    • Changes to the API
    • Improvements to GROMACS tools
    • Bugs fixed
    • Deprecated functionality
    • Removed functionality
    • Portability
    • Miscellaneous
    • GROMACS 2024.7 release notes
    • GROMACS 2024.6 release notes
    • GROMACS 2024.5 release notes
    • GROMACS 2024.4 release notes
    • GROMACS 2024.3 release notes
    • GROMACS 2024.2 release notes
    • GROMACS 2024.1 release notes
    • Highlights
    • New and improved features
    • Performance improvements
    • Changes to the API
    • Improvements to GROMACS tools
    • Bugs fixed
    • Deprecated functionality
    • Removed functionality
    • Portability
    • Miscellaneous
    • GROMACS 2023.5 release notes
    • GROMACS 2023.4 release notes
    • GROMACS 2023.3 release notes
    • GROMACS 2023.2 release notes
    • GROMACS 2023.1 release notes
    • Highlights
    • New and improved features
    • Performance improvements
    • Changes to the API
    • Improvements to GROMACS tools
    • Bugs fixed
    • Deprecated functionality
    • Removed functionality
    • Portability
    • Miscellaneous
    • GROMACS 2022.6 release notes
    • GROMACS 2022.5 release notes
    • GROMACS 2022.4 release notes
    • GROMACS 2022.3 release notes
    • GROMACS 2022.2 release notes
    • GROMACS 2022.1 release notes
    • Highlights
    • New and improved features
    • Performance improvements
    • Changes to the API
    • Improvements to GROMACS tools
    • Bugs fixed
    • Deprecated functionality
    • Removed functionality
    • Portability
    • Miscellaneous
    • GROMACS 2021.7 release notes
    • GROMACS 2021.6 release notes
    • GROMACS 2021.5 release notes
    • GROMACS 2021.4 release notes
    • GROMACS 2021.3 release notes
    • GROMACS 2021.2 release notes
    • GROMACS 2021.1 release notes
    • Highlights
    • New and improved features
    • Performance improvements
    • Improvements to GROMACS tools
    • Bugs fixed
    • Deprecated functionality
    • Removed functionality
    • Portability
    • Miscellaneous
    • GROMACS 2020.7 release notes
    • GROMACS 2020.6 release notes
    • GROMACS 2020.5 release notes
    • GROMACS 2020.4 release notes
    • GROMACS 2020.3 release notes
    • GROMACS 2020.2 release notes
    • GROMACS 2020.1 release notes
    • Highlights
    • New and improved features
    • Performance improvements
    • Improvements to GROMACS tools
    • Bugs fixed
    • Deprecated functionality
    • Removed functionality
    • Portability
    • Miscellaneous
    • GROMACS 2019.6 release notes
    • GROMACS 2019.5 release notes
    • GROMACS 2019.4 release notes
    • GROMACS 2019.3 release notes
    • GROMACS 2019.2 release notes
    • GROMACS 2019.1 release notes
    • Highlights
    • New and improved features
    • Performance improvements
    • Improvements to GROMACS tools
    • Bugs fixed
    • Deprecated functionality
    • Removed functionality
    • Portability
    • Miscellaneous
    • GROMACS 2018.7 release notes
    • GROMACS 2018.6 release notes
    • GROMACS 2018.5 release notes
    • GROMACS 2018.4 release notes
    • GROMACS 2018.3 release notes
    • GROMACS 2018.2 release notes
    • GROMACS 2018.1 release notes
    • Highlights
    • New and improved features
    • Performance improvements
    • Improvements to GROMACS tools
    • Bugs fixed
    • Removed features
    • Portability
    • Miscellaneous
    • GROMACS 2016.5 Release Notes
    • GROMACS 2016.4 Release Notes
    • GROMACS 2016.3 Release Notes
    • GROMACS 2016.2 Release Notes
    • GROMACS 2016.1 Release Notes
    • Highlights
    • New and improved features
    • Performance improvements
    • GPU improvements
    • CPU improvements
    • Threading improvements
    • Other improvements
    • Improvements to GROMACS tools
    • Bugs fixed
    • Fixes for bugs introduced during development
    • Removed mdrun features
    • Miscellaneous
    • Release notes for older GROMACS versions
  • Installation guideToggle navigation of Installation guide
    • Installation guide for exotic configurations
  • User guideToggle navigation of User guide
    • Known issues affecting users of GROMACS
    • Getting startedToggle navigation of Getting started
      • Flow Chart
    • System preparationToggle navigation of System preparation
    • Managing long simulations
    • Answers to frequently asked questions (FAQs)Toggle navigation of Answers to frequently asked questions (FAQs)
    • Force fields in GROMACS
    • Molecular dynamics parameters (.mdp options)
    • Useful mdrun features
    • Getting good performance from mdrun
    • Common errors when using GROMACS
    • Command-line referenceToggle navigation of Command-line reference
      • molecular dynamics simulation suite
      • gmx anaeig
      • gmx analyze
      • gmx angle
      • gmx awh
      • gmx bar
      • gmx bundle
      • gmx check
      • gmx chi
      • gmx cluster
      • gmx clustsize
      • gmx confrms
      • gmx convert-tpr
      • gmx convert-trj
      • gmx covar
      • gmx current
      • gmx density
      • gmx densmap
      • gmx densorder
      • gmx dielectric
      • gmx dipoles
      • gmx disre
      • gmx distance
      • gmx dos
      • gmx dssp
      • gmx dump
      • gmx dyecoupl
      • gmx editconf
      • gmx eneconv
      • gmx enemat
      • gmx energy
      • gmx extract-cluster
      • gmx filter
      • gmx freevolume
      • gmx gangle
      • gmx genconf
      • gmx genion
      • gmx genrestr
      • gmx grompp
      • gmx gyrate
      • gmx gyrate-legacy
      • gmx h2order
      • gmx hbond
      • gmx hbond-legacy
      • gmx helix
      • gmx helixorient
      • gmx help
      • gmx hydorder
      • gmx insert-molecules
      • gmx lie
      • gmx make_edi
      • gmx make_ndx
      • gmx mdmat
      • gmx mdrun
      • gmx mindist
      • gmx mk_angndx
      • gmx msd
      • gmx nmeig
      • gmx nmens
      • gmx nmr
      • gmx nmtraj
      • gmx nonbonded-benchmark
      • gmx order
      • gmx pairdist
      • gmx pdb2gmx
      • gmx pme_error
      • gmx polystat
      • gmx potential
      • gmx principal
      • gmx rama
      • gmx rdf
      • gmx report-methods
      • gmx rms
      • gmx rmsdist
      • gmx rmsf
      • gmx rotacf
      • gmx rotmat
      • gmx saltbr
      • gmx sans-legacy
      • gmx sasa
      • gmx saxs-legacy
      • gmx scattering
      • gmx select
      • gmx sham
      • gmx sigeps
      • gmx solvate
      • gmx sorient
      • gmx spatial
      • gmx spol
      • gmx tcaf
      • gmx traj
      • gmx trajectory
      • gmx trjcat
      • gmx trjconv
      • gmx trjorder
      • gmx tune_pme
      • gmx vanhove
      • gmx velacc
      • gmx wham
      • gmx wheel
      • gmx x2top
      • gmx xpm2ps
      • Selection syntax and usage
    • Terminology
    • Validation
    • Environment Variables
    • Floating point arithmetic
    • Security when using GROMACS
    • Policy for deprecating GROMACS functionality
  • Short How-To guidesToggle navigation of Short How-To guides
    • Beginners
    • Adding a Residue to a Force Field
    • Water solvation
    • Non water solvent
    • Mixed solvent
    • Making Disulfide Bonds
    • Running membrane simulations in GROMACS
    • Parameterization of novel molecules
    • Potential of Mean Force
    • Single-Point Energy
    • Carbon Nanotube
    • Visualization Software
    • Extracting Trajectory Information
    • External tools to perform trajectory analysis
    • Plotting Data
    • Micelle Clustering
  • Reference ManualToggle navigation of Reference Manual
    • Preface and Disclaimer
    • Introduction
    • Definitions and Units
    • AlgorithmsToggle navigation of Algorithms
      • Periodic boundary conditions
      • The group concept
      • Molecular Dynamics
      • Shell molecular dynamics
      • Constraint algorithms
      • Simulated Annealing
      • Stochastic Dynamics
      • Brownian Dynamics
      • Energy Minimization
      • Normal-Mode Analysis
      • Free energy calculations
      • Replica exchange
      • Essential Dynamics sampling
      • Expanded Ensemble
      • Parallelization
      • Domain decomposition
    • Interaction function and force fieldsToggle navigation of Interaction function and force fields
      • Non-bonded interactions
      • Bonded interactions
      • Restraints
      • Polarization
      • Free energy interactions
      • Methods
      • Virtual interaction sites
      • Long Range Electrostatics
      • Long Range Van der Waals interactions
      • Force field
    • TopologiesToggle navigation of Topologies
      • Particle type
      • Parameter files
      • Molecule definition
      • Constraint algorithms
      • pdb2gmx input files
      • File formats
      • Force field organization
    • File formats
    • Special TopicsToggle navigation of Special Topics
      • Free energy implementation
      • Potential of mean force
      • Non-equilibrium pulling
      • Collective variables: the pull code
      • Adaptive biasing with AWH
      • Enforced Rotation
      • Electric fields
      • Computational Electrophysiology
      • Calculating a PMF using the free-energy code
      • Removing fastest degrees of freedom
      • Viscosity calculation
      • Shear simulations
      • Tabulated interaction functions
      • Hybrid Quantum-Classical simulations (QM/MM) with CP2K interface
      • MiMiC Hybrid Quantum Mechanical/Molecular Mechanical simulations
      • Using VMD plug-ins for trajectory file I/O
      • Interactive Molecular Dynamics
      • Embedding proteins into the membranes
      • Applying forces from three-dimensional densities
      • Collective Variable simulations with the Colvars module
      • Using PLUMED
      • Neural Network Potentials
      • Fast Multipole Method (FMM)
    • Run parameters and Programs
    • AnalysisToggle navigation of Analysis
      • Using Groups
      • Looking at your trajectory
      • General properties
      • Radial distribution functions
      • Correlation functions
      • Curve fitting in GROMACS
      • Mean Square Displacement
      • Bonds/distances, angles and dihedrals
      • Radius of gyration and distances
      • Root mean square deviations in structure
      • Covariance analysis
      • Dihedral principal component analysis
      • Hydrogen bonds
      • Protein-related items
      • Interface-related items
    • Some implementation details
    • Averages and fluctuations
    • Bibliography
  • gmxapi Python packageToggle navigation of gmxapi Python package
    • Full installation instructions
    • Using the Python package
    • gmxapi Python module reference
  • (Non-)Bonded LIBrary (NB-LIB) APIToggle navigation of (Non-)Bonded LIBrary (NB-LIB) API
    • Guide to Writing MD Programs
  • C++ APIToggle navigation of C++ API
    • Public C++ API
  • Developer GuideToggle navigation of Developer Guide
    • Contribute to GROMACS
    • Codebase overview
    • Build system overview
    • Change Management
    • Relocatable binaries
    • Documentation generation
    • Style guidelinesToggle navigation of Style guidelines
      • Guidelines for code formatting
      • Guidelines for #include directives
      • Naming conventions
      • Allowed language features
      • Guidelines for creating meaningful issue reports
      • Guidelines for formatting of git commits
      • Error handling
    • Development-time toolsToggle navigation of Development-time tools
      • Using Doxygen
      • Change Management
      • Automation and InfrastructureToggle navigation of Automation and Infrastructure
        • GitLab CI Pipeline Execution
      • Source tree checker scripts
      • Automatic source code formatting
      • Unit testing
      • Physical validation
    • Known issues relevant for developers
  • Doxygen documentation
Back to top View this page Edit this page Toggle Light / Dark / Auto color theme Toggle table of contents sidebar gmx check¶

Synopsis¶

gmx check [-f [<.xtc/.trr/...>]] [-f2 [<.xtc/.trr/...>]] [-s1 [<.tpr>]] [-s2 [<.tpr>]] [-c [<.tpr/.gro/...>]] [-e [<.edr>]] [-e2 [<.edr>]] [-n [<.ndx>]] [-m [<.tex>]] [-vdwfac <real>] [-bonlo <real>] [-bonhi <real>] [-[no]rmsd] [-tol <real>] [-abstol <real>] [-[no]ab] [-lastener <string>]

Description¶

gmx check reads a trajectory (.tng, .trr or .xtc), an energy file (.edr) or an index file (.ndx) and prints out useful information about them.

Option -c checks for presence of coordinates, velocities and box in the file, for close contacts (smaller than -vdwfac and not bonded, i.e. not between -bonlo and -bonhi, all relative to the sum of both Van der Waals radii) and atoms outside the box (these may occur often and are no problem). If velocities are present, an estimated temperature will be calculated from them.

If an index file, is given its contents will be summarized.

If both a trajectory and a .tpr file are given (with -s1) the program will check whether the bond lengths defined in the tpr file are indeed correct in the trajectory. If not you may have non-matching files due to e.g. deshuffling or due to problems with virtual sites. With these flags, gmx check provides a quick check for such problems.

The program can compare two run input (.tpr) files when both -s1 and -s2 are supplied. When comparing run input files this way, the default relative tolerance is reduced to 0.000001 and the absolute tolerance set to zero to find any differences not due to minor compiler optimization differences, although you can of course still set any other tolerances through the options. Similarly a pair of trajectory files can be compared (using the -f2 option), or a pair of energy files (using the -e2 option).

For free energy simulations the A and B state topology from one run input file can be compared with options -s1 and -ab.

Options¶

Options to specify input files:

-f [<.xtc/.trr/…>] (traj.xtc) (Optional)

Trajectory: xtc trr cpt gro g96 pdb tng h5md

-f2 [<.xtc/.trr/…>] (traj.xtc) (Optional)

Trajectory: xtc trr cpt gro g96 pdb tng h5md

-s1 [<.tpr>] (top1.tpr) (Optional)

Portable xdr run input file

-s2 [<.tpr>] (top2.tpr) (Optional)

Portable xdr run input file

-c [<.tpr/.gro/…>] (topol.tpr) (Optional)

Structure+mass(db): tpr gro g96 pdb brk ent

-e [<.edr>] (ener.edr) (Optional)

Energy file

-e2 [<.edr>] (ener2.edr) (Optional)

Energy file

-n [<.ndx>] (index.ndx) (Optional)

Index file

Options to specify output files:

-m [<.tex>] (doc.tex) (Optional)

LaTeX file

Other options:

-vdwfac <real> (0.8)

Fraction of sum of VdW radii used as warning cutoff

-bonlo <real> (0.4)

Min. fract. of sum of VdW radii for bonded atoms

-bonhi <real> (0.7)

Max. fract. of sum of VdW radii for bonded atoms

-[no]rmsd (no)

Print RMSD for x, v and f

-tol <real> (0.001)

Relative tolerance for comparing real values defined as 2*(a-b)/(|a|+|b|)

-abstol <real> (0.001)

Absolute tolerance, useful when sums are close to zero.

-[no]ab (no)

Compare the A and B topology from one file

-lastener <string>

Last energy term to compare (if not given all are tested). It makes sense to go up until the Pressure.

On this page
  • gmx check
    • Synopsis
    • Description
    • Options

Từ khóa » Gmx Check