-not sure why this is not inherited from the base ComputeFstat class

 -requires manual context initialisation and cleanup

 -to later allow for CUDA implementation
 -some optional-import acrobatics
  to fail gracefully if a module (especially CUDA)
  is not available
 -as of this commit, nothing beyond lal implemented yet

- Default to 1 glitch
- Only try to calculate segment 2F if length > 1800s

 -new output: full (t0,tau) Fstat map,
  if bands in those params are searched
 -one file per Doppler grid point

 -replaces boolean 'transient' flag
 -window type [none,rect,exp]
  for both injections and searches
 -t0, tau bands for gridsearch,
  single-point use (e.g. MCMC) should be unchanged

- Remove minStartTime, maxStartTime and outdir as default arguments
- Adds notes ot documentation on which arguments are optional
- Change log-level on some command line calls that dont' matter
- Reorganise the tests performed after loading the data
- If minStartTime and maxStartTime are None, set them using
  SFT_timestamps
- Remove default labels from plot_twoF_cumulative
- If add_pfs is called, call generate_loudest automatically
- Save min/maxStartTime in pickle and load if required

- Previously, the predict_fstat directed lalapps_PredictFstat to write
  the output to /tmp/fs. This caused failure when /tmp could not be
  written to so instead it writes it to a file in the working directory
  and then removes it

- Allow read_par to have strings in the value
- Fix bug in setting detector constraints
- If fkdot not given, attempt to create it

Fixes #4 .

- Provide a function in the BaseSearchClass to read in the ephemeris
  files
- Some clean up of docstrings

This helps with timing to see which functions are being called
repeatedly

- Adds return_type option to return (by default) a Bunch class such that
  the attributes can be accessed as `out.F0`, `out.F1` etc
- Improves documentation

This renames the input sftfilepath to sftfilepattern and adds
documentation on how that should be used, i.e. a colon separated list of
wildstring or exact matches. In globbing for all matches, the colon
split is added in. sftfilepath is still used by `Writer` since
an exact path is known.

Gregory Ashton authored Jul 17, 2017 and Gregory Ashton committed Jul 17, 2017

If there are multiple detectors, then multiple .sft files are generated.
This updates the attribute 'sftfilename' -> 'sftfilenames', a list of
those files while also updating 'sftpilpath' to a colon separated list
of the relevant sft files.

If there are multiple detectors, then multiple .sft files are generated.
This updates the attribute 'sftfilename' -> 'sftfilenames', a list of
those files while also updating 'sftpilpath' to a colon separated list
of the relevant sft files.

The command line argument is matched to formatting used by MFD to
reconstruct the argument (using .16g) formatting. Ideally, all REAL8
should use this formatting.

Removes the forced `int` for `fmin` in MFD. As noted by David, this
isn't required.

 -ported check from MCMC search
 -bug: for single-str SFT path, glob list comprehension
  was trying every single character

 -try-except wrapper for subprocess.check_output()
 -use this for MFDv5 call (properly terminate at error!)
 -and for other small utility calls
 -use unique variable names for cl strings too

 -first check $DISPLAY environment variable
 -then use non-interactive "AGG" backend if necessary

- Add peak detection utilities
- Move generate_loudest
- Add SSBprec pass through to MCMC searches
- Fix convergence stat (missing sqrt)
- Minor fixes to plot_walkers (put detection statistic behind walkers)

- Adds injectSources to a variety of other methods
- Adds conversion of injectSource to pfs_input

If the given tstart is before the minStartTime this will error - so
instead, select the minStartTime

Previously, if the data span was shorter than the requested tstart-tend,
the code would choke when attempting to calculate twoF over a range
without any data. Instead, the code now automatically only compute twoF
over a range with data in it.

1) Add ability to in F0s, F1s etc in grid search directly (use tuple as (is)
2) Update cumulative legend
3) Add option to produce pfs_input directly to calculate_pfs
4) Fix spelling mistake
5) Update transient example in the paper