Skip to content

Commit 3986741

Browse files
committed
update main readme
1 parent 74c83b9 commit 3986741

File tree

1 file changed

+16
-105
lines changed

1 file changed

+16
-105
lines changed

README.md

Lines changed: 16 additions & 105 deletions
Original file line numberDiff line numberDiff line change
@@ -8,109 +8,20 @@
88

99
# Presolar grain database tools (pgdTools)
1010

11-
Currently under development.
1211

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

Comments
 (0)