Skip to content

Commit 5e3eecc

Browse files
authored
Merge pull request #798 from Mathics3/intro-revision
Intro revision
2 parents dd61601 + 474ed5a commit 5e3eecc

File tree

2 files changed

+35
-29
lines changed

2 files changed

+35
-29
lines changed

CHANGES.rst

Lines changed: 14 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -119,7 +119,7 @@ Enhancements
119119
#. Support for BigEndian Big TIFF
120120

121121

122-
122+
123123
5.0.2
124124
-----
125125

@@ -1042,8 +1042,8 @@ Backward incompatibilities
10421042

10431043
-----
10441044

1045-
1.0
1046-
--
1045+
1.0 (October 2016)
1046+
------------------
10471047

10481048
New features
10491049
++++++++++++
@@ -1198,15 +1198,15 @@ Performance improvements
11981198

11991199
-----
12001200

1201-
0.9
1202-
---
1201+
0.9 (March 2016)
1202+
----------------
12031203

12041204
New features
12051205
++++++++++++
12061206

12071207
#. Improve syntax error messages #329
12081208
#. ``SVD``, ``LeastSquares``, ``PseudoInverse`` #258, #321
1209-
#. Python 3 support #317
1209+
#. Python 2.7, 3.2-3.5 via six support #317
12101210
#. Improvements to ``Riffle`` #313
12111211
#. Tweaks to ``PolarPlot`` #305
12121212
#. ``StringTake`` #285
@@ -1242,8 +1242,8 @@ Bug fixes
12421242

12431243
-----------
12441244

1245-
0.8
1246-
---
1245+
0.8 (late May 2015)
1246+
-------------------
12471247

12481248
New features
12491249
+++++++++++++
@@ -1266,8 +1266,8 @@ Bug fixes
12661266

12671267
-----------
12681268

1269-
0.7
1270-
---
1269+
0.7 (Dec 2014)
1270+
--------------
12711271

12721272
New features
12731273
++++++++++++
@@ -1299,8 +1299,8 @@ Bugs fixed
12991299

13001300
--------------
13011301

1302-
0.6
1303-
---
1302+
0.6 (late October 2013)
1303+
------------------------
13041304

13051305
New features
13061306
++++++++++++
@@ -1335,8 +1335,8 @@ Bugs fixed
13351335

13361336
-------
13371337

1338-
0.5
1339-
---
1338+
0.5 (August 2012)
1339+
-----------------
13401340

13411341
#. Compatibility with Sage 5, SymPy 0.7, Cython 0.15, Django 1.2
13421342
#. 3D graphics and plots using WebGL in the browser and Asymptote in TeX output

mathics/doc/documentation/1-Manual.mdoc

Lines changed: 21 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -36,30 +36,36 @@ Performance of \Mathics is not, right now, practical in large-scale projects and
3636

3737
<section title="What does \Mathics offer?">
3838

39-
Some of the features of \Mathics are:
39+
Some of the features of \Mathics tries to be compatible with Wolfram-Language kernel within the confines of the Python ecosystem.
40+
41+
Given this, it is a powerful functional programming language, driven by pattern matching and rule application.
42+
43+
Primitive types include rationals, complex numbers, and arbitrary-precision numbers. Other primitive types such as images or graphs, or NLP come from the various Python libraries that \Mathics uses.
44+
45+
Outside of the "core" \Mathics kernel (which has a only primitive command-line interface), in separate github projects, as add-ons, there is:
46+
4047
<ul>
41-
<li>a powerful functional programming language,
42-
<li>a system driven by pattern matching and rules application,
43-
<li>rationals, complex numbers, and arbitrary-precision arithmetic,
44-
<li>lots of list and structure manipulation routines,
45-
<li>an interactive graphical user interface right in the Web browser using MathML (apart from a command line interface),
46-
<li>creation of graphics (e.g. plots) and display in the browser using SVG for 2D graphics and three.js for 3D graphics,
47-
<li>export of results to \LaTeX (using Asymptote for graphics),
48-
<li>an easy way of defining new functions in Python and which hooks into Python libraries
49-
<li>an integrated documentation and testing system.
48+
<li>a Django-based web server
49+
<li>a command-line interface using either prompt-toolkit, or GNU Readline
50+
<li>a <url>:Mathics3 module for Graphs:https://pypi.org/project/pymathics-graph/</url> (via <url>:NetworkX:https://networkx.org/</url>),
51+
<li>a <url>:Mathics3 module for NLP:https://pypi.org/project/pymathics-natlang/</url> (via <url>:nltk:https://www.nltk.org/</url>, <url>:spacy:https://spacy.io/</url>, and others)
52+
<li>a <url>:A docker container:https://hub.docker.com/r/mathicsorg/mathics</url> which bundles all of the above
5053
</ul>
5154

