.TH gmx-trjcat 1 "" "VERSION 5.0.2" "GROMACS Manual"
.SH NAME
gmx-trjcat \- Concatenate trajectory files

.SH SYNOPSIS
gmx trjcat [\-f [<.xtc/.trr/...> [...]]] [\-o [<.xtc/.trr/...> [...]]]
           [\-n [<.ndx>]] [\-demux [<.xvg>]] [\-nice <int>] [\-tu <enum>]
           [\-xvg <enum>] [\-b <time>] [\-e <time>] [\-dt <time>]
           [\-[no]vel] [\-[no]settime] [\-[no]sort] [\-[no]keeplast]
           [\-[no]overwrite] [\-[no]cat]

.SH DESCRIPTION
\fBgmx trjcat\fR concatenates several input trajectory files in sorted order. In case of double time frames the one in the later file is used. By specifying \fB\-settime\fR you will be asked for the start time of each file. The input files are taken from the command line, such that a command like \fBgmx trjcat \-f *.trr \-o fixed.trr\fR should do the trick. Using \fB\-cat\fR, you can simply paste several files together without removal of frames with identical time stamps.

One important option is inferred when the output file is amongst the input files. In that case that particular file will be appended to which implies you do not need to store double the amount of data. Obviously the file to append to has to be the one with lowest starting time since one can only append at the end of a file.

If the \fB\-demux\fR option is given, the N trajectories that are read, are written in another order as specified in the \fB.xvg\fR file. The \fB.xvg\fR file should contain something like:

\fB0  0  1  2  3  4  5
2  1  0  2  3  5  4\fR
Where the first number is the time, and subsequent numbers point to trajectory indices. The frames corresponding to the numbers present at the first line are collected into the output trajectory. If the number of frames in the trajectory does not match that in the \fB.xvg\fR file then the program tries to be smart. Beware.

.SH OPTIONS
Options to specify input and output files:

.BI "\-f" " [<.xtc/.trr/...> [...]] (traj.xtc) (Input)"
    Trajectory: xtc trr cpt trj gro g96 pdb tng

.BI "\-o" " [<.xtc/.trr/...> [...]] (trajout.xtc) (Output)"
    Trajectory: xtc trr trj gro g96 pdb tng

.BI "\-n" " [<.ndx>] (index.ndx) (Input, Optional)"
    Index file

.BI "\-demux" " [<.xvg>] (remd.xvg) (Input, Optional)"
    xvgr/xmgr file


Other options:

.BI "\-nice" " <int> (19)"
    Set the nicelevel

.BI "\-tu" " <enum> (ps)"
    Time unit: fs, ps, ns, us, ms, s

.BI "\-xvg" " <enum> (xmgrace)"
    xvg plot formatting: xmgrace, xmgr, none

.BI "\-b" " <time> (-1)"
    First time to use (ps)

.BI "\-e" " <time> (-1)"
    Last time to use (ps)

.BI "\-dt" " <time> (0)"
    Only write frame when t MOD dt = first time (ps)

.BI "\-[no]vel" "  (yes)"
    Read and write velocities if possible

.BI "\-[no]settime" "  (no)"
    Change starting time interactively

.BI "\-[no]sort" "  (yes)"
    Sort trajectory files (not frames)

.BI "\-[no]keeplast" "  (no)"
    Keep overlapping frames at end of trajectory

.BI "\-[no]overwrite" "  (no)"
    Overwrite overlapping frames during appending

.BI "\-[no]cat" "  (no)"
    Do not discard double time frames


.SH SEE ALSO
.BR gromacs(7)

More information about \fBGROMACS\fR is available at <\fIhttp://www.gromacs.org/\fR>.