Skip to main content
  • Home
  • Documentation
  • FAQ
  • Downloads
  • Support
  • Current Release Notes
  • Ferret Users Guide
    • Users Guide Index
    • Commands Reference
    • 1. Introduction
    • 2. Data Set Basics
    • 3. Variables & Expressions
    • 4. Grids & Regions
    • 5. Animations & Gif Images
    • 6. Customizing Plots
    • 7. Handling String Data Symbols
    • 8. Working with Special Data Sets
    • 9. Computing Environment
    • 10. Converting to NetCDF
    • 11. Writing External Functions
    • Glossary
    • Appendix A: Functions
    • Appendix B: PPLUS Guide
    • Appendix C: Ferret-Specific PPLUS Enhancements
  • Previous Release Notes
  • Tutorials and Demos
    • Ferret Tour
    • DSG files: Discrete Sampling Geometries Demo
    • Ferret sorting demo
    • Fast Fourier Transforms demo
    • Empirical Orthogonal Functions demo
    • Ferret objective analysis demo
    • Ferret Palette Demo
    • Map projections
    • Ferret polygon vector demo
    • Ferret Graticules demo
    • Ferret Polytube Demo
    • Ferret Polymark Demo
    • Ferret Constant-Array demo
    • Ferret land_detail demo
    • COADS Tour
    • Levitus Tour
    • Use OPeNDAP
    • Ferret binary read demo
  • PyFerret
    • PyFerret Downloads and Install ../../faq/ferret-faqs.html
    • What is PyFerret?
    • Why use PyFerret?
    • PyFerret for the Ferret user
    • PyFerret command syntax: quick-start notes
    • PyFerret for the Python user
    • Graphics in PyFerret ?
    • New Ferret functionality
    • PyFerret Python functions and constants
    • PyFerret Python objects and methods
    • Ferret external functions in Python
    • Ferret Fortran external functions
    • PyFerret metadata-and-data dictionaries
  • OPeNDAP
    • OPeNDAP usage in Ferret
    • Use OPeNDAP Demo
    • Test OPeNDAP

LABEL

Ref Sec15.

LABEL

/NOUSER

Places a label on the current plot; alias for PPL %LABEL. %LABEL is one of PPLUS's primitive plot commands. It places a label on the plot immediately after being issued (rather than deferring placement). PPLUS does not assign numbers to labels created with LABEL, so they cannot be manipulated as movable labels. The label can also be placed on the plot using the mouse to point and click (see the chapter "Customizing Plots", section "Positioning the Mouse Pointer".

yes? LABEL xpos, ypos, center, angle, size, text

xpos, ypos

position in user units (world coordinates)

center

-1 left justification (the default)

0 centered

1 right justification

angle

angle in degrees, 0 degrees at 3 o'clock (default 0)

size

size of text in inches (default 0.12)

See the chapter "Customizing Plots", section "Labels" for examples.

See also the ANNOTATE command which offers all of the functionality of LABEL, with more flexibility.

Command qualifiers for LABEL:

LABEL/NOUSER

Locates labels in inches instead of user units (xpos and ypos are specified in inches rather than in world coordinates).

The LABEL command may not locate the label correctly if it is issued before the plot is drawn.

When putting a label on a plot with a time axis, the location of the label using time coordinates only works if the time axis has units of hours. There is an FAQ that shows how to handle this,
Locating a label based on the date on a time axis plot.