GP
Section: User Commands (1)
Updated: 10 August 2004
Index
NAME
gp  PARI calculator
SYNOPSIS
gp
[stacksizes
stacksize]
[primelimitp
primelimit]
[emacs]
[ffast]
[qquiet]
[help]
[test]
[texmacs]
[version]
[versionshort]
[ file1 file2 ...]
DESCRIPTION
Invokes the PARIGP calculator, loading the file1, file2, ... (written in the
GP language) on startup. gp is an advanced programmable calculator,
which computes symbolically as long as possible, numerically where needed,
and contains a wealth of numbertheoretic functions (elliptic curves, class
field theory...). It can be programmed with the GP scripting language. Its
basic data types are
 numbers

integers, real numbers, exact rational numbers, algebraic numbers,
padic numbers,
modular integers (integers modulo
n),
complex numbers,
 polynomials, rational functions,

and power series,
 integral binary quadratic forms,

 matrices, vectors,

and lists,
 character strings,

and recursive combinations of these.
OPTIONS
Command line options are availaible in both short form (f) and POSIXlike
(fast). Numeric arguments can be followed by a modifier
k
,
M
or
G
at the user's convenience; in that case the argument is multiplied by 10^3,
10^6, or 10^9 respectively.
 f, fast

Fast start (or factory settings). Do not read
.gprc
(see below) upon startup.
 p, primelimit limit

Upon startup, gp computes a table of small primes used in
numbertheoretic applications. If
primelimit
is set, the table include primes up to that bound instead of the default.
Unreasonably high values will considerably increase startup time. Exceedingly
small values will cause some numbertheoretic functions to fail with the
message "not enough precomputed primes".
 q, quiet

Quiet mode. Don't print headers or history numbers, don't say goodbye.
 s, stacksize limit

Size of gp internal stack allocated on startup. When gp runs out of space, it
interrupts the current computation and raises a
stack overflow
exception. If this occurs frequently, start with a bigger stack. The stack
size can also be
increased from within gp, using
default(parisize,...);
it may be convenient to set
stacksize
from your
.gprc.
Note that computations with a
smaller
stack may be more efficient due to better data locality. Most computations
should need less than 20MB.
 emacs

