Calls the fitting routine mpfit.

Input parameters:

	x		A one-dimensional floating-point type value array with the abscissae of y.
	y		A one-dimensional floating-point type-value array with the ordinate values.
	dy		A one-dimensional floating-point type-value array with the errors in y.
	parinfo		A parameter-structure array setup in p3d_ifsfit_lineconf.
	index		An index array that is used to access the required elements in PARINFO.
	lineconf		A line-setup structure – the output structure of p3d_ifsfit_confread.

Keyword parameters:

	z		A scalar floating-point type value that specifies an optional redshift of all regular lines. The default value is: 0.0
	redshift		A scalar floating-point type value specifying an optional offset of all regular lines. The default value is: 0.0
	sshift		A scalar floating-point type value specifying an optional secondary offset of all regular lines. The default value is: 0.0
	mpmaxiter		A scalar integer specifying the maximum number of iterations performed by MPFIT [MAXITER = 20]. The default value is: 20
	mpxtol		A scalar floating-point type value that specifies XTOL of MPFIT [XTOL = 1d-10].
	mpftol		A scalar floating-point type value that specifies FTOL of MPFIT [FTOL = 1d-10].
	mpgtol		A scalar floating-point type value that specifies GTOL of MPFIT [GTOL = 1d-10].
	ompniter		Upon successful exit this parameter contains a scalar integer specifying the number of iterations performed by MPFIT.
	ompchisq		Upon successful exit this parameter contains a scalar floating-point type value specifying the Chi square value of the fit.
	ompnfev		Upon successful exit this parameter contains a scalar integer specifying the number of function evaluations performed by MPFIT.
	ompdof		Upon successful exit this parameter contains a scalar integer specifying the number of degrees of freedom of the fit performed by MPFIT.
	ompstatus		Upon successful exit this parameter contains a scalar integer specifying the exit status code of MPFIT.
	topwid		If set, then error messages are displayed using DIALOG_MESSAGE, using this widget id as DIALOG_PARENT, instead of MESSAGE.
	logunit		Messages are saved to the file pointed to by this logical file unit, if it is defined.
	verbose		Set this parameter to a positive scalar integer to make p3d write some information on STDOUT about what is going on. The following four values are acknowledged: 0 Writes no information at all. This is the default. 1 Writes the more important information; regarding subroutine configurations, mostly. 2 Writes most information; includes a more verbose output than 1. 3 Writes all information, including information on the execution state of GUI subroutines. This may be a useful mode when debugging the code.
	error		This scalar integer returns an error code if set. Any value different from zero means that an error has occurred.
	debug		No error handler is setup if this keyword is set. The default is otherwise to setup an error handler (using the routine CATCH), which makes each subroutine exit quietly in case a bug is encountered. Use this keyword when debugging p3d.
	help		Set this keyword to show this routine documentation, and then exit.

Output parameters:

	par		A double array with the fitted parameters.
	sigpar		A double array with the errors of the fitted parameters.

Draws a colorbar on top of or to the right of a plot at the specified position.

Input parameters:

range

A two-dimensional decimal-type array with the minimum and maximum values that the colors in the colorbar assume.

