IDL plot

CLIP

---

Accepted by: CONTOUR Procedure, DRAW_ROI Procedure, OPLOT Procedure, PLOT Procedure,PLOTS Procedure,POLYFILL Procedure, SHADE_SURF Procedure, SURFACE Procedure,  TV Procedure, TVCRS Procedure, XYOUTS Procedure. System variable equivalent: !P.CLIP.

The coordinates of a rectangle used to clip the graphics output. The rectangle is specified as a vector of the form [X₀, Y₀,X₁, Y₁], giving coordinates of the lower left and upper right corners, respectively. The default clipping rectangle is the plot window, the area enclosed within the axes of the most recent plot. Coordinates are specified in data units unless an overriding coordinate unit specification keyword is present (i.e., NORMAL or DEVICE). If the clipping is provided in data or normalized units, the actual clipping rectangle is computed by converting those values to device units. The clipping itself always occurs in device space.

Note: The default is not to clip the output of PLOTS and XYOUTS. To enable clipping include the keyword parameter NOCLIP = 0. With PLOTS, POLYFILL, and XYOUTS, this keyword controls the clipping of vectors and vector-drawn text.

For example, to draw a vector using normalized coordinates with its contents clipped within a rectangle covering the upper left quadrant of the display:

PLOTS, X, Y, CLIP=[0.,.5,.5,1.0], /NORM, NOCLIP=0

LINESTYLE
 
 
Accepted by: DRAW_ROI Procedure,OPLOT Procedure, PLOT Procedure,PLOTS Procedure, POLYFILL Procedure,SURFACE Procedure. System variable equivalent: !P.LINESTYLE.
This keyword indicates the line style used to draw lines; it indicates the line style of the lines used to connect the data points. This keyword should be set to the appropriate index for the desired linestyle as described in the following table.
 
 

   
   IDL Linestyles
  
  
Index
Linestyle
0
Solid
1
Dotted
2
Dashed
3
Dash
 Dot
4
Dash
 Dot Dot
5
Long
 Dashes


NOERASE
 
 
Accepted by: AXIS Procedure, CONTOUR Procedure, PLOT Procedure, SURFACE Procedure. System variable equivalent: !P.NOERASE.
Specifies that the screen or page is not to be erased. By default, the screen is erased, or a new page is begun, before a plot is produced.
Note: If the NOERASE keyword (or !P.NOERASE) is set, the value of the BACKGROUND keyword (or !P.BACKGROUND) is ignored.
PSYM
 
 
Accepted by: DRAW_ROI Procedure, OPLOT Procedure, PLOT Procedure, PLOTS Procedure. System variable equivalent: !P.PSYM.
The symbol used to mark each data point. Normally, PSYM is 0, data points are connected by lines, and no symbols are drawn to mark the points. Set this keyword, or the system variable !P.PSYM, to the symbol index as shown in the table below to mark data points with symbols. When a positive value is supplied for PSYM, no lines are used to connect the data points (except when PSYM=10). The keyword SYMSIZE is used to set the size of the symbols.
 
 

   
   Values for the PSYM Keyword
  
  
PSYM
 Value
Plotting
 Symbol
1
Plus
 sign (+)
2
Asterisk
 (*)
3
Period
 (.)
4
Diamond
5
Triangle
6
Square
7
X
8
User-defined.
 See USERSYM Procedure procedure.
9
Undefined
10
Histogram
 mode. Horizontal and vertical lines connect the plotted points, as opposed to the normal method of connecting points with straight lines. See Histogram Mode for an example.
Negative values of PSYM cause the symbol designated by PSYM to be plotted at each point with solid lines connecting the symbols. For example, a value of -5 plots triangles at each data point and connects the points with lines. Histogram mode is the exception to this rule; since the points are already connected when PSYM=10, specifying the value -10 is meaningless, and will result in an error.
The following IDL code plots an array using points, and then overplots the smoothed array, connecting the points with lines:
;Plot using points.
PLOT, A, PSYM=3 
 
;Overplot smoothed data.
OPLOT, SMOOTH(A,7)