Personal tools
You are here: Home Documentation Users Guide 6. Customizing Plots 6.1 OVERVIEW
Document Actions

6.1 OVERVIEW

by Catherine Nunkai — last modified 2008-06-04 14:56

Detailed control is possible over most aspects of Ferret graphical outputs. A custom modification will require the user to either add a qualifier to a Ferret command or communicate directly with the graphical package PPLUS, which is contained inside of Ferret. The most commonly used PPLUS commands are listed in the following sections of this chapter. Consult the PLOT PLUS for Ferret manual for complete command lists and the specifics of command syntax.

Ferret communicates with PPLUS by sending a sequence of commands to PPLUS (the command PPL ECHO ON causes the sequence of commands that Ferret sends to PPLUS to be logged in the file fort.41.). The user can give further commands to PPLUS directly using the Ferret command PPL (e.g., yes? PPL AXLEN 10,7). Some results can be attained in two ways—with either Ferret or PPLUS commands. However, the interaction of the two is complex and the inexperienced user may get unexpected results, so when possible, use only Ferret commands.

Note: throughout this discussion a distinction has been made between Ferret commands and PPLUS commands. In reality, the user issues Ferret commands only. "PPLUS commands" in this context refers to PPLUS commands issued via the Ferret command PPL.

PPLUS uses a deferred mode of output—various commands are given to PPLUS which describe the plot state but produce no immediate output; the entire plot is then rendered by a single command. Some plot states (e.g., axis labels) are set by Ferret with every plotted output; to customize these states it is necessary to use the /SET_UP qualifier (which sets up the plot inside of PPLUS) and then modify the state with direct PPL commands. Other plot states are never set by Ferret and, if modified at any time, remain in their specified state for all subsequent plots. Still other states are modified by Ferret only under special circumstances. Here is a very simple customization (Figure 6_1):

Ch6_fig01

yes? PLOT/X=1:100/TITLE="My SIN Plot"/SET_UP sin(x/6) !use /SET_UP
yes? PPL YLAB "SIN value"
yes? PPL PLOT

The examples throughout this chapter show how the /SET_UP qualifier on graphics commands can be used to delay rendering of a plot while the user modifies plot appearance with PPLUS commands.

Below is a list of PPLUS commands which are reset by Ferret. Please see the the PPLUS Users Guide for details of PPLUS syntax.

PPLUS command

when reset by Ferret



XFOR, YFOR

reset for every plot

XLAB, YLAB

reset for every plot

XAXIS, YAXIS

reset for every plot

LABS

reset for every plot

ALINE

reset for every plot

TAXIS OFF

reset for every plot

TITLE

reset for every plot

TICS

reset for every plot (small tic size, only)

WINDOW ON

reset for every plot

PEN 1,n

reset for every plot

LIMITS

reset for every plot

ORIGIN

reset by SET WINDOW/ASPECT and SET VIEWPORT; Y origin may be shifted to accommodate many line style keys

AXLEN

modified by SET WINDOW/ASPECT and SET VIEWPORT

VIEWPORT

modified by WIRE/VIEW

LEV

modified by CONTOUR and SHADE unless /LEVELS_SAME given

VECSET

modified by VECTOR unless /LENGTH_SAME given

WINDOW

modified for "fresh" plots but not for overlay plots




Powered by Plone CMS, the Open Source Content Management System

This site conforms to the following standards: