Installation:

Choose which shell script you want to run: 
burst_install.sh for .bash_profile,
burst_install.csh for .cshrc, or 
burst_install.zsh for .zshrc

Then use the following commands where '*' is sh,csh,or zsh:
chmod +x burst_install.*
./burst_install.*

The script will ask whether doing a Heasoft install or Python package install.
After running the script, be sure to source the appropriate shell file or
open a new terminal before continuing.

Usage:

NOTE: CALDB and CALDBCONFIG must be set in the local environment for use!

---Heasoft---
Command-line:
The Heasoft tasks available are: bcrebevt, bctimebst, and bcprod.
Like all other Heasoft tasks, one can use command-line to call a task:
taskname param1=val1 param2=val2 ...

or type the task name by itself and follow the prompt for inputs:
taskname
Give value for parameter 1:
...

For a list of all parameters and usage for a given task, type the following:
fhelp taskname

Heasoftpy:
These tasks may also be called within a Python environment through Heasoftpy.
A detailed explanation may be found here: https://heasarc.gsfc.nasa.gov/lheasoft/heasoftpy/

An example for bcrebevt:
import heasoftpy as hsp

bcrebevt = hsp.HSPTASK('bcrebevt')
bcrebevt(infile='@data.lis',outprefix='test',....)
result = bcrebevt()

---Python---
Command-line -
The tasks bc_rebevt, bc_timebst, and bc_prod can be called via command-line. 
Similar to runnning a Heasoft task, the tasks may be called in a similar fashion:
taskname --param1=val1 --param2=val2 ...

or type the task name by itself and follow the prompt for inputs:
taskname
Give value for parameter 1:
...

For a list of all parameters and usage for a given task, do the following:
taskname -h

which will show the help message for a given task.

Within Python environment - 
Since this is also a python package, the tasks may be imported into a Python script by doing the following:

from burstcube.bctasks import taskname

where taskname can be one of the following:bcrebevt, bctimebst, or bcprod.

The task can then be called within Python:
result = taskname(param1=val1,param2=val3,...)

where result is either 1 for an error or 0 for no errors.