gp can be run in an
Emacs
shell (see GP User's manual for details). This flag is then required for
smooth interaction with the relevant
Emacs
package (pari.el). It is set automatically by the pari.el package, and will
produce nice display oddities if you set it outside of an
Emacs
session.
 help

print a summary of available commandline options.
 test

run gp in test mode: suppress printing of history numbers and wrap long
output lines (to get readable diff output). For benches only.
 texmacs

gp can be run from a
TeXmacs
frontend. This flag is set by TeXmacs, to enable special purpose
communication channels. Do not set it yourself.
 version

output version info (banner) then exit.
 versionshort

output version number then exit.
USE
 ?

to get online help.
 ??

to get extended online help (more precisely, to call the external help
program,
gphelp
by default)
 quit

(or \q), or
EOF
(CtrlD) to quit
gp.
The following works only when gp was linked with GNU
readline
library:
 arrow keys

for editing and viewing the input history.
 TAB

for automatic completion
MANUALS
The following material is included in the standard distribution (originally
in TeX format):
 The User's Guide to PARI/GP

(users.dvi)
 The User's Guide to the PARI library

(library.dvi)
 PARI/GP, a tutorial

(tutorial.dvi)
 PARI/GP reference card

(refcard.ps): 4 pages, based on an earlier version by Joseph H. Silverman.
 pariemacs.txt

explains the use of the pari.el package, and how to customize it (prompt,
colors).
FILES
 gp

main executable
 $HOME/.gprc

(or $GPRC if set) user preference file, read at beginning of execution by
each
gp
shell. A default gprc
gprc.dft
is provided with the distribution. If this file cannot be found,
/etc/gprc
is checked instead.
 pari.log

default logfile (can be changed in the gprc file or interactively using
default()
)
 pari.ps

default psfile used for postscript output (as above)
 gphelp

default external help program (as above)
 pari.el

elisp package to run pari in an
Emacs
shell. Must be loaded from your
.emacs
file.
 *.gp

GP programs
ENVIRONMENT
 $GPRC

place to look for the user's preference file (gprc); if the file does not exist,
we then check in $HOME/.gprc, /etc/gprc, and finally for a file named 'gprc'
in PARI's
datadir.
 $GP_DATA_DIR

directory containing data installed by optional PARI packages.
For example, the Galois resolvents files in directory
galdata/
needed by the
polgalois
function, in degrees 8 to 11; or the modular polynomials in
seadata/
used by the
ellap
function for large base fields. This environment variable
overrides PARI's 'datadir', defined at Configure time.
 $GPHELP

name of the external help program invoked by ?? and ??? shortcuts.
 $GPTMPDIR

name of the directory where temporary files will be generated.
HOME PAGE
PARI's home page resides at

http://pari.math.ubordeaux.fr/
MAILING LISTS
There are a number of mailing lists devoted to the PARI/GP package, and most
feedback should be directed to those. See

http://pari.math.ubordeaux1.fr/listsindex.html
for details. The most important ones are:

pariannounce
(moderated): for us to announce major version changes.

paridev:
for everything related to the development of PARI, including
suggestions, technical questions, bug reports or patch submissions.

pariusers:
for discuss about everything else, in particular ask for help.
To subscribe, send empty messages with a Subject: containing the word
"subscribe" respectively to
pariannouncerequest@pari.math.ubordeaux.fr
pariusersrequest@pari.math.ubordeaux.fr
paridevrequest@pari.math.ubordeaux.fr
BUG REPORTS
Bugs should be submitted online to our Bug Tracking System, available from
PARI's home page, or directly from the URL

http://pari.math.ubordeaux.fr/Bugs/
Further instructions can be found on that page.
TRIVIA
Despite the leading G, GP has nothing to do with GNU. The first version was
originally called GPC, for Great Programmable Calculator. For some reason,
the trailing C was eventually dropped.
PARI has nothing to do with the French capital. The name is a pun about the
project's early stages when the authors started to implement a library for
"Pascal ARIthmetic" in the PASCAL programming language. They quickly
switched to C.
For the benefit of nonnative French speakers, here's a slightly expanded
explanation:
Blaise Pascal
(16231662) was a famous French mathematician and philosopher who was one
of the founders of probability and devised one of the first "arithmetic
machines". He once proposed the following "proof" of the existence of God
for the unbelievers: whether He exists or not I lose nothing by believing
in Him, whereas if He does and I misbehave... This is the socalled "pari
de Pascal" (Pascal's Wager).
Note that PARI also means "fairy" in Persian.
AUTHORS
PARI was originally written by Christian Batut, Dominique Bernardi, Henri
Cohen, and Michel Olivier in Laboratoire A2X (Universite Bordeaux I, France),
and was maintained by Henri Cohen up to version 1.39.15 (1995), and by Karim
Belabas since then.
A great number of people have contributed to the successive improvements
which eventually resulted in the present version. See the AUTHORS file in
the distribution.
SEE ALSO
gap(1),
gphelp(1),
perl(1),
readline(3),
sage(1),
tex(1),
texmacs(1),
COPYING
This program is free software; you can redistribute it and/or modify it under
the terms of the GNU General Public License as published by the Free Software
Foundation.
This program is distributed in the hope that it will be useful, but WITHOUT
ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.
You should have received a copy of the GNU General Public License along with
this program; if not, write to the Free Software Foundation, Inc., 675 Mass
Ave, Cambridge, MA 02139, USA.
Index
 NAME

 SYNOPSIS

 DESCRIPTION

 OPTIONS

 USE

 MANUALS

 FILES

 ENVIRONMENT

 HOME PAGE

 MAILING LISTS

 BUG REPORTS

 TRIVIA

 AUTHORS

 SEE ALSO

 COPYING

This document was created by
man2html,
using the manual pages.
Time: 14:56:43 GMT, October 13, 2012