rasdump

This utility accepts a QSCAN RAS file and an optional channel definition file. For each channel listed in the latter, a dump is produced of the corresponding channel in the RAS file. Various options are provided for customizing the output including percentile limiting, and output format.

Synopsis

$ rasdump [options] data-file [channels-file]

Description

Dump channel data from data-file. The optional channel-file defines the indices and names of the channels to dump. If the channel-file is omitted all channels are extracted and channels in RAS files will be unnamed.

--version

show program’s version number and exit

-h, --help

show this help message and exit

-q, --quiet

produce less console output

-v, --verbose

produce more console output

-l LOGFILE, --log-file=LOGFILE

log messages to the specified file

-P, --pdb

run under PDB (debug mode)

--help-formats

list the available file output formats

-p PERCENTILE, --percentile=PERCENTILE

clip values in the output image to the specified low-high percentile range (mutually exclusive with -r)

-r RANGE, --range=RANGE

clip values in the output image to the specified low-high count range (mutually exclusive with -p)

-C CROP, --crop=CROP

crop the input data by left,top,right,bottom points

-e, --empty

if specified, include empty channels in the output (by default empty channels are ignored)

-o OUTPUT, --output=OUTPUT

specify the template used to generate the output filenames; supports {variables}, see –help-formats for supported file formats. Default: {filename_root}_{channel:02d}_{channel_name}.csv

-m, --multi

if specified, produce a single output file with multiple pages or sheets, one per channel (only available with certain formats)

Examples

Basic Usage

The most basic usage of rasdump is to specify only the RAS file from which to dump data. This will dump data in the default CSV format, one file per channel with no cropping and no percentile limiting. All channels (except empty ones) will be extracted, and will be anonymous (since no channels file has been specified to name them):

$ rasdump JAN12_CHINAFISH_LZ_003.RAS
Writing channel 0 () to JAN12_CHINAFISH_LZ_00_.csv
Channel 0 () is empty, skipping
Writing channel 1 () to JAN12_CHINAFISH_LZ_01_.csv
Writing channel 2 () to JAN12_CHINAFISH_LZ_02_.csv
Writing channel 3 () to JAN12_CHINAFISH_LZ_03_.csv
Writing channel 4 () to JAN12_CHINAFISH_LZ_04_.csv
Writing channel 5 () to JAN12_CHINAFISH_LZ_05_.csv
Writing channel 6 () to JAN12_CHINAFISH_LZ_06_.csv
Writing channel 7 () to JAN12_CHINAFISH_LZ_07_.csv
Writing channel 8 () to JAN12_CHINAFISH_LZ_08_.csv
Writing channel 9 () to JAN12_CHINAFISH_LZ_09_.csv
Writing channel 10 () to JAN12_CHINAFISH_LZ_10_.csv
Writing channel 11 () to JAN12_CHINAFISH_LZ_11_.csv
Writing channel 12 () to JAN12_CHINAFISH_LZ_12_.csv
Writing channel 13 () to JAN12_CHINAFISH_LZ_13_.csv
Writing channel 14 () to JAN12_CHINAFISH_LZ_14_.csv
Writing channel 15 () to JAN12_CHINAFISH_LZ_15_.csv

Help Lists

XXX To be written

Substitution Templates

XXX To be written

Advanced Usage

XXX To be written