Table of Contents


snapmask - mask out certain particles while copying particles from an N-body system


snapmask in=snap_in out=snap_out [parameters=values...]


snapmask copies all particles from an N-body system for which a select keyword is given

The Key field (an integer) in the input file (if present) is also copied accordingly; when it is not present it will be initialized to the order of particles present in the input file, 0 being the first one, and nbody-1 the last one.


The following parameters are reckognized in any order if the keyword is also given:
Input data is read from snap_in, which must be in standard snapshot(5NEMO) format [no default].
Copied output data is written to snap_out, which will also be in snapshot(5NEMO) format. If output file exists, program refuses to overwrite it and dies. [No default]
List of numbers of all particles to be copied. This list is currently purely by position in the file, and the maximum should never be larger than the maximum number of bodies in any of the snapshots to be copied. The keyword keyoffset (see below) can be used to correct to keyvalues to be output. Example: "0:1000:10,2000:3000:10". [default:all].
Filename which is assumed to have a key field used to mask the particles to be copied. [default: not used].
Offset applied to the output key. This offset is a temporary hack until more programs make use of the key field. The offset is applied before it is compared with the key field in the above mentioned keyfile. E.g. An input file snap-in with 10 bodies is compared with a keyfile snap-key with 5 bodies numbered 5:9 and ... - Don’t use this option, still under development.


The select= keyword can easily become very long, longer than an interactive shell allows. You might see a "word too long" error message in this case. One solution is to write the numbers into a simple table and use the construct
    snapmask in=... out=...
where is an ASCII file with a single column of all selected particles.


Peter Teuben

See Also

snapsort(1NEMO) , snaptrim(1NEMO)


~pjt/nbody        snapmask.c snapmask.1

Update History

19-Jun-87    Version 1.0: created                    PJT
9-Mar-88    V1.2: added data-history mechanism    PJT
xx-jun-88    V1.3 new filestruct                   PJT
18-aug-88    V1.4 allow different sized snapshots     PJT
25-oct-88    V1.5 keyfile + keyoffset introduced      PJT
6-apr-89    V1.6: skip diagnostics            PJT
12-apr-89    V1.6a: different parser for ’select’     PJT

Table of Contents