Differences between revisions 40 and 41
Revision 40 as of 2014-07-20 19:51:41
Size: 6821
Editor: chapoton
Comment: no more hg
Revision 41 as of 2017-02-02 03:25:01
Size: 0
Editor: mrennekamp
Comment: will write into sage documentation (meaning archived by mrennekamp, and will make convenient, unified page)
Deletions are marked like this. Additions are marked like this.
Line 1: Line 1:
== A Short Introduction to Sage ==

Sage is a mathematics software package for number theory, algebra, and geometry computation. The implementation is due to [[William_Stein]] and over 50 other contributors from [[http://www.sagemath.org/development-map.html|around the world]]. It is open source and freely available under the terms of the GNU General Public License (GPL). Sage is

 * A unified distribution of free mathematics software that mere mortals can build from source;

 * A new Python library for mathematical computation with graphical and command-line interfaces; and

 * An interface to existing mathematics software packages.

It is written in [[Python]], C++, and C (via [[Pyrex" / "Cython]] http://www.cython.org/). Python is an open source object-oriented interpreted language, with a large number of libraries, e.g., for numerical analysis, which are available to users of Sage. Python can also be accessed in library mode from C/C++ programs.

Sage ships with and provides a unified interface to several important open source libraries, including [[Singular|SINGULAR]] (for commutative algebra), [[scipy|SciPy]] (for applied mathematics), [[GAP]] (for group theory), John Cremona's [[MWRANK]] library (for elliptic curves), the [[PARI]] library for number theory, [[linbox|LinBox]] (for linear algebra), Victor Shoup's number theory library [[NTL]], and [[Maxima]] (for symbolic manipulation). There are also interfaces to many commercial or closed source mathematics software packages including Maple, MATLAB, Mathematica, KASH/KANT, MAGMA, Axiom, and many others. For graphics, Sage includes Matplotlib (for 2-D and some 3-D graphics), jmol (3-D graphics) and tachyon (a 3-D ray tracer).

The main long-term goals and guiding principles for Sage are:

 * Free and open source: The source code must be freely available and readable, so users can understand what the system is really doing and more easily extend it. Just as mathematicians gain a deeper understanding of a theorem by carefully reading or at least skimming the proof, people who do computations should be able to understand how the calculations work by reading documented source code. All software included in the Sage core distribution must be free and open source, and arbitrary modifications and redistribution of every single line must be allowed.

 * Good programming environment: It is hoped that Sage will form a stable environment to begin programming new mathematics software projects. Sage provides a model for the mathematical community of software development with a strong emphasis on openness, community, cooperation, and collaboration.

 * Extensible: Be able to define new data types or derive from built-in types, and make code written in a favorite language (including C/C++) part of the system.

 * User friendly: The hope is to eventually attain a high level of user support.

 * Easy to compile: Sage should be relatively easy to compile from source for Linux and Mac OS X users. This provides more flexibility in modifying the system.

 * Cross-platform: Sage runs under Linux, Mac OS X, Windows.

 * Comprehensive: Implement enough algorithms to be really useful. Unify free open source mathematics software. Be a comprehensive mainstream high quality open source free mathematics software system.

 * Efficient: Be very fast---comparable to or faster than anything else available. This is very difficult, since many systems are closed source, algorithms are sometimes not published, and finding fast algorithms is often extremely difficult (years of work, Ph.D. theses, luck, etc.).

 * Tools: Provide robust interfaces to some of the functionality of PARI, GAP, GMP, Maxima, SINGULAR, MWRANK, and NTL. These are all GPL'd and Sage provides a unified interface for using them.

 * Well documented: Reference manual, tutorial, API reference with examples for every function, and an extensive "How can ... be constructed in Sage?" document.


Download Sage, an installation guide and a tutorial, from its webpage

http://www.sagemath.org/.

Although Sage uses Python, PARI, and other packages, keep in mind that it is not necessary to have those software packages preinstalled on your computer. The installation of Sage is really designed to be relatively painless, but if there are any problems, please ask (the web page has links to the email lists for Sage support). There are installation instructions at http://www.sagemath.org/doc/html/inst/index.html. Moreover, if Sage is installed once, upgrading to the newest version is especially easy with the "upgrade" command option (this is described on the website given above and assumes that the command "{{{wget}}}" is installed and you have an Internet connection).

Once Sage is installed into a directory such as "{{{sage-x.y.z}}}" in Linux, cd to this directory and type the command "{{{./sage}}}" to start Sage. Another way to use Sage is to, from within a command-line Sage session, type "{{{notebook(open_viewer=True)}}}" at the Sage prompt. This (a) starts the Sage server running (loading the previously used worksheet, if any); and (b) opens the Firefox (or your default system) browser (or starts a new tab if it is already open) and displays the Sage notebook webpage.

At the Sage prompt, type "{{{factor(100)}}}" and then press the Return or Enter key. Sage will output the prime factorization of 100. Type "{{{factor??}}}" (and press Return) and the source code of the function "{{{factor}}}" will be shown. Enter Ctrl-d (hold the Ctrl key and d at the same time) or type "quit" (return), and Sage will exit. To do this computation in the notebook, enter "{{{factor(100)}}}" into a "cell" (an empty white window in the web browser) and then press shift-enter. Sage will display the factorization in the space just below the cell. To exit the notebook, go back to the command line and press Ctrl-c. Next, exit the browser. This quits Sage's notebook.

There are thousands of additional examples in the tutorial, constructions, and reference manuals, which are available on the Sage webpage. Please try them out!

Sage is actively growing, and is already usable. There are Sage discussion lists, [[http://trac.sagemath.org/sage_trac|bug-tracker]], [[http://wiki.sagemath.org|wiki]], and [[https://github.com/sagemath/sage|code browser]]. Please visit

http://www.sagemath.org/ (west coast of USA)

or

http://sage.apcocoa.org (Germany)

or

http://echidna.maths.usyd.edu.au/sage/ (Australia)

or

email the Sage group at one of the email lists http://www.sagemath.org/lists.html

for more information. Above all, have fun with Sage!

----

David Joyner
[email protected]

William Stein
[email protected]

Last Updated 1-18-2008.

DocumentationProject