Keyword parameters:

	reverse		Set this keyword to reverse the colorbar.
	barright		Set this keyword to draw a vertical colorbar instead of a horizontal colorbar. The colorbar is setup to be put on the right of the plot.
	position		A four-element decimal-type array that specifies the position of the colorbar in normalized coordinates.
	minor		A scalar integer that specifies the number of minor tick mark intervals between the major tick marks. The default value is: 4
	title		A scalar string with a title that is placed on top of (to the right of) the colorbar and the tick values when BARRIGHT is unset (set). The title string is prefixed with the 10-logarithm value of RANGE when LOGSCALE is unset. The default value is: ''
	logscale		Set this keyword to draw a colorbar with logarithmic values instead of linear.
	ncolors		A scalar integer value that defines the number of colors to use in the colorbar. The default value is: !d.table_size
	bottom		A scalar integer value that defines the bottom index of the color array. The color values smaller than BOTTOM are used to draw the colorbar axes. The default value is: !d.table_size – ncolors
	tabcolors		An integer array that provides the colors when using decomposed colors. The foreground (background) color is taken as the first (second) element in the array.
	cinv		Set this keyword to swap the foreground and background colors.
	charsize		A scalar decimal-type value that defines the font size. The default value is: 1.0
	charthick		A scalar decimal-type value that defines the thickness of the font. The variable is passed on to PLOT, AXIS, and XYOUTS.
	thick		A scalar decimal-type value that defines the thickness of the lines. The variable is passed on to PLOT and AXIS.
	decomposed		A scalar integer that specifies if decomposed (1) or indexed (0) colors are to be used.
	font		A scalar integer value that defines the font scheme to use. The variable is passed on to PLOT, AXIS, and XYOUTS.
	topwid		If set, then error messages are displayed using DIALOG_MESSAGE, using this widget id as DIALOG_PARENT, instead of MESSAGE.
	logunit		Messages are saved to the file pointed to by this logical file unit, if it is defined.
	verbose		Set this parameter to a positive scalar integer to make p3d write some information on STDOUT about what is going on. The following four values are acknowledged: 0 Writes no information at all. This is the default. 1 Writes the more important information; regarding subroutine configurations, mostly. 2 Writes most information; includes a more verbose output than 1. 3 Writes all information, including information on the execution state of GUI subroutines. This may be a useful mode when debugging the code.
	error		This scalar integer returns an error code if set. Any value different from zero means that an error has occurred.
	debug		No error handler is setup if this keyword is set. The default is otherwise to setup an error handler (using the routine CATCH), which makes each subroutine exit quietly in case a bug is encountered. Use this keyword when debugging p3d.
	help		Set this keyword to show this routine documentation, and then exit.

The purpose of this routine is to read and parse a plain-text file that contains information on which lines to fit, and how to fit them.

Each entry in the configuration file must contain three columns that are separated by white space. Anything that comes after a semicolon is ignored. The information can be entered in any order, for as long as all necessary information is available.

The information is specified in three different categories: setup, group, and line. Entries of the setup category define the line width, the order of the background polynomial, and which properties are limited. Entries of the group category define the wavelength range of each group of line fits. Entries of the line category define which group a line belongs to, which wavelength it has, which function type it is, if it is a regular line or a sky line, and if it is an emission or an absorption line.

Options in the setup category

Each option is specified with the word "setup" or the character "s" in the first column. The property name is specified in the second column and its value in the third column. These are the available properties:

Options in the group category

Each option is specified with the word "group" or the character "g" in the first column. The mandatory group number is specified in the first column as well, following an underscore. For example, group 1 is specified as "group_1". The property name is specified in the second column and its value in the third column. These are the available properties:

Options in the line category

Each option is specified with the word "line" or the character "l" in the first column. The mandatory group and line id numbers are specified in the first column as well; following an underscore and the group number, another underscore and the line id number. For example, a line belonging to group 1 with the id number 101 is specified as "line_1_101". The property name is specified in the second column and its value in the third column. These are the available properties:

The return structure

Upon a successful return this routine returns the structure LINECONF:

Input parameters:

filename

A scalar string or an array of strings. If this variable is set to a scalar string, it must contain the name of a configuration file, including its full path. If it is instead an array of strings, it is assumed to contain the read contents of a configuration file.

Keyword parameters:

	topwid		If set, then error messages are displayed using DIALOG_MESSAGE, using this widget id as DIALOG_PARENT, instead of MESSAGE.
	logunit		Messages are saved to the file pointed to by this logical file unit, if it is defined.
	verbose		Set this parameter to a positive scalar integer to make p3d write some information on STDOUT about what is going on. The following four values are acknowledged: 0 Writes no information at all. This is the default. 1 Writes the more important information; regarding subroutine configurations, mostly. 2 Writes most information; includes a more verbose output than 1. 3 Writes all information, including information on the execution state of GUI subroutines. This may be a useful mode when debugging the code.
	error		This scalar integer returns an error code if set. Any value different from zero means that an error has occurred.
	debug		No error handler is setup if this keyword is set. The default is otherwise to setup an error handler (using the routine CATCH), which makes each subroutine exit quietly in case a bug is encountered. Use this keyword when debugging p3d.
	help		Set this keyword to show this routine documentation, and then exit.

Output parameters:

lineconf

Upon exit of the routine this variable contains a structure with both all preset properties as well as those that were parsed from FILENAME.

This function calculates a composite function that consists of a background signal linear polynomial (of desired order) and any number of line functions of the type "Gaussian", "Lorentzian", "Moffat", and "Voigt". The line configuration is specified using the LINECONF and INDEX keywords. Regular lines, i.e. not sky/telluric lines, are also red- or blue-shifted using the REDSHIFT and SSHIFT keywords.

This function is normally called by MPFIT, calculating the function residual. When the FUNCEVAL and FEI keywords are set it can be used to calculate the total line function, or just an individual line component.

Input parameters:

p

.

Keyword parameters:

	x		A one-dimensional floating-point type value array with the abscissae of y.
	y		A one-dimensional floating-point type-value array with the ordinate values.
	dy		A one-dimensional floating-point type-value array with the errors in y.
	fei		.
	funceval		.
	z		A scalar floating-point type value specifying an optional redshift of all regular lines. The default value is: 0.0
	redshift		A scalar floating-point type value specifying an optional offset of all regular lines. The default value is: 0.0
	sshift		A scalar floating-point type value specifying an optional secondary offset of all regular lines. The default value is: 0.0
	index		.
	lineconf		.

Manages the object class p3d_ifsfit_ifu, which handles line-specific data of an integral-field unit (IFU).

Data related to the entire IFU are stored in this class, which provides a simple interface to IFU data, and is used by, e.g., p3d_ifsfit_mosaic.

The typical use of the COLMIN and COLMAX keywords is when a number of data sets are re-scaled to use the same color table.

