|
4 | 4 | # 2548 Vera Cruz Drive |
5 | 5 | # Birmingham, AL 35235 USA |
6 | 6 | # |
7 | | - |
8 | | -# |
9 | | -# License: BSD-style (see LICENSE.txt in main source directory) |
| 7 | +# License: BSD-style (see license.txt in main source directory) |
10 | 8 | """ |
11 | 9 | Introducing pyeq3 |version| |
12 | 10 | =========================== |
13 | 11 |
|
14 | 12 | Overview |
15 | 13 | -------- |
16 | 14 |
|
17 | | -pyeq3 is a large collection of python3 equations that perform curve fitting on 2D and 3D data, |
18 | | -output source code in several computing languages, and run a genetic algorithm for initial parameter estimation. |
19 | | -The module comes with cluster, parallel, IPython, GUI, NodeJS, and web-based graphical examples. |
| 15 | +pyeq3 is a large collection of python3 equations that perform |
| 16 | +curve fitting on 2D and 3D data, output source code in several |
| 17 | +computing languages, and run a genetic algorithm for initial |
| 18 | +parameter estimation. The module comes with cluster, parallel, |
| 19 | +IPython, GUI, NodeJS, and web-based graphical examples. |
20 | 20 | It includes orthogonal distance and relative error regressions. |
21 | 21 |
|
22 | | -pyeq3 is released under a permissive license. It relies on numpy, scipy, and matplotlib. |
| 22 | +pyeq3 is released under a permissive license. |
| 23 | +It relies on numpy, scipy, and matplotlib. |
23 | 24 |
|
24 | | - - Homepage: https://github.com/bobmyhill/pyeq3 |
| 25 | + - Homepage: https://github.com/equations-project/pyeq3 |
25 | 26 | - Documentation: http://pyeq3.readthedocs.io |
26 | | - - Source code: https://github.com/bobmyhill/pyeq3 |
| 27 | + - Source code: https://github.com/equations-project/pyeq3 |
27 | 28 | - Web App: http://findcurves.com/ |
28 | 29 | - Discussion group: https://groups.google.com/g/findcurves |
29 | 30 |
|
30 | | -If you haven't yet installed pyeq3, you can go straight to :ref:`ref-installation` for detailed |
31 | | -instructions. After that, you might want to try out some :ref:`ref-examples`. |
| 31 | +If you haven't yet installed pyeq3, you can go straight to |
| 32 | +:ref:`ref-installation` for detailed instructions. |
| 33 | +After that, you might want to try out some :ref:`ref-examples`. |
32 | 34 |
|
33 | 35 |
|
34 | 36 | Citing pyeq3 |
35 | 37 | ------------ |
36 | 38 |
|
37 | | -There will soon be a Zenodo DOI with which you can cite this project. |
38 | | -Please check back here before you publish. |
| 39 | +If you use pyeq3 in your work, we ask that you cite the following publications: |
| 40 | + - Phillips, J. R. and Myhill, R. (2022): |
| 41 | + pyeq3 v12.6 [Software]. Zenodo. |
| 42 | + `(https://doi.org/10.5281/zenodo.6528718) <https://doi.org/10.5281/zenodo.6528718>`_ |
39 | 43 |
|
40 | 44 |
|
41 | 45 | Contributing to pyeq3 |
42 | 46 | --------------------- |
43 | 47 |
|
44 | 48 | If you would like to contribute bug fixes, new functions or new modules |
45 | 49 | to the existing codebase, please make a |
46 | | -pull request at `https://github.com/bobmyhill/pyeq3/pulls <https://github.com/bobmyhill/pyeq3/pulls>`_. |
| 50 | +pull request at `https://github.com/equations-project/pyeq3/pulls <https://github.com/equations-project/pyeq3/pulls>`_. |
47 | 51 |
|
48 | 52 |
|
49 | 53 | .. _ref-installation: |
|
59 | 63 | ------------ |
60 | 64 |
|
61 | 65 | Installation of pyeq3 is mostly platform independent. |
62 | | -As long as you know how to use a terminal, the process should be straightforward. |
63 | | -The following instructions should help, but let us know if you have any problems. |
| 66 | +As long as you know how to use a terminal, the process |
| 67 | +should be straightforward. The following instructions should help, |
| 68 | +but let us know if you have any problems. |
64 | 69 |
|
65 | 70 | Dependencies |
66 | 71 | ^^^^^^^^^^^^ |
|
92 | 97 |
|
93 | 98 | This method of installation does not give you easy access to all the examples, |
94 | 99 | or the test suite. These can be found in the latest release package which can |
95 | | -be downloaded from https://github.com/bobmyhill/pyeq3/releases. |
| 100 | +be downloaded from https://github.com/equations-project/pyeq3/releases. |
96 | 101 |
|
97 | 102 | Development version |
98 | 103 | ^^^^^^^^^^^^^^^^^^^ |
99 | 104 | If you want to install the development version of pyeq3 |
100 | | -(with all the latest features), you will first need to download the source code. |
101 | | -The best way to do this is by using git (a version control system). |
| 105 | +(with all the latest features), you will first need to download the source |
| 106 | +code. The best way to do this is by using git (a version control system). |
102 | 107 | To install git, follow the instructions at https://git-scm.com/downloads. |
103 | 108 |
|
104 | 109 | Then, using a terminal, navigate to the directory into which you want to |
105 | 110 | clone the BurnMan repository, and type |
106 | 111 |
|
107 | | - git clone https://github.com/bobmyhill/pyeq3.git |
| 112 | + git clone https://github.com/equations-project/pyeq3.git |
108 | 113 |
|
109 | 114 | (If you don't want to use git, you can download the current main branch |
110 | | -from https://github.com/bobmyhill/pyeq3/archive/main.zip.) |
| 115 | +from https://github.com/equations-project/pyeq3/archive/main.zip.) |
111 | 116 |
|
112 | 117 | Once the repository is cloned, navigate to the top-level directory by typing |
113 | 118 | `cd pyeq3` in the terminal, and then install pyeq3, either in static mode: |
|
0 commit comments