bs2asc(1)

NAME
bs2asc - BS to ASCII conversion program

SYNOPSIS
bs2asc [ -f filename ] [ -h | -d ] [ -nip ] [ -nsns ] [ -nb ] [ -nbd ] [ -nbf ] [ -nabi ] [ -ns ] [ -nsd ] [ -nsf ] [ -i ] [ -pco ] [ -jt | -ct ] [ -s skip ] [ -c count ] [ -H ] -sm shmcid | <bsfile >ASCIIfile

DESCRIPTION

bs2asc converts the information contained within a BS dataset in bsfile(4) format from binary XDR format to a human-readable ASCII format.

OPTIONS

-f filename
    Write the ASCII output to the named file instead of the default stdout.

-h  Convert and output the file header and ping headers only. (The file header will not be output if the -sm option has been specified.)

-d  Convert and output the ping data only.

-nip
    Limit the conversion and output of pings whose PNG_HIDE or PNG_LOWQUALITY flag is set by just outputting the ping number, flag value and timestamp.

-nsns
    Do not output sensor (i.e., compass, depth, pitch and roll) data.

-nb Do not output bathymetry data.

-nbd
    Do not output bathymetry data which have been flagged for deletion.

-nbf
    Do not output bathymetry flags.

-nabi
    Do not output auxiliary beam information.

-ns Do not output sidescan data.

-nsd
    Do not output sidescan data which have been flagged for deletion.

-nsf
    Do not output sidescan flags.

-i  Ignore the ping count contained in the file header. This value is normally used as an upper bound on the number of pings to be converted to ASCII, and is also used to check the validity of any skip and/or count values passed to the program via the -s and/or -c options. It may be useful to ignore this count in situations where it is known to be incorrect (such as a file that has been only partially written by another program which has not yet updated the header count). This option may not be used in conjunction with the -sm option.

-pco
    Output the ping count only and immediately exit. Default program behavior displays considerably more information. Note that the program makes no attempt to verify that the input actually contains the number of pings claimed by its file header.

-jt Use the default julian format for the display of time values.

-ct Use calendar (i.e., month and day) format for the display of time values. The default format is julian.

-s skip
    Skip the specified number of pings at the beginning of the dataset before converting any subsequent pings. The default value is 0.

-c count
    Apply the conversion operation only to the specified number of pings. The default value is the total number of pings in the dataset minus the number of initial pings to be skipped as specified by the -s option, if any.

-H  Display help information.

-sm shmcid
    Run the program in shared memory mode using the shared memory control block shmcid. The default mode of operation is to read a BS input file from stdin. The -sm option should be used only when the program is invoked by specialized controlling software such as ssp(1) which is capable of implementing the required shared memory protocol.

SEE ALSO
ssp(1), bsfile(4)

AUTHOR
Originally written as mr2asc to support mr1file(4) format by Roger Davis, September 1991. Enhanced to support new bsfile(4) format in July, 2005.