Skip to main content

Set of analysis tools of MRS data

Project description

Documentation Status

AstroCabTools

Set of tools made in order to:

  • Integrate processing tools, algorithms, visualization and data analysis of images and 3D infrarred spectroscopy for the James Webb Espacial Telescope (JWST).
  • Integration of JWST calibrated data and advance products into astronomics data bases and astrophisics specialized packages.
  • Develop procedures to the JWST data combination and the joint analysis of large volumnes of data.
  • Simulation and study of observationes made from the MIRI tool of the JWST with the MIRISim simulator.

Tools

  • mrs_chan.py - To identify wich channels from the MRS range, an emitted wavelenth is (BETA version).
  • mrs_spec_chan.py - Visualization of relationship emitted wavelength and density flux associate (BETA version).
  • mrs_det_plot.py - Manipulation of astronomic images based of frame and integration values (BETA version).
  • fit_line.py - Representation of multiple gauss fitted models based on an spectrum.
  • cube_ans.py - Representation and analysis of miri cubes
  • mrs_subviz.py - Representation and analysis of all MRS subbands
  • quick_spec.py - Easy representation of spectra with specific format and from fit__line, cube_ans and mrs_subviz
  • all_tools - Interface that allows to load each tool without using command line.

Packages used

For each tool, this repo uses a number of libraries and packages on python:

  • PyQt - Binding of C++ GUI library
  • Numpy - Library that allow large data manipulation
  • Matplotlib - Graph visualization library.
  • Astropy - Collection of software packages used for astronomy
  • Seaborn - Statistical data visualization
  • Lmfit - Non-Linear Least-Squares Minimization and Curve-Fitting for Python
  • PyPuSub - A Python publish-subcribe library
  • Photutils - Package that provides tools for detecting and performing photometry of astronomical sources.
  • jwst - Package to structurize cube models and transform data from pixel to coordinates and vice versa

Tested with

  • Python (tested for 3.7.0)
  • Matplotlib (tested for 3.1.2)
  • Numpy (tested for 1.81.1)
  • PyQt5 (tested for 5.14.0)
  • Seaborn (tested for 0.9.0)
  • lmfit (tested for 1.0.0)
  • PyPubSub (tested for 4.0.3)
  • Photutils (tested for 1.1.0)
  • jwst (tested for 1.3.3)

We have detected a problem with older versions of Mac not working with newer versons of pip because it can not found any version of matplotlib avaliable, for this case it is recommended to create an enviroment with a pip version no more than 20.2.2.

How to install and execute

It is recommended to install and execute the tools in a clean enviroment with Anaconda or similar to prevent the conflict of package versions.

If you have plans to use Anaconda, simply follow this steps once you activate it:

  1. Create the environment with conda create --name myenv python=3.7 (replace myenv with the environment name)
  2. Activate the environment with conda activate myenv or source activate myenv if the previous one did not work (replace myenv with the environment name)
  3. Install and execute one of the tools from AstroCabTools following the instructions below

If you are already in your conda environment or you do not need to, follow the next steps to install and execute the tools from AstroCabTools:

  1. Open the terminal and write pip install AstroCabTools
  2. Once all the libraries had been updated and the package installed, to execute each program, the next commands need to be written on the terminal:
  • bandChan to execute mrs_chan.
  • specChan to execute mrs_spec_chan.
  • detPlot to execute mrs_det_plot.
  • fitLine to execute fit_line.
  • cubeAns to execute cube_ans.
  • subViz to execute mrs_subviz.
  • quick_spec to execute quick_spec.
  • allTools to execute all_tools.

Manually installation

If your plan is to download from this repository and install it manually, execute pip install . inside the folder. Rather than using the python install, this makes all the packages to be installed in the same folder where the libraries can not find any problem of not finding libraries where they should be.

Templates

Templates for different tools can be downloaded in the next links and in the documentation.

Mrs_spec_chan templates

The templates for this tool can be downloaded from this link.

Mrs_det_plot templates

The templates for this tool can be downloaded from this link.

Fit_line templates

The templates for this tool can be downloaded from this link.

Cube_ans and mrs_subviz templates

The templates for this tools can be downloaded from this link.

Development

To dos

New:

  • <input type="checkbox" disabled="" /> Online documentation

Done:

  • mrs_chan features:

    • <input type="checkbox" checked="" disabled="" /> Specific wavelength location inside mrsSpec channels
  • mrs_spec_chan features:

    • <input type="checkbox" checked="" disabled="" /> Representation and management of spectra on a range of wavelength values
  • <input type="checkbox" checked="" disabled="" />

    Representation of specific observed wavelengths selected on the plot

  • <input type="checkbox" checked="" disabled="" />

    Representation of specific lines of interest from a list on the plot

  • <input type="checkbox" checked="" disabled="" />

    Management of different specification ranges where each plot is going to appear

  • mrs_det_plot features:

    • <input type="checkbox" checked="" disabled="" /> Visualization of multiple .fits images
    • <input type="checkbox" checked="" disabled="" /> Management of the scale, stretch and colour of all the images
    • <input type="checkbox" checked="" disabled="" /> Visualization of values selected on an specified image along each axis
  • fit_line features:

    • <input type="checkbox" checked="" disabled="" /> Make gauss, double gauss, lorentz, lorentz + gauss, line and quadratic fitting model based on five points from an spectrum
    • <input type="checkbox" checked="" disabled="" /> Represent all models
  • cube_ans features:

    • <input type="checkbox" checked="" disabled="" /> MIRI, MEGARA and MUSE cube representation
    • <input type="checkbox" checked="" disabled="" /> Possibility to make aperture from an area selected
    • <input type="checkbox" checked="" disabled="" /> Creation of annulus background for subtraction from the initial area selected
    • <input type="checkbox" checked="" disabled="" /> Representation of the initial spectrum or the resultant from the subtraction in the fit_line tool
    • <input type="checkbox" checked="" disabled="" /> Obtain image based on the sum of flux for each pixel along a range of wavelength values
  • mrs_subviz features:

    • <input type="checkbox" checked="" disabled="" /> Representation of all 12 subbands of the MRS channels in same interface
    • <input type="checkbox" checked="" disabled="" /> Possibility to make aperture operation on all subbands at the same time
    • <input type="checkbox" checked="" disabled="" /> Creation of annulus background for subtraction from the initial area selected from each cube
    • <input type="checkbox" checked="" disabled="" /> Representation of the initial spectrum or the resultant from the subtraction for each cube
  • quick_spec features:

    • <input type="checkbox" checked="" disabled="" /> Representation of spectra that follows the same pattern as the ones that fit_line, cube_ans and mrs_subViz generates in order to interact with it(zoom and pan)
  • all_tools features:

    • <input type="checkbox" checked="" disabled="" /> Execute each one of the four programs independently

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for AstroCabTools, version 1.5.0
Filename, size File type Python version Upload date Hashes
Filename, size AstroCabTools-1.5.0.tar.gz (65.6 MB) File type Source Python version None Upload date Hashes View
Filename, size AstroCabTools-1.5.0-py3-none-any.whl (8.7 MB) File type Wheel Python version py3 Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page