Bd2dat - convert and combine branch data.

Bd2dat converts branch data data into a plain text format and supports splitting the data into stable and unstable parts as well as extraction of special points. The output format follows gnuplot's `plot data-file' convention and the splitting of files allows stability plots as well as marking special points.

Usage

bd2dat [-h$\mathrm \vert$-a] [-bl n] (run$\mathrm \vert$pfile$\mathrm \vert$-) [ofile1 [ofile2]] [(-sptype spfile) ...]

Switches

	-h		:		Display a usage message and exit with nonzero return value.
	-a		:		Append data to output files, do not overwrite.

Arguments

	run		:		Read branch data of run with qualified run name run.
	pfile		:		Read branch data from p.*-file pfile.
	-		:		Read branch data from standard input.
	ofile1		:		Write or append stable part or all to file ofile1.
	ofile2		:		Write or append unstable part to file ofile2.
	sptype		:		LP $\mathrm \vert$ BP $\mathrm \vert$ HB $\mathrm \vert$ PD $\mathrm \vert$ TR $\mathrm \vert$ UZ $\mathrm \vert$ RO $\mathrm \vert$ MX
	spfile		:		Write or append special points of selected type to file spfile.

Options

-bl n

:

# of Blank lines to separate branches, 1=mesh data, 2=individual.

Detailed description

Bd2dat converts, combines and splits branch data from AUTO output format into a plain ASCII format that can be used as input to gnuplot's `plot data-file' commands. It either reads the data from the run with qualified run name run, from an explicitly specified file pfile, or, from standard input if `-' was given. The last variant is used when filtering branch data with filterbd; see the description of filterbd below. The data of the branch is written or appended to file ofile1, depending on whether bd2dat was invoked with the switch -a or not. If both, ofile1 and ofile2 are present, then bd2dat performs a stability splitting, that is, the stable parts of a branch are written or appended to ofile1 and the unstable parts to ofile2. If no output file is given, then no output of branch data is produced. If an option of the type -sptype spfile was specified, bd2dat extracts a list of special points of type sptype to file spfile.

Bd2dat splits the branch data of a single run into records. A record represents a connected component of a single branch, in the simplest case it is the entire branch (stability splitting off). These records can be combined in files (switch -a) to make plotting easier and will be separated by a number of blank lines as specified with the option -bl, default is 2, that is, gnuplot will interpret each record as an individual curve. The same applies to the special points files, where a record is a complete list of special points of a particular type along the branch, however, stability splitting is never performed for records of special points.

In the case that you want to plot a surface made up from several branches, make sure that each record has the same number of points and use -bl 1, gnuplot will then interpret the resulting output as mesh data. For example, if you switch detection of special points off, then the branch data will contain exactly NMX points, if the run did not terminate prematurely with MX. Several runs with the same value for NMX might then be combined for a surface plot.

Return values

Bd2dat returns 0 on success and 1 if an error occurred or the -h switch was given.