----- file created by makedoc on: Thu Sep 11 15:03:12 2014
----- Documentation for /scisoft/xop2.4/extensions/shadowvui/src/lib/presurface.pro -----

 NAME:
	PRESURFACE
 PURPOSE:
	to visualize a surface in the SHADOW's format
 CATEGORY:
       SHADOW's utilities
 CALLING SEQUENCE:
	presurface,'myfile',idl_var,Keyboard_parameters
 INPUTS:
	myfile  name of the file with data (between quotes) 
               (it can also be a structure like idl_var)
 OPTIONAL INPUT PARAMETERS:
	idl_var name of an idl variable to store the data
 KEYWORD PARAMETERS:
		XRANGE=[xmin,xmax] range of the x variable for the plot
		YRANGE=[ymin,ymax]              y
		ZRANGE=[zmin,zmax]              y
		XYRANGE=[xymin,xymax] sets XRANGE and YRANGE simultaneously.
		TITLE='top_title' title to be written at the top
		XTITLE='x_title'  title of x axis
		YTITLE='y_title'           y
		ZTITLE='z_title'           z
		NCOL = number of columns in input file (def=2)
		XCOL = column for x (default=1)
		YCOL = column for y (default=2)
		NOPLOT = When set, inhibits the graph.
		PROFILE = Send profiles to XOP/EXODUS application
 OUTPUTS:
	a plot
 OPTIONAL OUTPUT PARAMETERS:
	the data of the file  in the structure variable selected (idl_var)
       surf = {x:x , y:y , z:z}
 COMMON BLOCKS:
	None.
 SIDE EFFECTS:
	None.
 RESTRICTIONS:
	None.
 PROCEDURE:
	Straightforward.
 MODIFICATION HISTORY:
	by M. Sanchez del Rio. ESRF. Grenoble, Sep 1992
	95/09/26 MSR adds /NOPLOT keyword.
	2007/10/31 srio@esrf.eu adds /PROFILE keyword.
	2009/12/15 srio@esrf.eu adds the possibility to input a structure
	
