Skip to content

Commit

Permalink
General: Added readme.md
Browse files Browse the repository at this point in the history
  • Loading branch information
Somerandomguy10111 committed Dec 2, 2024
1 parent 968897e commit b9dd881
Showing 1 changed file with 27 additions and 0 deletions.
27 changes: 27 additions & 0 deletions readme.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,27 @@
## About

Python API for opXRD database. See more at https://xrd.aimat.science

## Setup

### System level requirements
The data file import functionalities provided by the xrdpattern requirement are largely built on the C++ library [xylib](https://github.com/wojdyr/xylib) so beyond a standard python install this library also requires:
- A C++ compiler and standard library
- A C++ to python bridge (Swig)
```
sudo apt install build-essential # GNU C++ compiler
sudo apt install libboost-all-dev # C++ libraries provided by Boost
sudo apt install swig # python -> C++ bridge
```

For Windows >10 you may try the following in PowerShell (requires [Chocolatey](https://chocolatey.org/)):
```
choco install mingw # C++ compiler and std library
choco install swig # python -> C++ bridge
```

### Python library
Once the system level requirements are installed, the library can be installed using pip:
```
pip install opxrd
```

0 comments on commit b9dd881

Please sign in to comment.