NAME

arcedit - edit input archive and append to output file

SYNOPSIS

arcedit [ options ] -input inarch -output outarch

DESCRIPTION

The input archive file inarch is opened and edited according to options and the result is appended to the output archive file outarch. If options are not specified, inarch is appended in its entirety and without change to outarch. If outarch does not exist a new archive files is created. The edited inarch must be compatible with outarch.

The command switches and option keywords can be abbreviated to the shortest unambiguous string. Only version 3 archives are supported. See arc about converting older version files.

options have the following values:

-nocoordinates: Only the velocities in inarch will be copied to outarch. If a record contains only velocities, that record will not be copied. If a record contains both velocities and coordinates only the coordinates will be copied.

-novelocities: Only the velocities in inarch will be copied to outarch. If a record contains only coordinates, that record will not be copied. If a record contains both velocities and coordinates only the velocities will be copied.

The two previous options cannot both be specified on a command line.

-verbose: display progress information.

-atoms S: selects only the atoms specified in the string S (see below).

-record S: selects only the records specified in the string S (see below).

S is a string containing numbers and punctuation characters with the following meanings: the number i by itself means to select atom i or record i; to select record or atom i and record or atom j specify 'i,j'. To select all records or atoms between i and j including i and j write S as 'i-j'.To specify every j-th record from i to k write S as 'i(j)k'. These selections can be combined, for example 'i,j-k,n,m,a(b)c', which means select records or atoms i, j to k including j and k, n, m, a, a+b, a+2b to c. Be sure to protect the punctuations from shell interpretation.

-atoms and -records may be specified more than once, each specified S is accumulated.

EXAMPLE

arcedit -out fileb -r '10-8' -i filea -rec '1,2(3)11'

Copy records 10, 9, 8, 1, 2, 5, 8 and 11, in the given order from the input archive filea into the output archive fileb. Note that record 8 is copied twice. The option strings are abbreviated.

FILES

SEE ALSO

The archive file format and arc.

DIAGNOSTICS

BUGS

NOTES