logo
Free, unlimited AI code reviews that run on commit
git-lrc git-lrc GitHub Install Now We'd appreciate a star git-lrc - Free, unlimited AI code reviews that run on commit | Product Hunt git-lrc - Free, unlimited AI code reviews that run on commit | Product Hunt

xtide - Harmonic tide clock and tide predictor (interactive client)

Configuration

       Unless a configuration file /etc/xtide.conf is supplied, you must set the environment variable HFILE_PATH
       to point to the harmonics files that should have been installed along with the xtide program.  Example:
              export HFILE_PATH=/usr/local/share/xtide/harmonics.tcd
       If  a  configuration file is used, the first line should consist of the colon-separated list of harmonics
       files (e.g. the HFILE_PATH line above without the "export HFILE_PATH=" part).  The  environment  variable
       takes precedence over the configuration file.

       If the optional World Vector Shoreline files have been installed, the path to those files can be supplied
       in the WVS_DIR environment variable or as the second line of the configuration file.

       Set  the  environment  variable  XTIDE_DEFAULT_LOCATION to the name of your favorite place if you want to
       skip the location-choosing step.

Description

       XTide  is a package that provides tide and current predictions in a wide variety of formats. Graphs, text
       listings, and calendars can be generated, or a tide clock can be provided on your desktop.

       XTide can work with X-windows, plain text terminals, or the web. This is accomplished with three separate
       programs: the interactive interface (xtide), the non-interactive or command line  interface  (tide),  and
       the web interface (xttpd).

       xtide  is the interactive X-windows client for XTide 2.  Although in reality it accepts many command line
       options, you should not need to use them; everything can be done interactively.  Just run xtide and point
       and click your way to whatever you need.  If you get stuck, click on a `?' button for on-line help.

       For a complete discussion of the command line options and  a  detailed  explanation  of  the  interactive
       interface, please see the verbose documentation at http://www.flaterco.com/xtide/.

Name

       xtide - Harmonic tide clock and tide predictor (interactive client)

Notes

       If  XTide  is  built  with  Xaw3dXft,  font  names  given  to  XTide  must be in fontconfig format (e.g.,
       "Helvetica-10"), rather than the traditional XLFD (e.g., "-*-helvetica-*-r-*-*-10-*-*-*-*-*-*-*").  Also,
       Xaw3dXft does not return errors if there are problems with a font name; it  just  loads  a  default  font
       instead.

Options

-b``YYYY-MM-DDHH:MM''
              Specify the begin (start) time for predictions using the  ISO  8601  compliant  format  YYYY-MM-DD
              HH:MM, where hours range from 00 to 23.  The timestamp is in the local time zone for the location,
              or  in  UTC  if the -z setting is engaged.  If clock mode is selected or if no -b is supplied, the
              current time will be used.

       -bccolor
              Background color of buttons (default gray80).

       -bgcolor
              Background color for text windows and location chooser (default white).

       -cby|n
              Select whether or not tide clocks should be created with buttons (default n).

       -cccolor
              Color of dots indicating current stations in the location chooser (default rgb:00/A0/00).

       -chpixels
              Initial height for tide clocks (default 312 pixels).

       -cwpixels
              Initial width for tide clocks (default 84 pixels).

       -dccolor
              Daytime background color in tide graphs (default SkyBlue).

       -Dccolor
              Color of datum line in tide graphs (default white).

       -df``format-string''strftime(3) style format string for printing dates (default %Y-%m-%d).

       -display``Xdisplay''
              Specify the X display, e.g. "quake:0.0".  This overrides the DISPLAY environment variable.

       -eccolor
              Foreground in tide graphs during outgoing tide (default SeaGreen).

       -ely|n
              Select whether or not to draw datum and middle-level lines in tide graphs (default n).

              The National Ocean Service (NOS) defines both Mean Sea Level (MSL) and Mean Tide  Level  (MTL)  in
              terms  of averages taken over observations.  The middle-level line is drawn at the midpoint of the
              theoretical tidal range,  which  usually  corresponds  to  the  mathematical  mean  level  of  the
              predictions.   This  approximates  both  MSL  and  MTL,  but,  strictly speaking, is equivalent to
              neither.  Moreover, subordinate station offsets may shift the actual mean so  that  it  no  longer
              falls  at  the  midpoint  of  the  tidal  range.  The datum line is drawn at the zero level of the
              predictions, which usually corresponds to the station's benchmark, but this too  can  be  rendered
              inaccurate by subordinate station offsets.

       -empSsMm
              Events  to  suppress (p = phase of moon, S = sunrise, s = sunset, M = moonrise, m = moonset), or x
              to suppress none.  E.g, to suppress all sun and moon events, set eventmask to the value pSsMm.

       -fccolor
              Foreground in tide graphs during incoming tide (default Blue).

       -fey|n
              Select whether or not to prefer flat map to round globe location chooser (default n).

       -fgcolor
              Color of text and other notations (default black).

       -fnfont
              Font used for button labels and verbiage  in  text  windows  (default  as  incoming  from  X11  or
              libXaw3dXft).  See NOTES.

       -gaaspect
              Initial aspect for tide graphs and clocks (default 1.0).  This controls not the width or height of
              the window but rather the relative scaling of the X and Y axes in the plot of the tide curve.

       -geometry``±XOFF±YOFF''
              Specify  a  position  for  the window corresponding to the first use of -l.  (Width and height are
              controlled by different settings.)

       -gffont
              Font used in graphs and clocks in interactive client (default "embedded").  Does not  affect  SVG-
              format output.  See NOTES.

       -ghpixels
              Initial height for tide graphs (default 312 pixels).

       -gllongitude
              Initial  center  longitude for location chooser.  Valid values are -180 -150 -120 -90 -60 -30 0 30
              60 90 120 150 and 360.  360 (the default) will pick the longitude with the most tide stations.

       -gsd|l|s
              Style of graphs and clocks.  Valid values: d (default), l (line), s (semitransparent).

       -gty|n
              Select whether or not to label tenths of units in tide graphs (default n).

       -gwpixels
              Initial width for tide graphs (default 960 pixels).

       -hf``format-string''strftime(3) style format string for printing hour labels on time axis (default %l).

       -iny|n
              Select whether or not to use inferred values for some constituents (default n).   For  expert  use
              only.

       -l``locationname''
              Specify  a  location for tide predictions. When given to the interactive client, this causes it to
              start a tide clock for the specified location instead of launching a location chooser on  startup.
              This  is  useful for starting a tide clock automatically when you log on. Multiple uses of -l will
              result in multiple tide clocks.

       -lwpixels
              Width of line in graph styles l and s (default 2.5 pixels).

       -ma|g|k|m|p|r
              Specify mode to be about, graph, clock, medium rare, plain, or raw.  The default is clock.

       -mccolor
              Color of mark line in graphs (default red).

       -Mccolor
              Color of middle-level line in tide graphs (default yellow).

       -mffont
              Monospace font used for location list, text predictions, help windows and about mode text (default
              "-misc-fixed-medium-r-normal--13-100-100-100-c-70-iso8859-1"     (without     libXaw3dXft)      or
              "LiberationMono-12" (with libXaw3dXft)).  See NOTES.

       -ml[-]N.NN(ft|m|kt)
              Specify  an  initial  mark  level to be used in prediction windows launched from the command line.
              The predictions will include the times when the tide level crosses the mark.  The mark level  also
              can be specified or changed using the Options menu.  Not supported in clock mode.  Does not affect
              windows that are launched from the location chooser.  Example usage: -ml -0.25ft

       -nccolor
              Nighttime background color in tide graphs (default DeepSkyBlue).

       -ouy|n
              Select whether or not to print numbers with no ft/m/kt (default n).

       -tccolor
              Color of dots indicating tide stations in the location chooser (default red).

       -tf``format-string''strftime(3) style format string for printing times (default %l:%M %p %Z).

       -tly|n
              Select whether or not to draw depth lines on top of the tide graph (default n).

       -toopacity
              Opacity of the fill in graph style s (semitransparent) (default 0.65).

       -uft|m
              Preferred units of length (default no preference).

       -v     Print version string and exit.

       -zy|n Select whether or not to coerce all time zones to UTC (default n).

See Also

tide(1), xttpd(8), http://www.flaterco.com/xtide/.

XTide 2                                            2014-05-04                                           xtide(1)

Synopsis

xtide  [-b``YYYY-MM-DDHH:MM''] [-bccolor] [-bgcolor] [-cby|n] [-cccolor] [-chpixels] [-cwpixels]
       [-dccolor] [-Dccolor] [-df``format-string''] [-display``Xdisplay'']  [-eccolor]  [-ely|n]  [-empSsMm]  [-fccolor]  [-fey|n] [-fgcolor] [-fnfont] [-gaaspect] [-geometry``±XOFF±YOFF''] [-gffont]
       [-ghpixels] [-gllongitude] [-gsd|l|s] [-gty|n] [-gwpixels] [-hf``format-string'']  [-iny|n]  [-l``locationname'']   [-lwpixels]   [-ma|g|k|m|p|r]  [-mccolor]  [-Mccolor]  [-mffont]  [-ml[-]N.NN(ft|m|kt)] [-nccolor] [-ouy|n] [-tccolor] [-tf``format-string''] [-tly|n] [-toopacity]  [-uft|m] [-v] [-zy|n]

See Also