[mesa-users] Fwd: Using Tioga

Bill Paxton paxton at kitp.ucsb.edu
Sun Oct 9 10:02:30 EDT 2011

Hi Roni,

Good to hear from you!

On Oct 9, 2011, at 2:19 AM, Roni Waldman wrote:

> Obviously I'm doing something basically wrong.

you need to use the "tioga" command instead of just plain "ruby"
if the install worked okay, you should be able to get a brief "help"
just by typing tioga at the command line.  It outputs the following.
Let me know if you have problems.


/Users/bpaxton/mesa: tioga

This program is a command line interface for the open-source tioga kernel.
The tioga kernel is for creating figures and plots using Ruby, PDF, and TeX.
Following is a brief description of the tioga command line options.
For more information, visit http://theory.kitp.ucsb.edu/~paxton/tioga.html.

Before any command line information is processed, tioga runs ~/.tiogainit if it exists.
   The primary use of this file is to set your default pdf viewer command (see below).

If there are no command line arguments, or the argument is -h, this help info is output.

Otherwise, the command line should start with a tioga file name (with extension .rb).
    Since the extension is known, you can skip typing it if you like.

The remainder of the command line should consist of an optional series of control commands
   followed by a figure command.

Any control commands are done after ~/.tiogainit and before the figure file is loaded.
    -r file      runs the file (using Ruby's require method).
    -C dir       changes the working directory.
                 If there is no -C command, tioga changes the working directory to the
                 location of the figure file .
    -v           prints version information.

The figure command comes last and should be one of these:
    -l           output a list of the defined figures by number and name.
    -<num>       make and show figure with index equal <num> (0 <= num < num_figures).
    -m <figs>    make PDFs without showing them in the viewer.
    -s <figs>    make and show PDFs, each in a separate viewer window.
    -p <figs>    make PDFs and show the portfolio as a multi-page document.

If the figure command is omitted, then it defaults to -0.

If <figs> is omitted, then tioga does all the figures defined in the file
    ordered by their definition index numbers.

Otherwise, <figs> must be either
    a defined figure name (as supplied to def_figure in the tioga file), or
    a valid ruby array index number for a figure (can be negative), or
    a valid ruby range specification selecting a sequence of figures, or
    a space-less, comma-separated list of figure indices and ranges.

    For example, -s Plot1 makes and shows the pdf for the figure named Plot1,
    and -p 5,0..3,-1 makes a portfolio with the figure having index 5 on page 1,
    followed by pages showing the figures with indices 0, 1, 2, 3, and -1.

The viewer for showing PDFs is specified by the $pdf_viewer variable in tioga.
    The default value can be set by creating a .tiogainit file in your home directory.
    The .tiogainit file is run before any command line options are processed.
    Your current setting for $pdf_viewer is repreview.
    To change it, edit ~/.tiogainit to add the line $pdf_viewer = 'my viewer command'.
    The command tioga uses to show a pdf is $pdf_viewer + ' ' + full_PDF_filename.
    You can use the -e control command to try a different viewer setting
    by doing the $pdf_viewer assignment from the command line.

More information about the Mesa-users mailing list