Skip to content
Snippets Groups Projects
Commit f9fa1bbe authored by David Hendriks's avatar David Hendriks
Browse files

rewriting readme

parent 7cc73bbd
No related branches found
No related tags found
No related merge requests found
......@@ -3,8 +3,7 @@ Coverage: ![alt text](coverage.svg)
Based on a original work by Jeff Andrews (can be found in old_solution/ directory)
updated and extended for Python3 by Robert Izzard, David hendriks
Requirements
---------------------
## Requirements
To run this code you need to at least have installations of:
- Python3
- binary_c version 2.1+
......@@ -18,8 +17,7 @@ And the following python packages (which will get installed automatically when i
- astropy
- matplotlib
Environment variables
---------------------
## Environment variables
Before compilation you need to have certain environment variables:
Required:
......@@ -27,20 +25,17 @@ Required:
- `LD_LIBRARY_PATH` should include $BINARY_C/src and whatever directories are required to run binary_c (e.g. locations of libgsl, libmemoize, librinterpolate, etc.)
- `LIBRARY_PATH` should include whatever directories are required to build binary_c (e.g. locations of libgsl, libmemoize, librinterpolate, etc.)
Build instructions
------------------
## Build instructions
First, make sure you have built binary_c (See `$BINARY_C/doc/binary_c2.pdf` section: installation for all the installation instructions for `binary_c`)) and that it functions correctly.
Installation via PIP:
=====================
### Installation via PIP:
To install this package via pip:
```
pip install binarycpython
```
Installation from source:
=========================
### Installation from source:
For this it is best to set up a virtual environment for this. Activate the virtualenvironment and enter the downloaded version of the repo.
Then run
......@@ -50,20 +45,16 @@ python setup.py clean && python setup.py build --force && python setup.py sdist
This will install this package into the virtual environment. Making changes to the sourcecode can be "installed" into the virtual env with the same command.
Examples
--------
## Examples
See the examples/ directory for example script. The documentation contains example pages as well.
Usage notes
-----------
## Usage notes
Make sure that with every change/recompilation you make in `binary_c`, you also rebuild this package.
Documentation
-------------
## Documentation
Look in the doc/ directory. Within the build/html/ there is the html version of the documentation.
FAQ/Issues:
--------------------
## FAQ/Issues:
Building issues with binary_c itself:
- see the documentation of binary_c (in doc/).
- If you have MESA installed, make sure that the `$MESASDK_ROOT/bin/mesasdk_init.sh` is not sourced. It comes with its own version of some programs, and those can interfere with installing.
......
0% Loading or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment