Explore LaTeX and Syntax Highlighting with Scilab

0
343
scilab

85-88_Scilab June 2015

This article, the last of a four-part series on Scilab, takes a look at LaTeX and syntax highlighting with Scilab. It is aimed at readers interested in technical computation.

Scilab (http://www.scilab.org) is open source software for numerical computation with a syntax similar to MathWorks’ MATLAB. The first part of this article is about the use of LaTeX with Scilab, and the second concerns the keywords and how to use them to build a syntax highlighting file for GNU Emacs and Vim. All the code presented here has been tested with Scilab 5.5.1 under Linux Mint 17 Xfce. Since the full code is too long for a printed article, it’s freely (as in freedom and in beer) available at https://github.com/astonfe/scilab

LaTeX on a plot
Version 5.2 is the first version of Scilab in which it is possible to use LaTeX. The rendering engine is based on JLaTeXMath (see Reference 1), a fork of JMathTeX (Reference 2) which is a Java library for the mathematical mode of LaTeX. It’s not necessary to install LaTeX to use it with Scilab. Let’s consider the plot shown in Figure 1, which shows two bell-shaped curves: the witch of Agnesi (Reference 3) and the function of Gauss. This plot has seven textual parts:
1. Title. The syntax is: title(“$this-is-the-title$”,”color”,”color-name”). First, it’s necessary to consider that a text written in LaTeX must be included between two ‘$’ symbols. In this example, the full title is written in the colour blue. Two or more colours are possible by adding the LaTeX command \textcolor. On the plot, I can see the first part written in blue and the second in black. If I put the mouse on the LaTeX code, SciNotes, the built-in editor shows, an all-black preview (Figure 2), while the blue part is not visible.
2. X axis label. The syntax is very easy: xlabel(“$this-is-the-label$”).
3. Y axis label. The syntax with ylabel is the same as in the X axis.
4. X ticks labels. In this example, labels are defined as strings in the vector labx. Using x_ticks.labels within a loop, I can put each label on the plot. The syntax is: x_ticks.labels=”$some-latex-here”+labx+”$”.
5. Y ticks labels. In this example, they are numbers in a range between 0 and 1. The syntax is: y_ticks.labels=”$some-latex-here”+string(laby)+”$” If laby=string(0:0.1:1), the syntax is the same as in the X axis.
6. Legend. This syntax is a bit long: legends([“$first-row-text$”;”$second-row-text$”],[first-row-color-number,second-row-color-number],with_box=%f,opt=1). The option with_box can be %f (false) or %t (true) and opt is an integer in the range from 1 to 6.
7. Two integrals under the curves. Another example of an easy syntax: xstring(x-position,y-position,”$some-latex-here$”). The area under the witch of Agnesi is equal to p, or p/2 under the grey part. In general, the area between the curve and the X axis is equal to 4 a2 p (in the example shown, a=1/2).
The full code for this example agnesi.sce is available on GitHub.

Figure 1
Figure 1: The witch of Agnesi and the function of Gauss
Figure 2
Figure 2: SciNotes preview

From Scilab to LaTeX
In the May 2015 issue of OSFY, on page 103, there is a ribbon plot that shows one absorbance spectrum measured at eight different times. The data matrix is composed of eight columns and 23 rows. I can export this matrix directly to LaTeX using the function prettyprint. For the first four rows, the result is shown in the following code (the remaining rows are replaced by the dots):

${\begin{pmatrix}0&0&0&0&0&0&0&0\cr 0.03&0.04&0.05&0.03&0.1&0.154&0.138&0.143\cr
0.06&0.08&0.11&0.11&0.24&0.3&0.27&0.28\cr 0.09&0.11&0.16&0.18&0.42&0.48&0.
6&0.46\cr ... \end{pmatrix}}$

Another way is to print the matrix in a graphic window with xstring(0,0,prettyprint(data)), as shown in Figure 3.

It’s also possible to use Scilab as an almost automatic converter of tables from xls (via LibreOffice Calc) to LaTeX. The following code is composed of four parts: read the data from an xls table (text and numbers), get the maximum width of each column, print the column headers, and then print the data values. The caption and the tabular alignments are the only code rows that must be settled by hand. The original xls table is shown in Figure 4 (top); the output on Scilab Console is a table in LaTeX code that is fully formatted, as shown in Figure 4 (bottom). The data has been taken from Reference 4.

clear;
sheets=readxls(uigetfile(“*.xls”));
data=sheets(1);
typeof(data);
data.text;
data.value;
data=string(data);
[nr,nc]=size(data);
// Max width of each column
w=zeros(nc,1);
for i=1:nc
w(i)=max(length(data(:,i)));
end
printf(msprintf(“\\\\begin{table}[htb]”)+”\n”..
+msprintf(“\\\\caption{Physical properties of some n-alkanes.}”)+”\n”..
+msprintf(“\\\\centering”)+”\n”..
+msprintf(“\\\\begin{tabular}{l|l|r|r|r}”)+”\n”);
// Columns headers
for i=1:nc
printf(“%”+string(w(i))+”s”,data(1,i));
if i<nc then printf(“ & “);
end
end
printf(“ \\\\”+”\n”+”\\hline”+”\n”);
// Data values
for i=2:nr
for j=1:nc
printf(“%”+string(w(j))+”s”,data(i,j));
if j<nc then printf(“ & “);
end
end
printf(“ \\\\”+”\n”);
end
printf(+msprintf(“\\\\end{tabular}”)+”\n”..
+msprintf(“\\\\end{table}”)+”\n”);
Figure 3
Figure 3: A data matrix in Latex

Keywords

The keywords of Scilab fall into five categories: primitives, commands, variables, functions and xcos functions. In my Scilab installation, five toolboxes — GUI Builder, IPT3, JSON, NaN and Quapro — are present, apart from some other dependencies that got automatically installed. The function getscilabkeywords returns a list with all the Scilab keywords already categorised.

clear;
list_all=getscilabkeywords();
write(“1_primitives.txt”,list_all(1));
write(“2_commands.txt”,list_all(2));
write(“3_variables.txt”,list_all(3));
write(“4_functions.txt”,list_all(4));
write(“5_xcosfuns.txt”,list_all(5));

Now I have five text files. But there is a small problem. Some keywords are present in more than one file – the keywords extraction is not really perfect, so some deletions are necessary. The following keywords are removed from the functions file:

// Also present in primitives
datatipManagerMode
datatipMove
datatipSetOrientation
datatipSetStyle
// Also present in commands
apropos
help
// Also present in xcosfuns
lincos
scicos_simulate
steadycos
block_parameter_error
find_scicos_version
fixedpointgcd
get_scicos_version
initial_scicos_tables
returntoscilab
scicos_getvalue
scicos_workspace_init
with_modelica_compiler

Finally, I have five text files without any overlap: primitives with 1193 keywords, commands with 29 keywords, variables with 94 keywords, functions with 2462 keywords and xcosfuns with 12 keywords. The total is equal to 3790 keywords.

Figure 4
Figure 4: A table input (xls, top) and output (latex, bottom)

GNU Emacs
The keywords in each text file are sorted first by length and then alphabetically. Then it’s necessary to add the quotes before and after each keyword, merge every four lines (to reduce the number of rows) and add some Emacs Lisp code. A short example is given by the commands:

(setq scilab-commands ‘(
“endfunction” “continue” “function” “apropos”
“elseif” “resume” “return” “select”
“abort” “break” “catch” “clear”
“pause” “while” “case” “else”
“exit” “help” “quit” “then”
“what” “clc” “end” “for”
“pwd” “try” “who” “do”
“if”
))

Each keyword category is then submitted to GNU Emacs in the following order: scilab-xcosfuns, scilab-functions, scilab-primitives, scilab-commands, scilab-variables. Some modifications to the syntax table are also necessary to specify the comments highlighting and that some characters can be a keyword or a part of a keyword:

(modify-syntax-entry ?\/ “. 12b” synTable)
(modify-syntax-entry ?\n “> b” synTable)
(modify-syntax-entry ?_ “w” synTable)
(modify-syntax-entry ?! “w” synTable)

As a result, I have the Scilab code highlighted with the default colours: five colours for the keywords, one colour for the strings and one colour for the comments. The default colours are quite different from each other, so further improvements are not necessary. Now all the keywords are recognised without any error. Last, add (require ‘scilab-mode) to your dotemacs file. This syntax highlighting file for GNU Emacs has been made following the notes written by Xah Lee (see Reference 5). The full scilab-mode.el code is available on GitHub.

Vim
In the case of Vim, the keywords in each file are sorted only alphabetically, which is not necessary. I can also leave the keywords in the order in which they were originally extracted. Then merge every four lines (to reduce the number of rows) and add some Vim script code. Even in this case, a short example is given by the commands:

syn keyword sciCommands abort apropos break case
syn keyword sciCommands catch clc clear continue
syn keyword sciCommands do else elseif end
syn keyword sciCommands endfunction exit for function
syn keyword sciCommands help if pause pwd
syn keyword sciCommands quit resume return select
syn keyword sciCommands then try what while
syn keyword sciCommands who

Now it’s necessary to specify that some characters can be a keyword or a part of a keyword:

setlocal iskeyword+=!-!
setlocal iskeyword+=$-$
setlocal iskeyword+=%-%

Last, some Vim script code about the colours is added. As a result, I have the Scilab code highlighted with seven custom colours:

hi Operator guifg=#0000CD “ Medium blue
hi Conditional guifg=#DC143C “ Crimson
hi Statement guifg=#FF8C00 “ Dark orange
hi Function guifg=#1E90FF “ Dodger blue
hi Label guifg=#D2B48C “ Tan
hi String guifg=#808080 “ Gray
hi Comment guifg=#3CB371 “ Medium sea green

HiLink sciPrimitives Operator
HiLink sciCommands Conditional
HiLink sciVariables Statement
HiLink sciFunctions Function
HiLink sciXcosfuns Label

My syntax highlighting file for Vim is partially based on those written by Vaclav Mocek (see Reference 6) and Patricio Toledo (Reference 7). The full scilab.vim code is available on GitHub.
Scilab has some interesting LaTeX capabilities about plots and data management. A syntax highlighting file is fairly easy to build for GNU Emacs and Vim. It’s easy also for jEdit (Java based and cross-platform) and Notepad++ (Windows only). The interaction between Scilab and GNU Emacs, in a manner similar to ESS for R, is possible but does not really interest me, so I haven’t explored it yet. This article is the last of a series of four articles about Scilab, but I do think that, “Scilab is a rare gem that is waiting to be discovered more broadly”, as stated by Raphaël Auphan, the CEO of Scilab (see Reference 8).

References
[1] http://forge.scilab.org/index.php/p/jlatexmath, last visited on 25/04/2015.
[2] http://jmathtex.sourceforge.net, last visited on 25/04/2015.
[3] http://en.wikipedia.org/wiki/Witch_of_Agnesi, last visited on 25/04/2014.
[4] Fusco, Bianchetti, Rosnati, Chimica organica (Organic chemistry), vol. 1, Guadagni, Milan, 1980.
[5] http://ergoemacs.org/emacs/elisp_syntax_coloring.html, last visited on 25/04/2014.
[6] http://www.vim.org/scripts/script.php?script_id=1137, last visited on 25/04/2014.
[7] http://www.vim.org/scripts/script.php?script_id=396, last visited on 25/04/2014.
[8] http://www.scilab-enterprises.com/en/company/news/releases/20150409, last visited on 25/04/2014.

LEAVE A REPLY

Please enter your comment!
Please enter your name here