Ctioga is deprecated

As of now (Mon Jan 31 2011), the use of Ctioga is deprecated, in favor of its full rewrite ctioga2. Development had stopped already two years ago. Please use ctioga2, which is now mature enough to serve as a full replacement of Ctioga, but provides much more features, such as XYZ color maps.

You may be interested in this page to help you transition to ctioga2.

The shell doesn’t find ctioga

When you get an error like

bash: ctioga: command not found

It probably means that you did install with HOME_INSTALL but that your $HOME/bin directory is not in your path. Try putting the following in your .bashrc or .zshrc (depending on your shell – use the command ps to know which is yours):

PATH=$HOME/bin:$PATH
export PATH

If it still doesn’t work, you probably had a problem with the installation…

Ruby doesn’t find CTioga/plotmaker

If you get an error of the like

ctioga
/home/test/bin/ctioga:22:in `require’: no such file to load — CTioga/plotmaker (LoadError)
        from /home/test/bin/ctioga:22

This means that ruby doesn’t find the ctioga libraries. Try to add the following line in your shell configuration file (see previous question).

export RUBYLIB=~/lib

How do I include graphics in a LaTeX document ?

The standard method to include documents produced by ctioga is to use the \tiogafigureshow and the other related LaTeX commands found in the tioga.sty file created during Tioga’s installation. It should be in the base directory.

However, starting from ctioga 1.0, you have a much better option. Use the --real-size command-line option, such as

ctioga --real-size 12cmx12cm --math 'exp(x)'

This creates a PDF file of exactly 12cm width and height, which you can include with a standard \includegraphics in your LaTeX document.

I never can remember which command-line I did use to produce a plot…

No problems, ctioga can keep track of it for you. You will find the command-line used as a comment in the Plot.tex file produced and as a creator tag in the PDF file produced (if you used the --mark option). You can view the latter with a tool like pdfinfo or in Acroread’s file properties. The PDF marking behavior is however disabled by default due to the problems linked to the following question. To turn it always on, use

export CTIOGA="--mark" 

in your shell configuration file. Beware, though…

Ctioga fails with weird error messages

This is most probably due to the automatic setting of the creator mark: some internal LaTeX restrictions make it hard to take care of every type of command lines. Try with the --no-mark option.1

1 We hope that this problem has been fixed in recent versions of ctioga (after 1.2).