*******************************************************************************

  iuplcosy   - The IU version of plcosy - plot COSY / NOESY type spectra automatically   (macro)

*******************************************************************************

  Syntax: iuplcosy<(levels<,spacing<,exp1D>>)>

              iuplcosy<(levels<,spacing<,exp1D<,horiz. scale<,vert. scale>>>>)>

              iuplcosy('pos'<,levels<,spacing<,exp1D>>>)

              iuplcosy('neg'<,levels<,spacing<,exp1D>>>)

Description: "iuplcosy" automatically plots 2D spectra of type cosy / noesy

              (homonuclear correlated spectra). Features:

• - it keeps the orientation (f1, f2) of the spectrum on the screen

• - the plot area is optimized for the printer selected

• - number of contour levels and their spacing can be selected

• - negative or positive contours can be suppressed

• - 1D traces can be plotted along both axes; such 1D traces are taken from a full (or reduced) 1D spectrum in an other experiment, or from a file from within the current experiment and are plotted at a size equal to 15% of the page height.

• - it also works correctly for expansions

• - the 1D traces can be suppressed, which allows using a larger area for the 2D spectrum

• - the 1D spectrum can be in any experiment

• - the 1D spectrum can be scaled

• - with phase-sensitive spectra, if 'pos' or 'neg' are not selected then the specified number of positive contours are plotted, but only one negative level, to distinguish positive and negative signals.  (To plot all of the contours, both positive and negative, execute iuplcosy twice, once with the positive argument and once with the negative argument; orr use iuplnoesy).

                In multi-experiment mode, for the first plot the experiment with the 1D spectrum should be specified (at least if it is not in exp1). From then on, the 1D spectrum will be stored WITHIN the experiment with the 2D spectrum, which allows much faster switching between the spectra and also frees the other (1D) experiment for other tasks. Because of this "internal storage" the "exp1D" argument is not required for subsequent plots.

Arguments: 

•     'pos' - only plot positive contours

•     'neg' - only plot negative contours

•     levels - the number of contour levels. Default: 12

•     spacing - the spacing between the contours.  Default: 1.4

•     exp1D - the experiment in which the proton 1D spectrum resides; this can be a full 1D spectrum, but the referencing must be the same as for the 2D (see below).  A negative number will suppress the proton trace.  Default: exp1

•     horiz. scale - the scaling factor for the horizontal 1D spectrum along the top of the plot.  Default: 1

•     vert. scale - the scaling factor for the vertical 1D spectrum along the left hand side of the plot.  Default: 1                     

Examples:

iuplcosy 

iuplcosy(12,1.5) 

iuplcosy('pos',16,2,3) 

iuplcosy('neg',8,1.4,3,5,2) 

           |   |  |  | | |_Vertical scale 

           |   |  |  | |_Horizontal scale 

           |   |  |  |_Exp. # for 1D spectrum 

           |   |  |_Contour spacing 

           |   |_Number of contours  

           |_Positive or negative integrals

Usage: A typical sequence of actions for acquiring and plotting a cosy (or noesy) spectrum stepwise (using the multiexperiment mode) will be as follows:

1. - acquire a proton spectrum in exp1 

2. - enter the text and reference the spectrum NOW (before moving the fid to an other experiment) 

3. - mf(4) jexp4 wft ... movesw 

4. - call the macro for the 2D experiment (e.g. "cosy") and acquire the 2D spectrum 

5. - process the 2D spectrum 

6. - for plotting with traces type "iuplcosy" (the defaults fit). 

7. - for expansions select the expansion within "dconi" and type "iuplcosy" again.