Name

---

      JSPLOT

Purpose

---

      Make a time series plot with time in Julian Seconds.

Category

---

Calling Sequence

---

      jsplot, js, y

Inputs

---

      js = Time array in Julian Seconds. in
            May also be an array of date/time strings.
      y = Data to be plotted. in

Keyword Parameters

---

Keywords

---

        /AXES used to replot the data and axes the same as they
          were done in the last jsplot. Call with no data:
            jsplot,/axes OR jsplot,/axes, /nodata
          May also use color=clr to change color of axes (& data).
        GAP=gs Gap in seconds. This or greater time difference
          will cause a break in the curve. If a plot symbol
          is desired use a negative psym number to connect pts.
        CCOLOR=cc Curve and symbol color (def=same as axes).
        XTITLE=txt Time axis title text.
        XTICKLEN=xtl Time axis tick length (fraction of plot).
        XTICKS=n Suggested number of time axis ticks.
          The actual number of tick marks may be quite different.
        FORMAT=fmt Set date/time format (see timeaxis,/help).
        LABELOFF=off Adjust label position (see timeaxis,/help).
        MAJOR=mjr Major grid linestyle.
        MINOR=mnr Minor grid linestyle.
        JSMAJOR=jsmajor Returned major time tick positions (JS).
        JSMINOR=jsminor Returned minor time tick positions (JS).
        TRANGE=[js1,js2] Specified time range in JS.
          May also give date/time strings as entries.
        OFF=off Returned JS of plot min time. Use to plot
          times in JS: VER, js(0)-off.
        /OVER Make overplot. oplot,js-off,y also works
          but will not handle any gaps.
        Any plot keywords will be passed on to the plot call.
        Following related to background sun colors:
        /SUN display day/night/twilight as background colors.
        COLOR=clr Plot color (set to black by /SUN).
        LONG=lng, LAT=lat = observer location for sun colors.
        ZONE=hrs Hours ahead of GMT (def=0). Ex: zone=-4 for EDT.

Outputs

---

Common Blocks

---

      js_com

Notes

---

      Notes: Julian seconds are seconds after 0:00 1 Jan 2000.
        See also dt_tm_tojs(), dt_tm_fromjs(), ymds2js(), js2ymds.

Modification History

---

      R. Sterner 1994 Mar 30
      R. Sterner, 1994 May 17 --- Added common js_com.
      R. Sterner, 1996 Sep 16 --- Added sun colors.
      R. Sterner, 1998 Jan 15 --- Dropped use of !d.n_colors.
      R. Sterner, 1998 Feb 5 --- Added XTHICK, YTHICK, CHARTHICK.
      R. Sterner, 1998 Aug 25 --- Fixed bug with the MAX_VALUE keyword.
      R. Sterner, 1999 Sep 23 --- Returned JS for major and minor time ticks.
      R. Sterner, 2000 Jun 23 --- Added LSHIFT to shift time axis labels.
      R. Sterner, 2005 Apr 18 --- Allowed date/time strings in TRANGE.
      R. Sterner, 2008 Feb 21 --- Added /AXES.
      R. Sterner, 2008 Jun 27 --- Fixed no EXTRA error in save last plot.
      R. Sterner, 2009 Feb 27 --- Allowed time to be date/time strings.
      R. Sterner, 2009 Feb 27 --- Fixed extra not given error.
      R. Sterner, 2011 May 17 --- Converted arrays from () to [].
  Copyright (C) 1994, Johns Hopkins University/Applied Physics Laboratory
  This software may be used, copied, or redistributed as long as it is not
  sold and this copyright notice is reproduced on each copy made. This
  routine is provided as is without any express or implied warranties
  whatsoever. Other limitations apply as described in the file disclaimer.txt.