Keyword parameters:

	The
	individually:
	p3d_ifsfit_ifu::set		filename – A scalar string with the name of a binary-table FITS file with data processed by p3d_ifsfit_io (p3d_ifsfit), which contents are loaded into a class object. offset [0.0, 0.0] - A two-element decimal-type value array that specifies how the data are to be offset on the x and the y axes, before they are stored in the class object. iscale – An optional scaling factor to apply to the loaded intensities and continuum data; ISCALE > 0.0. scale [file] – This keyword returns the value of the scale, as found in the binary-table FITS file. minvali [file] – A scalar decimal-type value that specifies the minimum value of the loaded intensity data. maxvali [file] – A scalar decimal-type value that specifies the maximum value of the loaded intensity data. colmini [file] – A scalar decimal-type value that specifies the minimum value of the loaded intensity data used with the color range. colmaxi [file] – A scalar decimal-type value that specifies the minimum value of the loaded intensity data used with the color range. minvalv [file] – A scalar decimal-type value that specifies the minimum value of the loaded velocity data. maxvalv [file] – A scalar decimal-type value that specifies the maximum value of the loaded velocity data. colminv [file] – A scalar decimal-type value that specifies the minimum value of the loaded velocity data used with the color range. colmaxv [file] – A scalar decimal-type value that specifies the minimum value of the loaded velocity data used with the color range. minvalw [file] – A scalar decimal-type value that specifies the minimum value of the loaded line-width data. maxvalw [file] – A scalar decimal-type value that specifies the maximum value of the loaded line-width data. colminw [file] – A scalar decimal-type value that specifies the minimum value of the loaded line-width data used with the color range. colmaxw [file] – A scalar decimal-type value that specifies the minimum value of the loaded line-width data used with the color range. minvalc [file] – A scalar decimal-type value that specifies the minimum value of the loaded continuum data. maxvalc [file] – A scalar decimal-type value that specifies the maximum value of the loaded continuum data. colminc [file] – A scalar decimal-type value that specifies the minimum value of the loaded continuum data used with the color range. colmaxc [file] – A scalar decimal-type value that specifies the minimum value of the loaded continuum data used with the color range. title [file] – A scalar string that specifies the name of the property stored in the file. xstr ['RA offset ['''']'] - A scalar string that specifies what to put on the x-axis (RA-direction) in data plots. ystr ['DEC offset ['''']'] - A scalar string that specifies what to put on the y-axis (DEC-direction) in data plots. rightascension [file] - A scalar decimal value that allows the value of the right ascension to be set manually. declination [file] - A scalar decimal value that allows the value of the declination to be set manually [degrees]. didoffset – N/A. colortable [-1] – A scalar string or integer that specifies which color table should be loaded. If COLORTABLE is a string, the string must contain two parts separated by a comma, without any whitespace between. The first part before the comma specifies the color-table number in the file name specified after the comma; the file must be formatted as described in the documentation for MODIFYCT. As an example, COLORTABLE='25,brewer.tbl'. Components in the ColorBrewer color-table file "brewer.tbl" found in the resource directory can be specified explicitly by preceeding the string with "CB"; for example, COLORTABLE='CB25'. If COLORTABLE is an integer, the integer must be given in the range -4, -3, -2, -1, 0, ..., up to the maximum number of available tables in IDL, plus the available tables in the ColorBrewer file (resource/) "brewer.tbl". Select -4, -3, -2, or -1 to load the cubehelix, 2 * Califa, and the Sauron color tables, the other values use the respective color map as defined by LOADCT. These are the permitted values: -4 Loads the cubehelix color table. -3 Loads the Califa project intensity color table, as defined September 2012. -2 Loads the Califa project velocity field color table, as defined September 2012. -1 Loads the Sauron color table (default). 0-74 (IDL version >= 8.3) Loads the corresponding color table with LOADCT. 0-40 (IDL version < 8.3) Loads the corresponding color table with LOADCT. 'CB0'-'CB85' Loads the corresponding ColorBrewer color table; the color tables are defined in the file "resource/brewer.tbl" 75-159 (IDL version >= 8.3) Loads the ColorBrewer color table corresponding to this number after 75 is subtracted; the color tables are defined in the file "resource/brewer.tbl" 41-125 (IDL version < 8.3) Loads the ColorBrewer color table corresponding to this number after 41 is subtracted; the color tables are defined in the file "resource/brewer.tbl" 'x,ctfile' Loads the x:th entry ('x' must be an integer) in the color-table file 'ctfile. invert – Set this keyword to reverse the loaded color table. setcolor – Recalculates the color index (decomposed == 0) or value (decomposed == 1) for each spatial element. Note! Colors are recalculated automatically when any of the following keywords are changed: COLMINx, COLMAXx, COLORTABLE, or LOG. sexagesimal [0] – Set this keyword to plot axes using the sexagesimal format instead of arcsec. logscale [0] – If this keyword is set, the log_10 of the value is used to calculate the color instead of usual value. This is a nearly mandatory keyword when multiple lines of drastically different amplitude, or bright regions and much fainter regions are shown in the same plot. loadcolortable [1] - Set this keyword to force the color table to be loaded. topwid – If set, then error messages are displayed using DIALOG_MESSAGE, using this widget id as DIALOG_PARENT, instead of MESSAGE. logunit – Messages are saved to the file pointed to by this logical file unit, if it is defined. verbose – Set this parameter to a positive scalar integer to make p3d write some information on STDOUT about what is going on. The following four values are acknowledged: 0 Writes no information at all. This is the default. 1 Writes the more important information; regarding subroutine configurations, mostly. 2 Writes most information; includes a more verbose output than 1. 3 Writes all information, including information on the execution state of GUI subroutines. This may be a useful mode when debugging the code. error – This scalar integer returns an error code if set. Any value different from zero means that an error has occurred. debug – No error handler is setup if this keyword is set. The default is otherwise to setup an error handler (using the routine CATCH), which makes each subroutine exit quietly in case a bug is encountered. Use this keyword when debugging p3d. help – Set this keyword to show this routine documentation, and then exit.
	p3d_ifsfit_ifu::polyget		xpos – Returns the x coordinates of polygons in an array (in all columns) for each spatial element in the IFU. ypos – Returns the y coordinates of polygons in an array (in all columns) for each spatial element in the IFU. use – Returns a byte array that indicates which polygons contain useful data. color – Returns an integer array with the color index (decomposed == 0) or color value (decomposed == 1) of each spatial element. val – Returns an array with the fitted values. dval – Returns an array with the fitted error values. nvertices [20] – Specifies the number of vertices(-1) to use with circular polygons (shape == 1). velocity – Velocities are returned instead of intensities if this keyword is set. width – Line widths are returned instead of intensities if this keyword is set. This keyword is ignored when VELOCITY is also set. continuum – Continuum values are returned instead of intensities if this keyword is set. This keyword is ignored when VELOCITY or WIDTH are also set.
	p3d_ifsfit_ifu::get		nspx – Returns a scalar integer with the number of spatial elements on the IFU. shape – Returns a scalar byte that specifies the shape of the spatial elements. scale – Returns a scalar integer that specifies the scale of the spatial elements. pa – Returns a scalar decimal-type value with the position angle of the IFU. offset – Returns a two-element decimal-type array with the applied offsets on the x and the y axes. minvali – Returns a scalar decimal-type value with the minimum value of the loaded intensity data. maxvali – Returns a scalar decimal-type value with the maximum value of the loaded intensity data. colmini – Returns a scalar decimal-type value with the minimum value of the loaded intensity data used with the color range. colmaxi – Returns a scalar decimal-type value with the minimum value of the loaded intensity data used with the color range. minvalv – Returns a scalar decimal-type value with the minimum value of the loaded velocity data. maxvalv – Returns a scalar decimal-type value with the maximum value of the loaded velocity data. colminv – Returns a scalar decimal-type value with the minimum value of the loaded velocity data used with the color range. colmaxv – Returns a scalar decimal-type value with the minimum value of the loaded velocity data used with the color range. minvalw – Returns a scalar decimal-type value with the minimum value of the loaded line-width data. maxvalw – Returns a scalar decimal-type value with the maximum value of the loaded line-width data. colminw – Returns a scalar decimal-type value with the minimum value of the loaded line-width data used with the color range. colmaxw – Returns a scalar decimal-type value with the minimum value of the loaded line-width data used with the color range. minvalc – Returns a scalar decimal-type value with the minimum value of the loaded continuum data. maxvalc – Returns a scalar decimal-type value with the maximum value of the loaded continuum data. colminc – Returns a scalar decimal-type value with the minimum value of the loaded continuum data used with the color range. colmaxc – Returns a scalar decimal-type value with the minimum value of the loaded continuum data used with the color range. xstr – Returns a scalar string with the x-axis title. ystr – Returns a scalar string with the y-axis title. logscale – Returns a scalar integer that indicates if the data were logged or not. rightascension – Returns a scalar decimal-type value with the used right ascension coordinate (degrees). declination – Returns a scalar decimal-type value with the used declination coordinate (degrees). didoffset – Returns a scalar integer that indicates if the coordinates were offset or not using the OFFSET keyword. sexagesimal – Returns a scalar integer that indicates if SEXAGESIMAL was set when the object was created. tabcolors – Returns a pointer to a 256-element array with the table values that are used with decomposed graphics. decomposed – Returns a scalar integer that indicates if graphics are decomposed (1) or not (0). colortable – Returns a scalar integer or string that indicates which color table was used. invert – Returns a scalar integer that indicates if the color table was inverted when loading. npar – Returns a scalar inteher that indicates how many parameters went into the fit of the line. src – Returns a scalar string with the source of the fitted data (currently undefined). title – spaxels – Returns a structure array with the data stored in each spatial element (useful for debugging purposes, otherwise not). xrange – Returns a two-element array with the minimum and maximum values of the stored x-coordinates. yrange – Returns a two-element array with the minimum and maximum values of the stored y-coordinates. bottom – Returns a scalar integer that indicates the used bottom index used in the color table. ncolors – Returns a scalar integer that indicates how many colors where used in the color table. help – Prints this routine documentation, and exits.

