File: maxima_70.html

package info (click to toggle)
maxima 5.47.0-9
links: PTS
area: main
in suites: forky, sid
size: 193,104 kB
sloc: lisp: 434,678; fortran: 14,665; tcl: 10,990; sh: 4,577; makefile: 2,763; ansic: 447; java: 328; python: 262; perl: 201; xml: 60; awk: 28; sed: 15; javascript: 2
file content (382 lines) | stat: -rw-r--r-- 21,844 bytes
parent folder | download | duplicates (2)
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<!-- Created by GNU Texinfo 5.1, http://www.gnu.org/software/texinfo/ -->
<head>
<title>Maxima 5.47.0 Manual: Gnuplot Options</title>

<meta name="description" content="Maxima 5.47.0 Manual: Gnuplot Options">
<meta name="keywords" content="Maxima 5.47.0 Manual: Gnuplot Options">
<meta name="resource-type" content="document">
<meta name="distribution" content="global">
<meta name="Generator" content="makeinfo">
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<link href="maxima_toc.html#Top" rel="start" title="Top">
<link href="maxima_423.html#Function-and-Variable-Index" rel="index" title="Function and Variable Index">
<link href="maxima_toc.html#SEC_Contents" rel="contents" title="Table of Contents">
<link href="maxima_65.html#Plotting" rel="up" title="Plotting">
<link href="maxima_71.html#Gnuplot_005fpipes-Format-Functions" rel="next" title="Gnuplot_pipes Format Functions">
<link href="maxima_69.html#Plotting-Options" rel="previous" title="Plotting Options">
<style type="text/css">
<!--
a.summary-letter {text-decoration: none}
blockquote.smallquotation {font-size: smaller}
div.display {margin-left: 3.2em}
div.example {margin-left: 3.2em}
div.indentedblock {margin-left: 3.2em}
div.lisp {margin-left: 3.2em}
div.smalldisplay {margin-left: 3.2em}
div.smallexample {margin-left: 3.2em}
div.smallindentedblock {margin-left: 3.2em; font-size: smaller}
div.smalllisp {margin-left: 3.2em}
kbd {font-style:oblique}
pre.display {font-family: inherit}
pre.format {font-family: inherit}
pre.menu-comment {font-family: serif}
pre.menu-preformatted {font-family: serif}
pre.smalldisplay {font-family: inherit; font-size: smaller}
pre.smallexample {font-size: smaller}
pre.smallformat {font-family: inherit; font-size: smaller}
pre.smalllisp {font-size: smaller}
span.nocodebreak {white-space:nowrap}
span.nolinebreak {white-space:nowrap}
span.roman {font-family:serif; font-weight:normal}
span.sansserif {font-family:sans-serif; font-weight:normal}
ul.no-bullet {list-style: none}
body {color: black; background: white;  margin-left: 8%; margin-right: 13%;
      font-family: "FreeSans", sans-serif}
h1 {font-size: 150%; font-family: "FreeSans", sans-serif}
h2 {font-size: 125%; font-family: "FreeSans", sans-serif}
h3 {font-size: 100%; font-family: "FreeSans", sans-serif}
a[href] {color: rgb(0,0,255); text-decoration: none;}
a[href]:hover {background: rgb(220,220,220);}
div.textbox {border: solid; border-width: thin; padding-top: 1em;
    padding-bottom: 1em; padding-left: 2em; padding-right: 2em}
div.titlebox {border: none; padding-top: 1em; padding-bottom: 1em;
    padding-left: 2em; padding-right: 2em; background: rgb(200,255,255);
    font-family: sans-serif}
div.synopsisbox {
    border: none; padding-top: 1em; padding-bottom: 1em; padding-left: 2em;
    padding-right: 2em; background: rgb(255,220,255);}
pre.example {border: 1px solid rgb(180,180,180); padding-top: 1em;
    padding-bottom: 1em; padding-left: 1em; padding-right: 1em;
    background-color: rgb(238,238,255)}
div.spacerbox {border: none; padding-top: 2em; padding-bottom: 2em}
div.image {margin: 0; padding: 1em; text-align: center}
div.categorybox {border: 1px solid gray; padding-top: 1em; padding-bottom: 1em;
    padding-left: 1em; padding-right: 1em; background: rgb(247,242,220)}
