Man page - gmx-sham(1)
Packages contains this manual
- gmx-trjorder(1)
- gmx-wheel(1)
- gmx-genion(1)
- gmx-energy(1)
- gmx-rmsdist(1)
- gmx-sham(1)
- gmx-helixorient(1)
- gmx-select(1)
- gmx-nmeig(1)
- gmx-density(1)
- gmx-genrestr(1)
- gmx-bar(1)
- gmx-lie(1)
- gmx-filter(1)
- gmx-scattering(1)
- gmx-anaeig(1)
- gmx-covar(1)
- gmx_d(1)
- gmx-genconf(1)
- gmx-mdrun(1)
- gmx-velacc(1)
- gmx-tcaf(1)
- gmx-insert-molecules(1)
- gmx-bundle(1)
- gmx-hydorder(1)
- gmx-editconf(1)
- gmx-msd(1)
- gmx-confrms(1)
- gmx-cluster(1)
- gmx-saltbr(1)
- gmx-potential(1)
- gmx-current(1)
- gmx-freevolume(1)
- gmx-make_ndx(1)
- gmx-enemat(1)
- gmx(1)
- gmx-gyrate(1)
- gmx-solvate(1)
- gmx-densmap(1)
- gmx-rotacf(1)
- gmx-helix(1)
- gmx_mpi(1)
- gmx-convert-tpr(1)
- gmx-convert-trj(1)
- gmx-polystat(1)
- gmx-angle(1)
- gmx-xpm2ps(1)
- gmx-pdb2gmx(1)
- gmx-sasa(1)
- gmx-x2top(1)
- gmx-trjcat(1)
- gmx-h2order(1)
- gmx-nmr(1)
- gmx-dump(1)
- gmx-spol(1)
- gmx-distance(1)
- gmx-clustsize(1)
- gmx-rama(1)
- gmx-chi(1)
- gmx-pme_error(1)
- gmx-order(1)
- gmx-gangle(1)
- gmx-eneconv(1)
- gmx-tune_pme(1)
- gmx-grompp(1)
- gmx-make_edi(1)
- gmx-trajectory(1)
- gmx-dipoles(1)
- gmx-awh(1)
- gmx-nonbonded-benchmark(1)
- gmx-analyze(1)
- demux(1)
- gmx-disre(1)
- gmx-saxs-legacy(1)
- gmx-sigeps(1)
- gmx-mdmat(1)
- xplor2gmx(1)
- gmx-check(1)
- gmx-vanhove(1)
- gmx-dssp(1)
- gmx-densorder(1)
- gmx-principal(1)
- gmx-mindist(1)
- gmx-spatial(1)
- gmx-wham(1)
- gmx-rmsf(1)
- gmx-dos(1)
- gmx-mk_angndx(1)
- gmx-nmens(1)
- gmx-dielectric(1)
- gmx-sorient(1)
- gmx-help(1)
- gmx-hbond-legacy(1)
- gmx-sans-legacy(1)
- gmx-gyrate-legacy(1)
- gmx-hbond(1)
- gmx-rotmat(1)
- gmx-extract-cluster(1)
- gmx-rms(1)
- gmx-dyecoupl(1)
- gmx-rdf(1)
- gmx-pairdist(1)
- gmx-trjconv(1)
- gmx-traj(1)
- gmx_mpi_d(1)
- gmx-report-methods(1)
- gmx-nmtraj(1)
apt-get install gromacs-data
Manual
GMX-SHAM
NAMESYNOPSIS
DESCRIPTION
OPTIONS
SEE ALSO
COPYRIGHT
NAME
gmx-sham - Compute free energies or other histograms from histograms
SYNOPSIS
gmx sham
[
-f
[<.xvg>]
] [
-ge
[<.xvg>]
] [
-ene
[<.xvg>]
]
[
-dist
[<.xvg>]
]
[
-histo
[<.xvg>]
] [
-bin
[<.ndx>]
] [
-lp
[<.xpm>]
]
[
-ls
[<.xpm>]
] [
-lsh
[<.xpm>]
] [
-lss
[<.xpm>]
]
[
-ls3
[<.pdb>]
] [
-g
[<.log>]
] [
-[no]w
] [
-xvg
<enum>
]
[
-[no]time
] [
-b
<real>
]
[
-e
<real>
] [
-ttol
<real>
]
[
-n
<int>
] [
-[no]d
]
[
-[no]sham
] [
-tsham
<real>
]
[
-pmin
<real>
] [
-dim
<vector>
] [
-ngrid
<vector>
]
[
-xmin
<vector>
] [
-xmax
<vector>
] [
-pmax
<real>
]
[
-gmax
<real>
] [
-emin
<real>
] [
-emax
<real>
]
[
-nlevels
<int>
]
DESCRIPTION
gmx sham makes multi-dimensional free-energy, enthalpy and entropy plots. gmx sham reads one or more .xvg files and analyzes data sets. The basic purpose of gmx sham is to plot Gibbs free energy landscapes (option -ls ) by Bolzmann inverting multi-dimensional histograms (option -lp ), but it can also make enthalpy (option -lsh ) and entropy (option -lss ) plots. The histograms can be made for any quantities the user supplies. A line in the input file may start with a time (see option -time ) and any number of y -values may follow. Multiple sets can also be read when they are separated by & (option -n ), in this case only one y -value is read from each line. All lines starting with # and @ are skipped.
Option -ge can be used to supply a file with free energies when the ensemble is not a Boltzmann ensemble, but needs to be biased by this free energy. One free energy value is required for each (multi-dimensional) data point in the -f input.
Option -ene can be used to supply a file with energies. These energies are used as a weighting function in the single histogram analysis method by Kumar et al. When temperatures are supplied (as a second column in the file), an experimental weighting scheme is applied. In addition the vales are used for making enthalpy and entropy plots.
With option -dim , dimensions can be gives for distances. When a distance is 2- or 3-dimensional, the circumference or surface sampled by two particles increases with increasing distance. Depending on what one would like to show, one can choose to correct the histogram and free-energy for this volume effect. The probability is normalized by r and rĖ2 for dimensions of 2 and 3, respectively. A value of -1 is used to indicate an angle in degrees between two vectors: a sin(angle) normalization will be applied. Note that for angles between vectors the inner-product or cosine is the natural quantity to use, as it will produce bins of the same volume.
OPTIONS
Options to
specify input files:
-f [<.xvg>] (graph.xvg)
xvgr/xmgr file
-ge [<.xvg>] (gibbs.xvg) (Optional)
xvgr/xmgr file
-ene [<.xvg>] (esham.xvg) (Optional)
xvgr/xmgr file
Options to
specify output files:
-dist [<.xvg>] (ener.xvg) (Optional)
xvgr/xmgr file
-histo [<.xvg>] (edist.xvg) (Optional)
xvgr/xmgr file
-bin [<.ndx>] (bindex.ndx) (Optional)
Index file
-lp [<.xpm>] (prob.xpm) (Optional)
X PixMap compatible matrix file
-ls [<.xpm>] (gibbs.xpm) (Optional)
X PixMap compatible matrix file
-lsh [<.xpm>] (enthalpy.xpm) (Optional)
X PixMap compatible matrix file
-lss [<.xpm>] (entropy.xpm) (Optional)
X PixMap compatible matrix file
-ls3 [<.pdb>] (gibbs3.pdb) (Optional)
Protein data bank file
-g [<.log>] (shamlog.log) (Optional)
Log file
Other options:
-[no]w (no)
View output .xvg , .xpm , .eps and .pdb files
-xvg <enum> (xmgrace)
xvg plot formatting: xmgrace, xmgr, none
-[no]time (yes)
Expect a time in the input
-b <real> (-1)
First time to read from set
-e <real> (-1)
Last time to read from set
-ttol <real> (0)
Tolerance on time in appropriate units (usually ps)
-n <int> (1)
Read this number of sets separated by lines containing only an ampersand
-[no]d (no)
Use the derivative
-[no]sham (yes)
Turn off energy weighting even if energies are given
-tsham <real> (298.15)
Temperature for single histogram analysis
-pmin <real> (0)
Minimum probability. Anything lower than this will be set to zero
-dim <vector> (1 1 1)
Dimensions for distances, used for volume correction (max 3 values, dimensions > 3 will get the same value as the last)
-ngrid <vector> (32 32 32)
Number of bins for energy landscapes (max 3 values, dimensions > 3 will get the same value as the last)
-xmin <vector> (0 0 0)
Minimum for the axes in energy landscape (see above for > 3 dimensions)
-xmax <vector> (1 1 1)
Maximum for the axes in energy landscape (see above for > 3 dimensions)
-pmax <real> (0)
Maximum probability in output, default is calculate
-gmax <real> (0)
Maximum free energy in output, default is calculate
-emin <real> (0)
Minimum enthalpy in output, default is calculate
-emax <real> (0)
Maximum enthalpy in output, default is calculate
-nlevels <int> (25)
Number of levels for energy landscape
SEE ALSO
gmx(1)
More information about GROMACS is available at <- http://www.gromacs.org/ >.
COPYRIGHT
2025, GROMACS development team