comparison README.txt @ 191:09bcb48cc067

[documentation] more on what this is and what it depends on
author Jeff Hammel <k0scist@gmail.com>
date Thu, 03 Aug 2017 16:22:45 -0700
parents c2c86c37eadd
children 2a69ce7f944e
comparison
equal deleted inserted replaced
190:72ae8c768504 191:09bcb48cc067
1 = numerics = 1 = numerics =
2 2
3 /python experiments in numerics + plotting/ 3 /python experiments in numerics + plotting/
4
5 == What is numerics? ==
6
7 Over the years and at various companies, I have found the need to
8 perform quick pipelines of calculations on mathematical data (usually
9 numbers). The `numerics`
10 [python package](https://pypi.python.org/pypi/numerics)
11 is an assemblege of tools and methods needed to scratch this issue.
12 It is neither scoped nor complete.
13
14 `numerics` largely deals in the currency of Comma Separated Value (CSV)
15 files.
16
17 == Dependencies ==
18
19 The backbone of `numerics` are its dependencies, which I have either
20 used + liked or just used:
21
22 - [NumPy](http://www.numpy.org/)
23 - [pandas](http://pandas.pydata.org/) : python data analysis
24 - [matplotlib](https://matplotlib.org/)
25 - [bokeh](http://bokeh.pydata.org/en/latest/) : because I couldn't
26 decide which visualization library I *actually* wanted
27
28 These dependencies are (mostly) listed in `numerics`'s
29 [setup.py](http://k0s.org/hg/numerics/file/tip/setup.py)
30
4 31
5 == Installation == 32 == Installation ==
6 33
7 Because `numerics` is largely a bunch of experiments, it requires 34 Because `numerics` is largely a bunch of experiments, it requires
8 several packages. Some of them *may* be challenging to install. 35 several packages. Some of them *may* be challenging to install.
9 Here's how, as best I know. 36 Here's how, as best I know.
10 37
38 I have found it necessary to `pip install bokeh` before
39 the rest of numerics...otherwise a version conflict re `pytz` may result.
40
41 Then one may do `python setup.py develop` in the `numerics` directory
42
11 === OSX === 43 === OSX ===
12 44
13 For matplotlib: 45 For [matplotlib](https://matplotlib.org/):
14 46
15 http://superuser.com/questions/242190/how-to-install-matplotlib-on-os-x 47 http://superuser.com/questions/242190/how-to-install-matplotlib-on-os-x
16 48
17 You may also have to manually refresh the font cache: 49 You may also have to manually refresh the font cache:
18 50
19 cd ~/.matplotlib/ 51 cd ~/.matplotlib/
20 fc-list # Should take a couple minutes. 52 fc-list # Should take a couple minutes.
21 53
22 (From: http://stackoverflow.com/questions/17490444/import-matplotlib-pyplot-hangs ) 54 (From: http://stackoverflow.com/questions/17490444/import-matplotlib-pyplot-hangs )
23 55
56
24 == Libraries == 57 == Libraries ==
25 58
26 The following libraries, listed by language, may be worth investigating. 59 The following libraries, listed by language, may be worth investigating.
60
27 61
28 === JavaScript === 62 === JavaScript ===
29 63
30 - http://metricsgraphicsjs.org/ 64 - http://metricsgraphicsjs.org/
31 - https://github.com/mikedewar/d3py : python -> d3 bridge 65 - https://github.com/mikedewar/d3py : python -> d3 bridge
66
67
68 == Links ==
69
70 - https://scipy.org/
32 71
33 ---- 72 ----
34 73
35 Jeff Hammel 74 Jeff Hammel
36 75