5255
</section>
5356

5457
<section title="History">
55-
The first alpha versions of \Mathics were done in 2011 by Jan Pöschko. He worked on it for a couple of years to about v0.5 which had 386 built-in symbols. Currently there are over a 1,000.
58+
The first alpha versions of \Mathics were done in 2011 by Jan Pöschko. He worked on it for a couple of years to about the v0.5 release in 2012. By then, it had 386 built-in symbols. Currently there are over a 1,000 and even more when \Mathics modules are included.
5659

57-
After that, Angus Griffith took over primary leadership and rewrote the parser to pretty much the stage it is in now. He and later Ben Jones worked on it from 2013 to about 2017 to the v1.0 release. Towards the end of this period, Bernhard Liebl worked on this mostly focused on graphics.
60+
After that, Angus Griffith took over primary leadership and rewrote the parser to pretty much the stage it is in now. He and later Ben Jones worked on it from 2013 to about 2017 to the v1.0 release. Towards the end of this period, Bernhard Liebl worked on this, mostly focused on graphics.
5861

5962
A <url>:docker image of the v.9 release: https://hub.docker.com/r/arkadi/mathics</url> can be found on dockerhub.
6063

61-
The project was largely abandoned in its Python 2.7 state around 2017. Subsequently it was picked up by the current developers. A list of authors and contributors can be found in the
62-
<url>:<con>AUTHORS.txt</con>: https://github.com/Mathics3/mathics-core/blob/master/AUTHORS.txt</url> file.
64+
Around 2017, the project was largely abandoned in its largely Python 2.7 state, with support for Python 3.2-3.5 via six.
65+
66+
Subsequently, around mid 2020, it was picked up by the current developers. A list of authors and contributors can be found in the <url>
67+
:<con>AUTHORS.txt</con>:
68+
https://github.com/Mathics3/mathics-core/blob/master/AUTHORS.txt</url> file.
6369
</section>
6470

6571
<section title="What is missing?">
@@ -70,7 +76,7 @@ While we always could use help, such as in Python programming, improving Documen
7076
<ul>
7177
<li>Ensure this document is complete and accurate. We could use help to ensure all of the Builtin functions described properly and fully, and that they have link to corresponding Wiki, Sympy, WMA and/or mpath links.
7278
Make sure the builtin summaries and examples clear and useful.</li>
73-
<li>We could use help in LaTeX styling, and going over this document to remove overful boxes and things of that nature. We could also use help and our use of Asymptote. The are some graphics primitives such as for polyhedra that haven't been implemented. Similar graphics options are sometimes missing in Aymptote that we have available in other graphics backends.</li>
79+
<li>We could use help in LaTeX styling, and going over this document to remove overful boxes and things of that nature. We could also use help and our use of Asymptote. The are some graphics primitives such as for polyhedra that haven't been implemented. Similar graphics options are sometimes missing in Asymptote that we have available in other graphics backends.</li>
7480

7581
<li>add another graphics backend: it could be a javascript library like jsfiddle</li>
7682

0 commit comments

Comments
 (0)