pro d17_save,win,outfile,header=header,outformat=outformat

                LAMP procedure to save a dataset with arbitrary X and Y parameters

                The dataset can have one, two or three dimensions

                The output file will contain:

                                an array with the Z values (the number of arrays stacked on top of each other)

                                an array with the X values

                                an array with the Y values

                                an array with the data

                                an array with the errors on the data

                Note that the array sizes for X, Y, and the data can all be different

                                but that the data and errors will have the same array size

                It also assumes that matrices, if stacked, all have the same X- and Y-values

NECESSARY INPUT:

                win=the input workspace

                outfile=the output file name (as a string)

OPTIONAL VARIABLES:

                header=a string that will be printed in to the file

                outformat=a string that permits the output format to be changed
                            The default output format is noted above, and is best for 2D datasets
                            Other supported formats are:
                                    'xye'    requires 1D datasets with one set of x-values, e.g. specular data
                                            Will transpose the arrays, and will save with columns:
                                                       x  y1 e(y1) y2 e(y2) etc.
                                            Will not save Z or Y
 

                e.g. type at LAMP interface:

                                d17_save,w10,'delme',header='Throw me away'

Data saved in this format may be subsequently loaded in to other programs.  Supported load routines for importing the saved data are downloadable by clicking on the links below.

MATLAB load routine