img {max-width:80%; max-height: 80%; display: block; margin-left: auto; margin-right: auto}

-->
</style>

<link rel="icon" href="figures/favicon.ico">
<script src="https://polyfill.io/v3/polyfill.min.js?features=es6>"></script>
<script id="MathJax-script" async src="https://cdn.jsdelivr.net/npm/mathjax@3/es5/tex-mml-chtml.js"></script>
</head>

<body lang="en" bgcolor="#FFFFFF" text="#000000" link="#0000FF" vlink="#800080" alink="#FF0000">
<a name="Gnuplot-Options"></a>
<div class="header">
<p>
Next: <a href="maxima_71.html#Gnuplot_005fpipes-Format-Functions" accesskey="n" rel="next">Gnuplot_pipes Format Functions</a>, Previous: <a href="maxima_69.html#Plotting-Options" accesskey="p" rel="previous">Plotting Options</a>, Up: <a href="maxima_65.html#Plotting" accesskey="u" rel="up">Plotting</a> &nbsp; [<a href="maxima_toc.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="maxima_423.html#Function-and-Variable-Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="Gnuplot-Options-1"></a>
<h3 class="section">12.5 Gnuplot Options</h3>

<p>There are several plot options specific to gnuplot.  All of them consist
of a keyword (the name of the option), followed by a string that should
be a valid gnuplot command, to be passed directly to gnuplot.  In most
cases, there exist a corresponding plotting option that will produce a
similar result and whose use is more recommended than the gnuplot
specific option.
</p>
<a name="gnuplot_005fterm"></a><a name="Item_003a-Plotting_002fdefvr_002fgnuplot_005fterm"></a><dl>
<dt><a name="index-gnuplot_005fterm"></a>Plot option: <strong>gnuplot_term</strong> <em>[gnuplot_term, <var>terminal_name</var>]</em></dt>
<dd>
<p>Sets the output terminal type for gnuplot. The argument <var>terminal_name</var>
can be a string or one of the following 3 special symbols
</p><ul>
<li> <strong>default</strong> (default value)

<p>Gnuplot output is displayed in a separate graphical window and the
gnuplot terminal used will be specified by the value of the option
<code><a href="#gnuplot_005fdefault_005fterm_005fcommand">gnuplot_default_term_command</a></code>.
</p>
</li><li> <strong>dumb</strong>

<p>Gnuplot output is saved to a file <code>maxout_xxx.gnuplot</code> using &quot;ASCII
art&quot; approximation to graphics. If the option <code><a href="#gnuplot_005fout_005ffile">gnuplot_out_file</a></code> is
set to <var>filename</var>, the plot will be saved there, instead of the
default <code>maxout_xxx.gnuplot</code>. The settings for the &ldquo;dumb&rdquo; terminal of
Gnuplot are given by the value of option
<code><a href="#gnuplot_005fdumb_005fterm_005fcommand">gnuplot_dumb_term_command</a></code>. If option <code><a href="maxima_69.html#run_005fviewer">run_viewer</a></code> is set
to true and the plot_format is <code>gnuplot</code> that ASCII representation
will also be shown in the Maxima or Xmaxima console.
</p>
</li><li> <strong>ps</strong>

<p>Gnuplot generates commands in the PostScript page description language.
If the option <code><a href="#gnuplot_005fout_005ffile">gnuplot_out_file</a></code> is set to <var>filename</var>, gnuplot
writes the PostScript commands to <var>filename</var>.  Otherwise, it is
saved as <code>maxplot.ps</code> file. The settings for this terminal are given by the value of the option <code><a href="#gnuplot_005fdumb_005fterm_005fcommand">gnuplot_dumb_term_command</a></code>.
</p>
</li><li> A string representing any valid gnuplot term specification

<p>Gnuplot can generate output in many other graphical formats such as png,
jpeg, svg etc. To use those formats, option <code>gnuplot_term</code> can be
set to any supported gnuplot term name (which must be a symbol) or even a
full gnuplot term specification with any valid options (which must be a string).  For
example <code>[gnuplot_term, png]</code> creates output in PNG (Portable
Network Graphics) format while <code>[gnuplot_term, &quot;png size
1000,1000&quot;]</code> creates PNG of 1000 x 1000 pixels size.  If the option
<code><a href="#gnuplot_005fout_005ffile">gnuplot_out_file</a></code> is set to <var>filename</var>, gnuplot writes the
output to <var>filename</var>.  Otherwise, it is saved as
<code>maxplot.<var>term</var></code> file, where <var>term</var> is gnuplot terminal
name.
</p></li></ul>

<div class=categorybox>
Categories:<a href="maxima_424.html#Category_003a-Plotting">Plotting</a>
&middot;</div></dd></dl>

<a name="gnuplot_005fout_005ffile"></a><a name="Item_003a-Plotting_002fdefvr_002fgnuplot_005fout_005ffile"></a><dl>
<dt><a name="index-gnuplot_005fout_005ffile"></a>Plot option: <strong>gnuplot_out_file</strong> <em>[gnuplot_out_file, <var>file_name</var>]</em></dt>
<dd>
<p>It can be used to replace the default name for the file that contains
the commands that will interpreted by gnuplot, when the terminal is set
to <code>default</code>, or to replace the default name of the graphic file
that gnuplot creates, when the terminal is different from
<code>default</code>. If it contains one or more slashes, &ldquo;/&rdquo;, the name of
the file will be left as it is; otherwise, it will be appended to the
path of the temporary directory. The complete name of the files created
by the plotting commands is always sent as output of those commands so
they can be seen if the command is ended by semi-colon.
</p>
<p>When used in conjunction with the <code><a href="#gnuplot_005fterm">gnuplot_term</a></code> option, it can be
used to save the plot in a file, in one of the graphic formats supported
by Gnuplot. To create PNG, PDF, Postscript or SVG, it is easier to use
options <code><a href="maxima_69.html#png_005ffile">png_file</a></code>, <code><a href="maxima_69.html#pdf_005ffile">pdf_file</a></code>, <code><a href="maxima_69.html#ps_005ffile">ps_file</a></code>,
or <code><a href="maxima_69.html#svg_005ffile">svg_file</a></code>.
</p>
<div class=categorybox>
Categories:<a href="maxima_424.html#Category_003a-Plotting">Plotting</a>
&middot;</div></dd></dl>

<a name="gnuplot_005fscript_005ffile"></a><a name="Item_003a-Plotting_002fdefvr_002fgnuplot_005fscript_005ffile"></a><dl>
<dt><a name="index-gnuplot_005fscript_005ffile"></a>Plot option: <strong>gnuplot_script_file</strong> <em>[gnuplot_script_file, <var>file_name_or_function</var>]</em></dt>
<dd>
<p>Creates a plot with <code>plot2d</code>, <code>plot3d</code>, <code>mandelbrot</code> or
<code>julia</code> using the <code>gnuplot</code> <code><a href="maxima_69.html#plot_005fformat">plot_format</a></code> and saving
the script sent to Gnuplot in the file specified by <var>file_name_or_function</var>.
The value <var>file_name_or_function</var> can be a string or a Maxima function of
one variable that returns a string. If that string corresponds to a
complete file path (directory and file name), the script will be created in
that file and will not be deleted after Maxima is closed; otherwise, the
string will give the name of a file to be created in the temporary directory
and deleted when Maxima is closed.
</p>
<p>In this example, the script file name is set to &ldquo;sin.gnuplot&rdquo;, in the
current directory.
</p>
<div class="example">
<pre class="example">(%i1) plot2d( sin(x), [x,0,2*%pi], [gnuplot_script_file, &quot;./sin.gnuplot&quot;]);

(%o1) [&quot;./sin.gnuplot&quot;]
</pre></div>

<p>In this example, <code>gnuplot_maxout_prt(<var>file</var>)</code> is a function
that takes the default file name, <var>file</var>. It constructs a full file
name for the data file by interpolating a random 8-digit integer with a
pad of zeros into the default file name (&ldquo;maxout&rdquo; followed by the id
number of the Maxima process, followed by &ldquo;.gnuplot&rdquo;). The temporary
directory is determined by <code><a href="maxima_155.html#maxima_005ftempdir">maxima_tempdir</a></code> (it is &ldquo;/tmp&rdquo; in this
example).
</p>
<div class="example">
<pre class="example">(%i1) gnuplot_maxout_prt(file) := block([beg,end],
        [beg,end] : split(file,&quot;.&quot;),
        printf(false,&quot;~a_~8,'0d.~a&quot;,beg,random(10^8-1),end)) $

(%i2) plot2d( sin(x), [x,0,2*%pi], [gnuplot_script_file, gnuplot_maxout_prt]);

(%o2) [&quot;/tmp/maxout68715_09606909.gnuplot&quot;]
</pre></div>

<p>By default, the script would have been saved in a file named
<code>maxoutXXXXX.gnuplot</code> (XXXXX=68715 in this example) in the temporary
directory. If the print statement in function <code>gnuplot_maxout_prt</code>
above included a directory path, the file would have been saved in that
directory rather than in the temporary directory.
</p>
<div class=categorybox>
Categories:<a href="maxima_424.html#Category_003a-Plotting">Plotting</a>
&middot;</div></dd></dl>

<a name="gnuplot_005fpm3d"></a><a name="Item_003a-Plotting_002fdefvr_002fgnuplot_005fpm3d"></a><dl>
<dt><a name="index-gnuplot_005fpm3d"></a>Plot option: <strong>gnuplot_pm3d</strong> <em>[gnuplot_pm3d, <var>value</var>]</em></dt>
<dd>
<p>With a value of <code>false</code>, it can be used to disable the use of PM3D
mode, which is enabled by default.
</p>
<div class=categorybox>
Categories:<a href="maxima_424.html#Category_003a-Plotting">Plotting</a>
&middot;</div></dd></dl>

<a name="gnuplot_005fpreamble"></a><a name="Item_003a-Plotting_002fdefvr_002fgnuplot_005fpreamble"></a><dl>
<dt><a name="index-gnuplot_005fpreamble"></a>Plot option: <strong>gnuplot_preamble</strong> <em>[gnuplot_preamble, <var>string</var>]</em></dt>
<dd>
<p>This option inserts gnuplot commands before any other commands sent to
Gnuplot. Any valid gnuplot commands may be used. Multiple commands should
be separated with a semi-colon. See also <code><a href="#gnuplot_005fpostamble">gnuplot_postamble</a></code>.
</p>
<div class=categorybox>
Categories:<a href="maxima_424.html#Category_003a-Plotting">Plotting</a>
&middot;</div></dd></dl>

<a name="gnuplot_005fpostamble"></a><a name="Item_003a-Plotting_002fdefvr_002fgnuplot_005fpostamble"></a><dl>
<dt><a name="index-gnuplot_005fpostamble"></a>Plot option: <strong>gnuplot_postamble</strong> <em>[gnuplot_postamble, <var>string</var>]</em></dt>
<dd>
<p>This option inserts gnuplot commands after other commands sent to
Gnuplot and right before the plot command is sent. Any valid gnuplot
commands may be used. Multiple commands should be separated with a
semi-colon. See also <code><a href="#gnuplot_005fpreamble">gnuplot_preamble</a></code>.
</p>
<div class=categorybox>
Categories:<a href="maxima_424.html#Category_003a-Plotting">Plotting</a>
&middot;</div></dd></dl>

<a name="gnuplot_005fdefault_005fterm_005fcommand"></a><a name="Item_003a-Plotting_002fdefvr_002fgnuplot_005fdefault_005fterm_005fcommand"></a><dl>
<dt><a name="index-gnuplot_005fdefault_005fterm_005fcommand"></a>Plot option: <strong>gnuplot_default_term_command</strong></dt>
<dd><p>[gnuplot_default_term_command, <var>command</var>]
</p>
<p>The gnuplot command to set the terminal type for the default
terminal. It this option is not set, the command used will be: <code>&quot;set term wxt size 640,480 font \&quot;,12\&quot;; set term pop&quot;</code>.
</p>
<div class=categorybox>
Categories:<a href="maxima_424.html#Category_003a-Plotting">Plotting</a>
&middot;</div></dd></dl>

<a name="gnuplot_005fdumb_005fterm_005fcommand"></a><a name="Item_003a-Plotting_002fdefvr_002fgnuplot_005fdumb_005fterm_005fcommand"></a><dl>
<dt><a name="index-gnuplot_005fdumb_005fterm_005fcommand"></a>Plot option: <strong>gnuplot_dumb_term_command</strong></dt>
<dd><p>[gnuplot_dumb_term_command, <var>command</var>]
</p>
<p>The gnuplot command to set the terminal type for the dumb terminal.  It
this option is not set, the command used will be: <code>&quot;set term dumb
79 22&quot;</code>, which makes the text output 79 characters by 22 characters.
</p>
<div class=categorybox>
Categories:<a href="maxima_424.html#Category_003a-Plotting">Plotting</a>
&middot;</div></dd></dl>

<a name="gnuplot_005fpdf_005fterm_005fcommand"></a><a name="Item_003a-Plotting_002fdefvr_002fgnuplot_005fpdf_005fterm_005fcommand"></a><dl>
<dt><a name="index-gnuplot_005fpdf_005fterm_005fcommand"></a>Plot option: <strong>gnuplot_pdf_term_command</strong> <em>[gnuplot_pdf_term_command, <var>command</var>]</em></dt>
<dd>
<p>The gnuplot command to set the terminal type for the PDF
terminal.  If this option is not set, the command used will be: <code>&quot;set term pdfcairo color solid lw 3 size 17.2 cm, 12.9 cm font \&quot;,18\&quot;&quot;</code>. See the gnuplot documentation for more information.
</p>
<div class=categorybox>
Categories:<a href="maxima_424.html#Category_003a-Plotting">Plotting</a>
&middot;</div></dd></dl>

<a name="gnuplot_005fpng_005fterm_005fcommand"></a><a name="Item_003a-Plotting_002fdefvr_002fgnuplot_005fpng_005fterm_005fcommand"></a><dl>
<dt><a name="index-gnuplot_005fpng_005fterm_005fcommand"></a>Plot option: <strong>gnuplot_png_term_command</strong> <em>[gnuplot_png_term_command, <var>command</var>]</em></dt>
<dd>
<p>The gnuplot command to set the terminal type for the PNG terminal.  If
this option is not set, the command used will be:
<code>&quot;set term pngcairo font \&quot;,12\&quot;&quot;</code>. See the gnuplot documentation
for more information.
</p>
<div class=categorybox>
Categories:<a href="maxima_424.html#Category_003a-Plotting">Plotting</a>
&middot;</div></dd></dl>

<a name="gnuplot_005fps_005fterm_005fcommand"></a><a name="Item_003a-Plotting_002fdefvr_002fgnuplot_005fps_005fterm_005fcommand"></a><dl>
<dt><a name="index-gnuplot_005fps_005fterm_005fcommand"></a>Plot option: <strong>gnuplot_ps_term_command</strong> <em>[gnuplot_ps_term_command, <var>command</var>]</em></dt>
<dd>
<p>The gnuplot command to set the terminal type for the PostScript
terminal.  If this option is not set, the command used will be: <code>&quot;set term postscript eps color solid lw 2 size 16.4 cm, 12.3 cm font \&quot;,24\&quot;&quot;</code>. See the gnuplot documentation for <code>set term postscript</code> for
more information.
</p>
<div class=categorybox>
Categories:<a href="maxima_424.html#Category_003a-Plotting">Plotting</a>
&middot;</div></dd></dl>

<a name="gnuplot_005fstrings"></a><a name="Item_003a-Plotting_002fdefvr_002fgnuplot_005fstrings"></a><dl>
<dt><a name="index-gnuplot_005fstrings"></a>Plot option: <strong>gnuplot_strings</strong> <em>[gnuplot_strings, <var>value</var>]</em></dt>
<dd>
<p>With a value of <code>true</code>, all strings used in labels and titles will
be interpreted by gnuplot as &ldquo;enhanced&rdquo; text, if the terminal being used
supports it. In enhanced mode, some characters such as ^ and _ are not
printed, but interpreted as formatting characters. For a list of the
formatting characters and their meaning, see the documentation for enhanced
in Gnuplot. The default value for this option is <code>false</code>, which will
not treat any characters as formatting characters.
</p>
<div class=categorybox>
Categories:<a href="maxima_424.html#Category_003a-Plotting">Plotting</a>
&middot;</div></dd></dl>

<a name="gnuplot_005fsvg_005fbackground"></a><a name="Item_003a-Plotting_002fdefvr_002fgnuplot_005fsvg_005fbackground"></a><dl>
<dt><a name="index-gnuplot_005fsvg_005fbackground"></a>Plot option: <strong>gnuplot_svg_background</strong> <em><br></em></dt>
<dd>
<p>[gnuplot_svg_background, <var>color</var>] <br>
    nognuplot_svg_background
</p>
<p>Specify the background color for SVG image output.
<var>color</var> must be a string which specifies a color name recognized by Gnuplot,
or an RGB triple of the form <code>&quot;#xxxxxx&quot;</code> where <code>x</code> is a hexadecimal digit.
The default value is <code>&quot;white&quot;</code>.
</p>
<p>When the value of <code>gnuplot_svg_background</code> is <code>false</code>,
the background is the default determined by Gnuplot.
At present (April 2023),
the Gnuplot default is to specify the background in SVG output as <code>&quot;none&quot;</code>.
</p>
<p><code>nognuplot_svg_background</code>, specified by itself without a value,
is equivalent to <code>[gnuplot_svg_background, false]</code>.
</p>
<div class=categorybox>
Categories:<a href="maxima_424.html#Category_003a-Plotting">Plotting</a>
&middot;</div></dd></dl>

<a name="gnuplot_005fsvg_005fterm_005fcommand"></a><a name="Item_003a-Plotting_002fdefvr_002fgnuplot_005fsvg_005fterm_005fcommand"></a><dl>
<dt><a name="index-gnuplot_005fsvg_005fterm_005fcommand"></a>Plot option: <strong>gnuplot_svg_term_command</strong> <em>[gnuplot_svg_term_command, <var>command</var>]</em></dt>
<dd>
<p>The gnuplot command to set the terminal type for the SVG
terminal.  If this option is not set, the command used will be:
<code>&quot;set term svg font \&quot;,14\&quot;&quot;</code>. See the gnuplot documentation for
more information.
</p>
<div class=categorybox>
Categories:<a href="maxima_424.html#Category_003a-Plotting">Plotting</a>
&middot;</div></dd></dl>

<a name="gnuplot_005fcurve_005ftitles"></a><a name="Item_003a-Plotting_002fdefvr_002fgnuplot_005fcurve_005ftitles"></a><dl>
<dt><a name="index-gnuplot_005fcurve_005ftitles"></a>Plot option: <strong>gnuplot_curve_titles</strong></dt>
<dd>
<p>This is an obsolete option that has been replaced by <code><a href="maxima_69.html#legend">legend</a></code> described
above.
</p>
<div class=categorybox>
Categories:<a href="maxima_424.html#Category_003a-Plotting">Plotting</a>
&middot;</div></dd></dl>

<a name="gnuplot_005fcurve_005fstyles"></a><a name="Item_003a-Plotting_002fdefvr_002fgnuplot_005fcurve_005fstyles"></a><dl>
<dt><a name="index-gnuplot_005fcurve_005fstyles"></a>Plot option: <strong>gnuplot_curve_styles</strong></dt>
<dd>
<p>This is an obsolete option that has been replaced by <code><a href="maxima_69.html#style">style</a></code>.
</p>
<div class=categorybox>
Categories:<a href="maxima_424.html#Category_003a-Plotting">Plotting</a>
&middot;</div></dd></dl>

<a name="Item_003a-Plotting_002fnode_002fGnuplot_005fpipes-Format-Functions"></a><hr>
<div class="header">
<p>
Next: <a href="maxima_71.html#Gnuplot_005fpipes-Format-Functions" accesskey="n" rel="next">Gnuplot_pipes Format Functions</a>, Previous: <a href="maxima_69.html#Plotting-Options" accesskey="p" rel="previous">Plotting Options</a>, Up: <a href="maxima_65.html#Plotting" accesskey="u" rel="up">Plotting</a> &nbsp; [<a href="maxima_toc.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="maxima_423.html#Function-and-Variable-Index" title="Index" rel="index">Index</a>]</p>
</div>



</body>
</html>