Spaces:
Sleeping
Sleeping
File size: 2,053 Bytes
b66f126 | 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 | .. _intro-tutorial:
=====================
Introductory Tutorial
=====================
This tutorial aims to give an introduction to SymPy for someone who has not
used the library before. Many features of SymPy will be introduced in this
tutorial, but they will not be exhaustive. In fact, virtually every
functionality shown in this tutorial will have more options or capabilities
than what will be shown. The rest of the SymPy documentation serves as API
documentation, which extensively lists every feature and option of each
function.
These are the goals of this tutorial:
.. NB: This is mainly here for you, the person who is editing and adding to
this tutorial. Try to keep these principles in mind.
- To give a guide, suitable for someone who has never used SymPy (but who has
used Python and knows the necessary mathematics).
- To be written in a narrative format, which is both easy and fun to follow.
It should read like a book.
- To give insightful examples and exercises, to help the reader learn and to
make it entertaining to work through.
- To introduce concepts in a logical order.
.. In other words, don't try to get ahead of yourself.
- To use good practices and idioms, and avoid antipatterns. Functions or
methodologies that tend to lead to antipatterns are avoided. Features that
are only useful to advanced users are not shown.
- To be consistent. If there are multiple ways to do it, only the best way is
shown.
.. For example, there are at least five different ways to create Symbols.
``symbols`` is the only one that is general and doesn't lead to
antipatterns, so it is the only one used.
- To avoid unnecessary duplication, it is assumed that previous sections of
the tutorial have already been read.
Feedback on this tutorial, or on SymPy in general is always welcome. Just
write to our `mailing list
<https://groups.google.com/forum/?fromgroups#!forum/sympy>`_.
**Content**
.. toctree::
:maxdepth: 2
preliminaries.rst
intro.rst
gotchas.rst
features.rst
next.rst
|