README.md 2.51 KB
Newer Older
1
2
3
# PyFstat

This is a python package containing basic wrappers of the `lalpulsar` module
4
with capabilities to perform a variety of searches, primarily focusing on
5
6
semi-coherent glitch searches.

7
8
## Examples

9
10
11
12
We include a variety of example search scripts [here](examples), for each
example there is also a more descriptive write-up containing examples of the
output which we list below. Before running any of the search examples, be sure
to have run the [script to generate fake data](examples/make_fake_data.py).
13
14

* [Making fake data with and without glitches](docs/make_fake_data.md)
15
16
17
18
* [Fully-coherent MCMC search](docs/fully_coherent_search_using_MCMC.md)
* [Fully-coherent MCMC search on data containing a single glitch](docs/fully_coherent_search_using_MCMC_on_glitching_data.md)
* [Semi-coherent MCMC glitch-search on data containing a single glitch](docs/semi_coherent_glitch_search_using_MCMC_on_glitching_data.md)
* [Semi-coherent MCMC glitch-search on data containing two glitches](docs/semi_coherent_glitch_search_with_two_glitches_using_MCMC_on_glitching_data.md)
19
* [Semi-coherent Follow-Up MCMC search (dynamically changing the coherence time)](docs/follow_up.md)
20

21
22
23
24
## Installation

The script can be installed system wide via
```
25
$ python setup.py install
26
```
27
28
29
30
31
32
or simply add this directory to your python path. To check that the installation
was successful, run
```
$ python -c 'import pyfstat'
```
if no error message is output, then you have installed `pyfstat`.
33
34
35
36

### Ephemeris installation

The scripts require a path to ephemeris files in order to use the
37
38
`lalpulsar.ComputeFstat` module. This can either be specified when initialising
each search, or more simply by placing a file `~/pyfstat.conf` into your home
39
40
41
42
43
44
directory which looks like

```
earth_ephem = '/home/<USER>/lalsuite-install/share/lalpulsar/earth00-19-DE421.dat.gz'
sun_ephem = '/home/<USER>/lalsuite-install/share/lalpulsar/sun00-19-DE421.dat.gz'
```
45
here, we use the default ephemeris files provided with `lalsuite`.
46
47
48
49
50
51

### Dependencies

* swig-enabled lalpulsar, a minimal configuration is given by

```
52
$ ./configure --prefix=${HOME}/lalsuite-install --disable-all-lal --enable-lalpulsar --enable-lalapps --enable-swig
53
54
55
56
57
```

* [emcee](http://dan.iel.fm/emcee/current/)[^1]
* [corner](https://pypi.python.org/pypi/corner/)[^1]
* [dill](https://pypi.python.org/pypi/dill)[^1]
58
59
* [tqdm](https://pypi.python.org/pypi/tqdm)[^1] (optional), if installed, this
  provides a useful progress bar and estimate of the remaining run-time.
60

61
[^1]: Most easily installed using either `conda` or `pip`.
62