Side effects:

When this object is created an array of objects of class p3d_ifsfit_spaxel is also created. In order to return all memory gracefully when objects of this class have been used, they should be deleted using the obj_destroy procedure.

The purpose of this routine is to write and read the output data files that are generated by p3d_ifsfit.

To save space the data are stored in binary-table FITS files; all outcome of the fitting process are stored in this file. Fitted data based on square-shaped elements are also saved as images in a file with multiple extensions; these extensions are explained below.

The content of binary-table fits files

The data that are to be stored are provided as a structure, where the same structure is returned when the routine is used to load data from a file. The input (output) data structure must have (has) the following content:

z : A scalar floating-point type value that specifies the redshift used when fitting the data.

When the parameter usebins is set, the additional file extension VORONOI_TABLE is assumed to contain the following keywords (the routine returns with an error if these data are not present in the file):

The extensions of image (map) files

Data based on square-shaped elements are saved in image files (unless the keyword NOWRITEMAPS is set). An attempt is made to calculate the world coordinate system (WCS). The image files contain the following extensions:

Keyword parameters:

	save		If this keyword is set then DATA is stored in a FITS binary-table file with the name FILENAME. If this keyword is unset then the FITS binary-table file with the name FILENAME is loaded into the data structure DATA.
	filename		A string scalar or a string array with the name of the file(s) that should be read from (SAVE=0) or written to (SAVE=1). This keyword must have as many elements as DATA.
	lines		An array of integers that specifies which files are to be loaded. Only those entries in FILENAME that contain the sub-string *_iXXX.* are loaded.
	offset		An optional [2, n]-element array specifying an offset that is applied to the x (W-E) and y (S-N) positions of the loaded data. This keyword must have as many rows as FILENAME has elements. However, if LINES is specified OFFSET must have as many rows as the number of selected files.
	compress		Set this keyword to compress the output when save is set.
	nthreads		A scalar integer that specifies how many threads to use in the parallelized output file compression. The default value is: max
	noC		This keyword is forwarded to p3d_misc_rss2cube.
	posfile		This keyword is forwarded to p3d_misc_rss2cube.
	posdata		The data origin is assumed to be a data cube if this keyword is used. It is also forwarded to p3d_misc_rss2cube.
	cube		This variable indicates if the original data belong in a cube (1) or not (0); a pre-binned cube is indicated with a separate code (2).
	inhdr		A string array forwarded to p3d_misc_wcs_setup.
	inzhdr		A string array forwarded to p3d_misc_wcs_setup.
	binidx_struc		A scalar structure with tags for the bin index and //x// and //y// positions for each spatial element as well as a unique bin index array, etc.
	kwrdlist		A string array forwarded to p3d_misc_wcs_setup.
	spaxelscale		A string array forwarded to p3d_misc_wcs_setup.
	binflipx		Set this keyword to have the position data flipped on the x-axis (W->E) when CUBE is set to 2.
	sbinflipx		A scalar string identifying the origin of how BINFLIPX is set, when it is set.
	revision		A scalar integer forwarded to p3d_misc_bins_file_write.
	z_scalar		A column (Z) is added with used redshift values if this keyword is unset.
	nowritebintables		Set this keyword to avoid writing the binary table utput files containing the fitted properties.
	nowritemaps		Set this keyword to avoid writing the spatial map images of the fitted properties; these files are, in any case, only written for data sets using square-shaped spatial elements (including data cubes).
	daxis		Defines the dispersion direction dimension of the input data. The default, 1, is in the x-direction. The default value is: 1
	topwid		If set, error messages are displayed using DIALOG_MESSAGE with this widget id as DIALOG_PARENT, instead of MESSAGE.
	logunit		Messages are saved to the file pointed to by this logical file unit, if it is defined.
	verbose		Set this parameter to a positive scalar integer to make p3d write some information on STDOUT about what is going on. The following four values are acknowledged: 0 Writes no information at all. This is the default. 1 Writes the more important information; regarding subroutine configurations, mostly. 2 Writes most information; includes a more verbose output than 1. 3 Writes all information, including information on the execution state of GUI subroutines. This may be a useful mode when debugging the code.
	error		This scalar integer returns an error code if set. Any value different from zero means that an error has occurred.
	debug		No error handler is setup if this keyword is set. The default is otherwise to setup an error handler (using the routine CATCH), which makes each subroutine exit quietly in case a bug is encountered. Use this keyword when debugging p3d.
	cdebug		A keyword as DEBUG used with the called C routines; valid values are 0-6 where a higher number results in more output to STDERR.
	help		Set this keyword to show this routine documentation, and then exit.

