artsintfmagg(l)

NAME
artsintfmagg - utility to aggregate interface matrix objects in time domain

SYNOPSIS
artsintfmagg [-v] [-i ifIndexList] [-I ifIndexList]
             [-h hours] [-o] [-q] outfile infile(s)

DESCRIPTION
artsintfmagg is a utility that reads interface matrix objects from ARTS files (infile(s)) and aggregates them in the time domain, placing the resulting interface matrix object(s) into an output file (outfile). For example, you may use artsintfmagg to aggregate 5-minute interface matrix data to 1-hour interface matrix data.

OPTIONS

-v  The -v option causes artsintfmagg to print version information and exit immediately.

-i ifIndexList
    The -i ifIndexList option may be used to select only data which contains an interface index attribute in ifIndexList. In other words, the -i ifIndexList option lets you select data from particular interfaces or sets of interfaces. ifIndexList may contain hyphens (indicating an inclusive range) and commas. For example, -i 1,2,5-8 would select data with an interface index attribute of 1, 2, 5, 6, 7 or 8.

-I ifIndexList
    The -I ifIndexList option may be used to combine data which contains an interface index attribute in ifIndexList. In other words, the -I ifIndexList option lets you aggregate data across a set of interfaces. ifIndexList may contain hyphens (indicating an inclusive range) and commas. For example, -I 1,2,5-8 would aggregate all data data with an interface index attribute of 1, 2, 5, 6, 7 or 8. The resulting aggregate objects will contain an interface index attribute of 0.

-h hours
    The -h hours option may be used to specify the period of aggregation, in hours. The hours argument accepts a decimal value to permit aggregation by fractional hour values. When the -h hours option is not used, artsintfmagg will write a single interface matrix object for the entire time interval seen in infile(s) to outfile.

-o  By default, artsintfmagg appends to the output file, so you may accumlate aggregate interface matrix objects in a single file over multiple invocations of artsintfmagg. You may override this behavior with the -o option. This will cause artsintfmagg to overwrite the output file instead of appending to it.

-q  By default, artsintfmagg prints a '.' for each interface matrix object it reads and prints a '+' for each object it writes. You may suppress this behavior using the -q (quiet) option.

EXAMPLES

artsintfmagg -h 1.0 /tmp/intfmagg1hr.19980821 arts.19980821

NOTES

SEE ALSO
artsagg(l), artsintfms(l), artsintfmagg(l), artsnexthops(l), artsnexthopagg(l), artsases(l), artsasagg(l), artsnets(l), artsnetagg(l), artsportmagg(l), artsportms(l), artsports(l), artsprotoagg(l), artsprotos(l), artstos(l), artstoc(l), artsdump(l)

ACKNOWLEDGEMENTS
artsintfmagg and documentation written by Daniel W. McRobb
CAIDA, August 1998