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

 NAME:
	PLOTSPACE 
 PURPOSE:
	an IDL implementation of the PLOTSPACE SHADOW's utility
 CATEGORY:
	SHADOW's utilities.
 CALLING SEQUENCE:
	plotspace, shadow_in, keyword_parameters
 INPUTS:
	shadow_in   SHADOW file or IDL structure with SHADOW data
 KEYWORD PARAMETERS:
	TOP = When set, in addition to the plotspace plots
		(x,z),x',z'),(x,x') and (z,z') it plots the 
		top view (y,x) and the side view (y,z).
       EXTRA = any keywird accepted by readsh  (e.g. NOLOST)
       {X,Z,XP,ZP}RANGE = two element array with the corresponding range
       XZRANGE = sets XRANGE and ZRANGE at the same time
       XPZPRANGE = sets XPRANGE and ZPRANGE at the same time

	OUTPUTS:
	a plot on the screen
 SIDE EFFECTS:
 	None.
 RESTRICTIONS:
 	None.
 KNOWN BUGS:
 PROCEDURE:
	Similar to SHADOW's original.
 EXAMPLES:
		plotspace,'begin.dat'

 MODIFICATION HISTORY:
	M. Sanchez del Rio. ESRF. Grenoble Apr 29 1998
       20140617 srio@esrf.eu added range kws. 