The purpose of this routine is to setup the required parameter structure and an index array that are used by mpfit.

Input parameters:

group

A scalar integer with the group number that shall be setup.

Keyword parameters:

	lineconf		A line-setup structure – the output structure of p3d_ifsfit_confread.
	order		Returns an array with the line ids as they were setup.
	dcenter		A scalar decimal value specifying the allowed deviation of the line center position. The default value is: 1.0
	topwid		If set, then error messages are displayed using DIALOG_MESSAGE, using this widget id as DIALOG_PARENT, instead of MESSAGE.
	logunit		Messages are saved to the file pointed to by this logical file unit, if it is defined.
	verbose		Set this parameter to a positive scalar integer to make p3d write some information on STDOUT about what is going on. The following four values are acknowledged: 0 Writes no information at all. This is the default. 1 Writes the more important information; regarding subroutine configurations, mostly. 2 Writes most information; includes a more verbose output than 1. 3 Writes all information, including information on the execution state of GUI subroutines. This may be a useful mode when debugging the code.
	error		This scalar integer returns an error code if set. Any value different from zero means that an error has occurred.
	debug		No error handler is setup if this keyword is set. The default is otherwise to setup an error handler (using the routine CATCH), which makes each subroutine exit quietly in case a bug is encountered. Use this keyword when debugging p3d.
	help		Set this keyword to show this routine documentation, and then exit.

