Fam2dat - convert and combine families of solutions.

Fam2dat converts the data of families of solutions into a plain text format. The output format follows gnuplot's `plot data-file' convention.

Usage

fam2dat [-h$\mathrm \vert$-a] [options ...] source [ofile1 [ofile2]] [(-sptype spfile) ...]

	options		:		(-bl n) $\mathrm \vert$ (-p col)
	source		:		run $\mathrm \vert$ (pfile$\mathrm \vert$-  qrun$\mathrm \vert$qfile)

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.
	qrun		:		Read solutions from run with qualified run name qrun.
	qfile		:		Read solutions from q.*-file qfile.
	ofile1		:		Write or append stable solutions or all to file ofile1.
	ofile2		:		Write or append unstable solutions 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 solutions at special points to file spfile.

Options

	-bl n		:		# of Blank lines to separate solutions, 1=mesh data, 2=individual.
	-p col		:		Prepend solution data with values from column col of the branch
					data, column PAR is col=1.

Detailed description

Fam2dat is the counterpart of bd2dat for solutions and we focus here on the differences between these two tools; see also the description of bd2dat. Fam2dat converts, combines and splits families of solutions from AUTO output format into a plain ASCII format that can be used as input to gnuplot's `plot data-file' commands. In order to do so fam2dat requires two input files, one file with the branch data and one with the solutions of the same run. In the simplest case only the qualified run name run is specified and fam2dat uses the files of that run. If you want to use a different source of branch data, for example, the output of filterbd, then you must also specify a source of the solution data, either a qualified run name qrun, or, a q.*-file name qfile.

Fam2dat allows to include an arbitrary number of values of selected columns from the branch data into the solution data. This enables the plotting of families of solutions versus the continuation parameter. For example, a call like

fam2dat -p 1 ...

will include the continuation parameter in the solutions, that is, the output will have the columns PAR T U(1) ... U(NDIM).

Return values

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