|
8 | 8 |
|
9 | 9 | # Presolar grain database tools (pgdTools) |
10 | 10 |
|
11 | | -Currently under development. |
12 | 11 |
|
13 | | -This folder contains a very rough draft / |
14 | | -development version / |
15 | | -idea gathering file(s) |
16 | | -for `pgdtools`. |
17 | | -Use at your own risk! |
18 | | - |
19 | | -The idea behind this folder is to have a place |
20 | | -to share (really) early versions of `pgdtools` |
21 | | -with colleagues for testing |
22 | | -and feedback. |
23 | | -Thinks might change at any time! |
24 | | -There's no guarantee for consistency, |
25 | | -or anything, you've been warned. |
26 | | -That being said, |
27 | | -there should also be example files. |
28 | | -Have a look at the latest dates, etc., |
29 | | -in order to find one that might work. |
30 | | - |
31 | | -Feedback extremely welcome! |
32 | | - |
33 | | -## Installation |
34 | | - |
35 | | -### Jupyterlab server (e.g., WENDI, ...) |
36 | | - |
37 | | -In the first cell of your jupyter notebook, |
38 | | -run the following code: |
39 | | - |
40 | | -``` |
41 | | -%pip install git+https://github.com/galactic-forensics/pgdtools.git |
42 | | -``` |
43 | | - |
44 | | -This should pull the latest version |
45 | | -of `pgdtools` from GitHub and install it. |
46 | | -To test, follow steps below. |
47 | | - |
48 | | -### Local |
49 | | - |
50 | | -To use this module, |
51 | | -clone this repository |
52 | | -and enter it: |
53 | | -```bash |
54 | | -git clone https://github.com/galactic-forensics/pgdtools.git |
55 | | -cd pgdtools |
56 | | -``` |
57 | | - |
58 | | -It is recommended that you use |
59 | | -a virtual python environment for the following steps. |
60 | | -Also: these steps have been tested with python 3.9. |
61 | | - |
62 | | -First, install the python requirements, |
63 | | -then the package itself. |
64 | | -You can skip the jupyter and ipython line if you |
65 | | -do not want to use these tools. |
66 | | - |
67 | | -``` |
68 | | -pip install . |
69 | | -``` |
70 | | - |
71 | | -### Give it a spin |
72 | | - |
73 | | -Now you should be ready to use `pgdtools` |
74 | | -from your session. Try the following: |
75 | | - |
76 | | -```python |
77 | | -import pgdtools |
78 | | - |
79 | | -pg = pgdtools.PresolarGrains() |
80 | | -``` |
81 | | - |
82 | | -If this does not throw an error, |
83 | | -you should be fine and the |
84 | | -presolar grain database was found. |
85 | | - |
86 | | -## Examples |
87 | | - |
88 | | -The `examples` folder contains some examples for you to read through. |
89 | | -There are some pure python exampmles, |
90 | | -as well as an ipython notebook for your consideration. |
91 | | -Please let me know if things are unclear, etc. |
92 | | - |
93 | | -## Presolar grain database |
94 | | - |
95 | | -The presolar grain database |
96 | | -can be found at |
97 | | -https://presolar.physics.wustl.edu/presolar-grain-database/. |
98 | | -Note that only the SiC database |
99 | | -is currently thought of being error free. |
100 | | -The current version of `pgdtools` |
101 | | -includes the 2021-01-10 version |
102 | | -of the presolar SiC grain database, |
103 | | -which is the current version as of this writing (Nov 2021). |
104 | | - |
105 | | -## Development |
106 | | - |
107 | | -To make a development installation, |
108 | | -type: |
109 | | - |
110 | | -```python |
111 | | -pip install -e .[dev] |
112 | | -``` |
113 | | - |
114 | | -This will install all required packages. |
115 | | - |
116 | | -More to come on this... |
| 12 | +This package provides a set of tools to |
| 13 | +easily access and interface with the presolar grain database. |
| 14 | +This package allows users to manage which database(s) they want to use |
| 15 | +and provides a set of tools to filter and access the data itself. |
| 16 | +Furthermore, maintainer tools are provided as well |
| 17 | +in order for database maintainers to keep the package up to date. |
| 18 | + |
| 19 | +For installation, usage guidance, and more information, |
| 20 | +see the [documentation](https://pgdtools.readthedocs.io). |
| 21 | + |
| 22 | +While we hope that most of functionality is stable, |
| 23 | +this package is still under development. |
| 24 | +Please report any issues you encounter and let us know what you think! |
| 25 | +Feel free either open a [new issue](https://github.com/NASA-Planetary-Science/pgdtools/issues) on GitHub, |
| 26 | +start a [new discussion](https://github.com/NASA-Planetary-Science/pgdtools/discussions), |
| 27 | +or reach out to us directly. |
0 commit comments