AndySAnker commited on
Commit
db7d530
1 Parent(s): fba5f30

Update README.md

Browse files
Files changed (1) hide show
  1. README.md +11 -86
README.md CHANGED
@@ -1,86 +1,11 @@
1
- # POMFinder
2
- Welcome to POMFinder!
3
- This is a simple machine learning tool for structure characterisation of polyoxometalate clusters using total scattering Pair
4
- Distribution Function (PDF) analysis.
5
- Simply provide a PDF and the model will output best best structural models from it structure catalog which contains 443 polyoxometalate clusters.
6
-
7
- 1. [Install](#install)
8
- 2. [Usage](#usage)
9
- 3. [Authors](#authors)
10
- 4. [Cite](#cite)
11
- 5. [License](#license)
12
-
13
-
14
- ## Install
15
- To install POMFindeer you will need to have [Python](https://www.python.org/downloads/) or
16
- [Anaconda](https://www.anaconda.com/products/individual) installed. I recommend running POMFinder on Python version
17
- 3.7 or higher. If you have installed Anaconda you can create a new environment and activate it.
18
- ```
19
- conda create --name POMFinder_env python=3.7
20
- conda activate POMFinder_env
21
- ```
22
- Now you are ready to install what you actually come for! Currently __POMFinder__ is not avaible through PyPI or conda so the
23
- package needs to be downloaded manually
24
- Run the following command to install the __POMFindeer__ package.
25
- ```
26
- pip install .
27
- or
28
- python setup.py install
29
- ```
30
-
31
- To verify that __POMFinder__ have been installed properly try calling the help argument.
32
- ```
33
- POMFinder --help
34
-
35
- >>> usage: POMFinder [-h] -d DATA [-n NYQUIST] [-i QMIN] [-a QMAX] [-m QDAMP] [-f FILE_NAME]
36
- >>>
37
- >>> This is a package which takes a directory of PDF files
38
- >>> or a specific PDF file. It then determines the best structural
39
- >>> candidates based of a polyoxometalate catalog. Results can
40
- >>> be fitted to the PDF.
41
- ```
42
- This should output a list of possible arguments for running __POMFinder__ and indicates that it could find the package!
43
-
44
- ## Usage
45
- Now that __POMFinder__ is installed and ready to use, lets discuss the possible arguments. The arguments are described in
46
- greater detail at the end of this section.
47
-
48
- | Arg | Description | Default |
49
- | --- | --- | --- |
50
- | | __Required argument__ | |
51
- | `-h` or `--help` | Prints help message. |
52
- | `-n` or `--nyquist` | Is the data nyquist sampled. __bool__ | `-n True`
53
- | `-i` or `--Qmin` | Qmin value of the experimental PDF. __float__ | `-i 0.7`
54
- | `-a` or `--Qmax` | Qmax value of the experimental PDF. __float__ | `-a 30`
55
- | `-m` or `--Qdamp` | Qdamp value of the experimental PDF. __float__ | `-m 0.04`
56
- | `-f` or `--file_name` | Name of the output file. __str__ | `-o ''`
57
- | `-d` or `--data` | A directory of PDFs or a specific PDF file. __str__ | `-d 5`
58
-
59
- For example
60
- ```
61
- POMFinder --data "Experimental_Data/DanMAX_AlphaKeggin.gr" --nyquist "no" --Qmin 0.7 --Qmax 20 --Qdamp 0.02
62
-
63
- >>> The 1st guess from the model is: icsd_427457_1_0.9rscale.xyz
64
- >>> The 2nd guess from the model is: icsd_427379_0_0.9rscale.xyz
65
- >>> The 3rd guess from the model is: icsd_281447_0_1.0rscale.xyz
66
- >>> The 4th guess from the model is: icsd_423775_0_0.9rscale.xyz
67
- >>> The 5th guess from the model is: icsd_172542_0_1.1rscale.xyz
68
-
69
- ```
70
- # Authors
71
- __Andy S. Anker__<sup>1</sup>
72
- __Emil T. S. Kjær__<sup>1</sup>
73
- __Kirsten M. Ø. Jensen__<sup>1</sup>
74
-
75
- <sup>1</sup> Department of Chemistry and Nano-Science Center, University of Copenhagen, 2100 Copenhagen Ø, Denmark.
76
-
77
- Should there be any question, desired improvement or bugs please contact us on GitHub or
78
- through email: __andy@chem.ku.dk__.
79
-
80
- # Cite
81
- If you use our code or our results, please consider citing our paper. Thanks in advance!
82
- ```
83
- ```
84
-
85
- # License
86
- This project is licensed under the Apache License Version 2.0, January 2004 - see the [LICENSE](LICENSE) file for details.
 
1
+ ---
2
+ title: POMFinder App
3
+ emoji: 🚀
4
+ colorFrom: green
5
+ colorTo: blue
6
+ sdk: streamlit
7
+ sdk_version: 1.10.0
8
+ app_file: app.py
9
+ pinned: false
10
+ license: apache-2.0
11
+ ---