Output parameters:

	index		An array of structures with one structure per component.
	parinfo		The setup parameter control structure for MPFIT.
	p		A double-type array with the initial values.

Calculates the x and y sizes depending on the pre-set aspect ratio.

Configures postscript output for use with p3d_ifsfit_mosaic.

Keyword parameters:

	filename		- Default postscript filename. The default value is: p3d_ifsfit.ps|.eps
	encapsulated		Produces an encapsulated postscript file.
	pdf		Set this keyword to indicate that the output is saved to a temporary directory.
	landscape		Specifying if the plot should be drawn in landscape mode instead of portrait mode; PORTRAIT takes precedence if both LANDSCAPE and PORTRAIT are set.
	portrait		Specifying the portrait orientation; PORTRAIT takes precedence if both LANDSCAPE and PORTRAIT are set.
	color		Specifies if the postscript file should be printed in color. The default value is: 1
	cmyk		Set this keyword to use the CMYK color scheme instead of RGB.
	isolatin1		See documentation for the procedure 'device'. The default value is: 1
	bits_per_pixel		See documentation for the procedure 'device'. The default value is: 8
	charsize		Sets the character size used in determining an optimal paper size.
	a2		Uses the A2 paper size instead of the default A4.
	a3		Uses the A3 paper size instead of the default A4.
	a5		Uses the A5 paper size instead of the default A4.
	letter		Uses the US LETTER paper size instead of the default A4.
	legal		Uses the US LEGAL paper size instead of the default A4.
	tabloid		Uses the US TABLOID paper size instead of the default A4.
	font_size		Sets the font size (points). The default value is: 10.0
	paperxsize		orizontal size of the paper. The default value is: 21.0; landscape: 29.7cm
	xsize		orizontal size of the printed area. The default value is: 19.0; landscape: 26.0cm
	xoffset		orizontal offset. The default value is: value resulting in a centered area on the papercm
	paperysize		ertical size of the paper. The default value is: 29.7; landscape: 21.0cm
	ysize		ertical size of the printed area. The default value is: 26.0; landscape: 19.0cm
	yoffset		ertical offset. The default value is: value resulting in a centered area on the papercm
	aspect		Fixes the aspect XSIZE / YSIZE of plotted regions. If set, YSIZE is recalculated using the XSIZE and the ASPECT values. Note: Since hardware fonts are used (by default), it is difficult to calculate an exact aspect ratio. However, the result should be a good approximation. If a better value is required, use the XSIZE and YSIZE keywords.
	caspect		A aspect ratio correction factor. The default value is: 1.0
	xmargin		Two-element arrays specifying the margins on the xis. e! Only used when ASPECT is set. The default value is: 0.0, 0.0
	ymargin		Two-element arrays specifying the margins on the xis. e! Only used when ASPECT is set. The default value is: 0.0, 0.0
	nxplot		A scalar integer that specifies the number of panels to use on the x-axis; the default is 1. Note! Only used when ASPECT is set. The default value is: 1
	nyplot		A scalar integer that specifies the number of panels to use on the y-axis; the default is 1. Note! Only used when ASPECT is set. The default value is: 1
	avantgarde		Set this keyword to select the ITC Avant Garde PostScript font.
	bkman		Set this keyword to select the ITC Bookman PostScript font.
	courier		Set this keyword to select the Courier PostScript font.
	helvetica		Set this keyword to select the Helvetica PostScript font.
	palatino		Set this keyword to select the Palatino PostScript font.
	schoolbook		Set this keyword to select the New Century Schoolbook PostScript font.
	times		Set this keyword to select the Times-Roman PostScript font.
	bold		Set this keyword to specify that the bold version of the current PostScript font should be used.
	book		Set this keyword to specify that the book version of the current PostScript font should be used.
	demi		Set this keyword to specify that the demi version of the current PostScript font should be used.
	italic		Set this keyword to specify that the italic version of the current PostScript font should be used.
	light		Set this keyword to specify that the light version of the current PostScript font should be used.
	medium		Set this keyword to specify that the medium version of the current PostScript font should be used.
	narrow		Set this keyword to specify that the narrow version of the current PostScript font should be used.
	oblique		Set this keyword to specify that the oblique version of the current PostScript font should be used.
	set_font		Set this font to a scalar string specifying the name of the font used with hardware or TrueType fonts. Note: It is necessary to also set TT_FONT when using a TrueType font.
	tt_font		Set this keyword to indicate that the font set via the SET_FONT keyword should be treated as a TrueType font.
	ofile		Se to the output filename including the path, if PDF is set.
	topwid		If set, then error messages are displayed using DIALOG_MESSAGE, using this widget id as DIALOG_PARENT, instead of MESSAGE.
	logunit		Messages are saved to the file pointed to by this logical file unit, if it is defined.
	verbose		Set this parameter to a positive scalar integer to make p3d write some information on STDOUT about what is going on. The following four values are acknowledged: 0 Writes no information at all. This is the default. 1 Writes the more important information; regarding subroutine configurations, mostly. 2 Writes most information; includes a more verbose output than 1. 3 Writes all information, including information on the execution state of GUI subroutines. This may be a useful mode when debugging the code.
	error		This scalar integer returns an error code if set. Any value different from zero means that an error has occurred.
	debug		No error handler is setup if this keyword is set. The default is otherwise to setup an error handler (using the routine CATCH), which makes each subroutine exit quietly in case a bug is encountered. Use this keyword when debugging p3d.
	help		Displays this routine documentation, and exits.

Output parameters:

par

A double array with the fitted parameters.