/jetset

JetSeT a framework for self-consistent modeling and fitting of astrophysical relativistic jets

Primary LanguageCBSD 3-Clause "New" or "Revised" LicenseBSD-3-Clause

Build Status

img

JetSeT is an open source C/Python framework to reproduce radiative and accelerative processes acting in relativistic jets,
allowing to fit the numerical models to observed data. The main features of this framework are:

  • handling observed data: re-binning, definition of data sets, bindings to astropy tables and quantities definition of complex numerical radiative scenarios: Synchrotron Self-Compton (SSC), external Compton (EC) and EC against the CMB

  • Constraining of the model in the pre-fitting stage, based on accurate and already published phenomenological trends. In particular, starting from phenomenological parameters, such as spectral indices, peak fluxes and frequencies, and spectral curvatures, that the code evaluates automatically, the pre-fitting algorithm is able to provide a good starting model,following the phenomenological trends that I have implemented. fitting of multiwavelength SEDs using
    both frequentist approach (iminuit) and bayesian MCMC sampling (emcee)

  • Self-consistent temporal evolution of the plasma under the effect of radiative and accelerative processes, both first
    order and second order (stochastic acceleration) processes.

Acknowledgements

If you use this code in any kind of scientific publication please cite the following papers:

Documentation

visit: https://jetset.readthedocs.io/en/latest/

Requirements

The following python packages are required:

      python 2.7 or >=3.6 (python 3 is suggested, python 2 should work still fine)
      scipy
      numpy
      astropy
      iminuit (https://github.com/iminuit/iminuit)

A C compiler is also necessary, plus the SWIG wrapper generator.

All the dependencies can be installed following the Anaconda method (suggested) OR the pip method, as described in the following sections.

Install the JetSeT code

Download the code

Installation using Anaconda (suggested method)

  • I suggest to use anaconda and python3

  • https://www.anaconda.com/download/

  • Uncompress the archive jetset-stable.tar.gz

  • cd to the dir jetset-stable

  • Install requirements

    • Linux/MAC : run on the command line

      • while read requirement; do conda install --yes $requirement; done < requirements.txt

    • Windows : run on the command line

      • FOR /F "delims=~" %f in (requirements.txt) DO conda install --yes "%f"
  • Install JetSeT:

    run on the command line:

    • python setup.py clean
    • python setup.py install

run all the examples outside of the installation dir

Installation using PIP

  • cd to the dir jetset-stable

  • Install requirements

    • run on the command line: pip install -r requirements.txt

    • if pip fails to install swig you can try one of the following methods

      • SWIG (http://www.swig.org/)
      • on linux Ubuntu:
        • sudo apt-get install python-dev
        • sudo apt-get install swig
      • on linux Debian:
        • sudo aptitude install python-dev
        • sudo aptitude install swig
      • on linux Fedora:
        • sudo yum install python-dev
        • sudo yum install swig
      • on mac:
        • ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)" < /dev/null 2> /dev/null
        • brew install swig
  • Install JetSeT:

    run on the command line:

    • python setup.py clean
    • python setup.py install

run all the examples outside of the installation dir

jetset code repoistory

The code is hosted here:

OR

Build documentation

requires: