Plotsol - plot solutions.

Plotsol plots solutions with gnuplot.

Usage

plotsol [-h$\mathrm \vert$-i] [options ...] [cols] [ranges] FPM$\mathrm \vert$SPM

	options		:		-bw $\mathrm \vert$ (-k name) $\mathrm \vert$ (-eps eps-name) $\mathrm \vert$ (-bl n)
	cols		:		x:y[:z]
	ranges		:		"xrange" ["yrange" ["zrange"]]
	$($x$\vert$y$\vert$z$)$range		:		[a:b]
	FPM		:		run $\mathrm \vert$ ( pfile$\mathrm \vert$-  qrun$\mathrm \vert$qfile )
	SPM		:		( qrun$\mathrm \vert$qfile$\mathrm \vert$- ) lab ...

Switches

	-h		:		Display a usage message and exit with nonzero return value.
	-i		:		Interactive, do not exit from gnuplot, but prompt for input.

Arguments

	run		:		Read branch data and solutions of run with qualified run name run.
	qrun		:		Read solutions of run with qualified run name qrun.
	pfile		:		Read branch data from p.*-file file.
	qfile		:		Read solutions from q.*-file file.
	-		:		Read branch data (FPM) or solutions (SPM) from standard input.
	lab		:		Plot solutions with labels lab ...

Options

	-bw		:		Plot black and white.
	-k name		:		Keep, save gnuplot file as name.gp and data files
					as name*.dat, * = s, u, LP, BP, HB, PD, TR, UZ, RO.
	-eps eps-name		:		Plot to eps-file eps-name.eps instead of screen.
	-bl n		:		# of Blank lines to separate solutions,
					1=mesh data, 2=individual.

Detailed description

Plotsol has two principal operation modes: a family plotting mode that is used if no solution labels are specified, and a solutions plotting mode that is used if solution labels are present on the command line.

In family plotting mode

plotsol is similar to MatCont's function plotcycle. It uses gnuplot to plot a family of solutions from the run with qualified run name run. Input data may also be specified by providing either two filenames or a file name and a run name. The first file must be a p.*-file containing branch data and may be set to standard input using `-' as file name. The second file must be a q.*-file containing solution data. A stability splitting using fam2dat is performed and the continuation parameter is included in the data as column 0. By default a plot of column 3 versus column 2, that is, U(2) versus U(1) is shown. The selection of columns and plotting ranges follows gnuplot's syntax, that is,

plotsol 0:2:3

...

will plot the projection of a solution to its first two components (U(1),U(2)) versus the continuation parameter. Use filterbd to plot only part of a family, for example, in bash notation

filterbd run -l 1 $(splabs run PD 1 1) | plotsol 0:2:3 - run

...

will plot a family of periodic solutions from the first labeled solution up to and including a solution at the first period-doubling bifurcation. If the parameter (column 0) is given for the $x$, $y$, or $z$ axis, then the family of solutions is plotted as a surface, otherwise, the solutions are plotted as individual curves. This behavior can be changed with the option -bl n; see section `Common switches/options' below.

Plotsol uses green lines for stable, red lines for unstable and various other colors for special solutions. If you prefer a more traditional form of stability plot, then the option -bw will create a black-and-white plot with solid lines for stable, dashed lines for unstable and different markers for special solutions.

In solutions plotting mode

plotsol is similar to PLAUT's 2d and 3d plotting modes. It uses gnuplot to plot solutions from the run with qualified run name qrun, from q.*-file qfile, or from standard input if `-' was given. The input must be solution data. In bash notation a command like

plotsol run $(splabs run UZ)

will plot all solutions at UZR output points from run with qualified run name run. By default a plot of column 3 versus column 2, that is, U(2) versus U(1) is shown. The selection of columns and plotting ranges follows gnuplot's syntax, that is,

plotsol 1:2 "[0:0.5]"

...

will plot U(1) versus time over half a period.

Common switches/options.

If you call plotsol with the -i switch gnuplot will prompt for input. You can then enter any gnuplot commands, for example, to change the plotting ranges or the view. Refresh the graphics with the gnuplot command replot. If mouse support is enabled you can zoom in and rotate the graphics interactively.

The option -bl n will override any default interpretation of the plotting data to: mesh data if $n=1$, or, individual curve data if $n\geq 2$. Default is $n=2$ except if the parameter (column 0) is given for one of the $x$, $y$ or $z$ axis in family plotting mode, in which case the default is $n=1$.

The option -eps eps-name will direct the output to the encapsulated postscript file eps-name.eps. Note that eps-name may contain sub-directories, but should not contain the extension .eps. The figures created by plotsol are intended for a quick overview over the solutions, but not for publication (except this one). However, the intermediate files created by plotsol may serve as a starting point for producing publishable pictures. If you specify the option -k name, then all intermediate files will be saved as files with a name matching name.*. Therefore, name should point to a sub-directory and should not contain any extension. For example,

plotsol -k bddata/pos -eps pics/pos

...

will save all intermediate files to the sub-directory bddata, which must be created before calling plotsol. The most important file in this set is bddata/pos.gp, which is the gnuplot file containing instructions for creating the data-files and, more importantly, the eps-file pics/pos.eps. You should move this gnuplot file to a different location to prevent accidental overwriting, and edit it to accommodate your ideas. Simply call `gnuplot gnuplot-file' to update pics/pos.eps.

Return values

Plotsol returns 0 on success and 1 if an error occurred or the -h switch was given. Error checking is quite sloppy. Plotsol will fail if called with incorrect options/arguments, but the issued error message might not be terribly helpful.