OctApps

Welcome to OctApps, a library of Octave functions for continuous gravitational-wave data analysis.

Downloading

OctApps is hosted on GitHub. Please see the project homepage for instructions for checking out the repository with git clone.

Alternatively, a Docker image containing the latest version of OctApps can be obtained by running

$ docker pull ghcr.io/octapps/octapps:master

or built from source by running

$ docker build https://github.com/octapps/octapps.git

Dependencies

OctApps depends on the following packages for various purposes:

Building

To use any OctApps functions with Octave, first run

$ make

to generate the user environment setup scripts, then either add

$ . <your-path-to>/octapps/octapps-user-env.sh

to your ~/.profile file for Bourne shells (e.g. bash), or

$ source <your-path-to>/octapps/octapps-user-env.csh

to your ~/.login file for C shells (e.g. tcsh). You will also need to re-run make after any new directories are added to OctApps.

Testing

To execute the OctApps test suite, consisting of tests embedded in Octave function files, run

$ make check

You can also run the test suite for specific functions files:

$ make check TESTS=runCode

$ make check TESTS=src/general/runCode.m

or specific directories:

$ make check TESTDIR=src/general

The OctApps test suite is regularly executed via GitHub Actions. Current build status: .

Documentation

A reference manual for OctApps in HTML format is regularly generated from the master branch on GitHub. It includes tutorials on several important features of OctApps, documentation for each function in the library, and example usages.

Documentation can also be obtained from within Octave on any OctApps function by running

$ octave:1> help <name-of-function>

Example usage for many OctApps functions can be found in the embedded tests, which can be printed using

$ octave:1> test <name-of-function> verbose

Contributing

Contributions to OctApps are welcome. Bug reports and other requests for support should be raised on the issue tracker on GitHub. Bug fixes and new contributions should be submitted as pull requests to the main OctApps repository. Documentation for OctApps is embedded in Octave function files, and is written in Texinfo format.

Acknowledgement

If you make use of OctApps, please cite our paper in the Journal of Open Source Software:

@article{octapps, author = {Karl Wette and Reinhard Prix and David Keitel and Matthew Pitkin and Christoph Dreissigacker and John T. Whelan and Paola Leaci}, title = {{OctApps: a library of Octave functions for continuous gravitational-wave data analysis}}, journal = {Journal of Open Source Software}, year = {2018}, volume = {3}, number = {26}, pages = {707}, doi = {10.21105/joss.00707}, }