Name

---

    PLOT_SPHERICAL

Purpose

---

    This function will create a three-dimensional quadilateral-faceted
    plot of spherical coordinate data. The data provided must
    represent magnitudes defined at a regularly-spaced set of declination
    and azimuth angles.

Category

---

    General.

Calling Sequence

---

    result = PLOT_SPHERICAL( declination, $
                            azimuth, $
                            magnitude, $
                            DEGREES=inDegrees, $
                            NO_AXES=noAxes )

Inputs

---

    declination
      An array of declination angles at which the magnitudes are defined.
    azimuth
      An array of azimuth angles at which the magntiudes are defined.
    magnitude
      An array of data values at the specified azimuth and zenith angles.
    NOTE: The order of the data contained in the arrays described above must must
          be consistent (a magnitude at a declination and a azimuth must all occupy
          the same array position). The relative ordering of the data can be
          arbitrary as the function will sort the data for proper plotting.

Keyword Parameters

---

    DEGREES
      Set this keyword to interpret the provided declination and azimuth angles
      in degrees. If this keyword is omitted, the angles are assumed to be
      specified in radians.
    NO_AXES
      Set this keyword to omit drawing axes for the produced plot.
  :ERROR CHECKING:
    None.

Side Effects

---

    None.

Requires

---

    BSORT
      This routine can be obtained at http://idlastro.gsfc.nasa.gov/ftp/pro/misc/bsort.pro

Modification History

---

    Written by: Carl Salvaggio
    January, 2012 Original code
   

Disclaimer

---

    This source code is provided "as is" and without warranties as to performance
    or merchantability. The author and/or distributors of this source code may
    have made statements about this source code. Any such statements do not
    constitute warranties and shall not be relied on by the user in deciding
    whether to use this source code.
    This source code is provided without any express or implied warranties
    whatsoever. Because of the diversity of conditions and hardware under which
    this source code may be used, no warranty of fitness for a particular purpose
    is offered. The user is advised to test the source code thoroughly before
    relying on it. The user must assume the entire risk of using the source code.