jdaviz

repository·main·Indexed 41 days ago

https://github.com/spacetelescope/jdaviz

A package of astronomical data analysis visualization tools based on the Jupyter platform. It provides a GUI-based interface for interactive data analysis that works in Jupyter notebooks, as a standalone desktop application, or embedded in websites. The package includes specialized layouts like Cubeviz for 3D data cubes, offering tools for spectral extraction, model fitting, and aperture photometry, with programmatic access via User and Reference APIs.

Tokens
124.7K
Snippets
451
Records
648
Agent score
52%

What's inside jdaviz

  1. What is Specviz?

    main

    Specviz is a tool designed for the visualization and quick-look analysis of 1D astronomical spectra. It combines interactive visualization with analysis capabilities by integrating with packages like Astropy (specifically regions) and specutils.

    Key features include:

    • Flexible Plotting: Supports spectral unit conversions and custom plotting attributes.
    • Interactive Analysis: Includes tools for interactive selections and multiple plots.
    • Spectral Line Measurement: A dedicated tool that allows users to perform and record measurements with a few mouse actions.
    • Model Fitting: Capability to create simple (e.g., single Gaussian) or multi-component models (e.g., multiple Gaussians for emission/absorption lines and flat continua).
    • Workflow Integration: Designed for a workflow where users explore data in Specviz and then transition to scripting complex measurements or modeling using specutils. Data can be imported into and exported from the tool to maintain continuity in a notebook environment.
  2. Overview of Specviz2D for 2D astronomical spectra

    main

    Specviz2D is a tool designed for the visualization and quick-look analysis of 2D astronomical spectra. It combines interactive visualization tools with powerful analysis capabilities by integrating with the following packages:

    • Astropy regions: For defining and managing spatial regions.
    • specreduce: For spectral reduction tasks.
    • specutils: For spectral analysis.

    A key feature of Specviz2D is its ability to perform interactive spectral extraction from 2D spectra.

  3. Overview of Imviz for astronomical image visualization

    main

    Imviz is a tool designed for the visualization and analysis of 2D astronomical images. It combines interactive visualization tools with powerful analysis capabilities by incorporating packages like astropy (for regions) and photutils.

    Key features include:

    • Interactive Analysis: Users can interact with data directly within the tool.
    • Programmatic Access: Imviz provides programmatic access to its viewers via the Astrowidgets API. For specific functionality, refer to the AstrowidgetsImageViewerMixin class.
    • Data Workflow: Supports importing data into the tool and exporting data out of it, allowing users to integrate Imviz into their existing notebook-based workflows.
  4. Overview of Rampviz Data Analysis Plugins

    main

    Rampviz includes several specialized plugins for data analysis and visualization:

    • Metadata Viewer: Used for inspecting data metadata.
    • Plot Options: Provides per-viewer and per-layer plotting controls (e.g., toggling axes).
    • Subset Tools: Enables the use of subsets within Jdaviz.
    • Markers: Provides tools for placing and managing markers.
    • Slice: Provides slicing capabilities for data visualization.
    • Ramp Extraction: A quick-look tool for extracting ramps from ramp cubes.
  5. Overview of Cubeviz

    main

    Cubeviz is a visualization and analysis toolbox specifically designed for data cubes from integral field units (IFUs), such as those from the NIRSpec and MIRI instruments on JWST. It is built on top of the glue visualization tool and utilizes the specutils package from Astropy.

    Key capabilities include:

    • Visualization: View wavelength slices (RA, DEC), view flux/error/data quality cubes simultaneously, and create/display contour maps.
    • Analysis: Smooth cubes spatially and spectrally, collapse cubes over wavelength regions, fit spectral lines, and fit models to every spaxel.
    • Spectral Extraction: View spectra from selected spatial (RA, DEC) regions and overlay spectral line lists.
    • Map Generation: Create moment maps, including line flux and kinematic maps (rotation velocity and velocity dispersion).
    • Output: Save edited cubes and save figures.
  6. Overview of Specviz2D Data Analysis Plugins

    main

    Specviz2D provides several plugins for quick-look analysis of 2D spectroscopic data, accessible via the plugin icon in the upper right corner of the Specviz2d application.

    Available plugins include:

    • Metadata Viewer: For inspecting data metadata (links to Imviz documentation).
    • Plot Options: For configuring plot displays (links to Specviz documentation).
    • Subset Tools: For managing data subsets (links to Imviz documentation).
    • Markers: For adding markers (links to Imviz documentation).
    • 2D Spectral Extraction: For tracing, background subtraction, and extraction.
    • Gaussian Smooth: For smoothing data (links to Specviz documentation).
    • Model Fitting: For fitting models (links to Specviz documentation).
    • Unit Conversion: For changing data units (links to Specviz documentation).
    • Line Lists: For viewing line lists (Note: disabled if 1D spectrum x-axis is in pixels).
    • Line Analysis: For analyzing lines (Note: disabled if 1D spectrum x-axis is in pixels).
    • Export: For exporting plots to various image formats.
  7. Overview of Rampviz

    main
    Rampviz is a visualization and analysis toolbox specifically designed for processing and analyzing ramp cubes from infrared detectors. It is optimized for working with ramp files originating from the Roman Space Telescope and the James Webb Space Telescope (JWST). Rampviz is built upon the glue visualization tool.
  8. Inspect data using Jdaviz Data Information Tools

    main

    Jdaviz includes several tools designed for inspecting and interacting with loaded datasets within the UI:

    • Metadata Viewer: Allows you to view FITS headers and other metadata associated with your loaded datasets.
    • Interactive Markers: Enables you to place markers on images and spectra to identify points of interest and extract information from specific locations.
    • Logger: Provides access to system messages, warnings, and errors generated during Jdaviz operations.
  9. Navigate the Mosviz User Interface

    main

    The Mosviz UI is organized into three main functional areas:

    1. Image Viewer (Top Left): Provides image viewing capabilities similar to Cubeviz. It includes a Slit Overlay feature that plots slit geometry based on data from a linked 2D spectrum file.
    2. Spectrum Viewers (Top Right): Contains a 2D spectrum viewer positioned above a 1D spectrum viewer. The x-axes of these two viewers are synchronized; panning or zooming the x-axis in one viewer automatically applies the same action to the other.
    3. Table Viewer (Bottom): Displays tabular data used to control the other viewers.
  10. Access Imviz Data Analysis Plugins

    main

    Imviz provides several plugins for quick-look analysis of 2D image data. These can be accessed via the plugin icon in the upper right corner of the Imviz application UI.

    Available Plugins:

    • Metadata Viewer: View metadata associated with selected data. Includes a Show primary header toggle for multi-extension FITS.
    • Plot Options: Access per-viewer and per-layer plotting options.
    • Data Quality: Visualize and filter data quality flag arrays.
    • Subset Tools: Create, modify, and recenter data subsets.
    • Markers: Log pixel/world coordinates and measure distances between points.
    • Orientation: Align layers by pixels or WCS (sky) and apply sky rotation.
  11. Customize jdaviz plots and display units

    main

    Jdaviz allows you to customize your analysis environment through two primary configuration categories:

    1. Plot Options: Use these to control the visual appearance of plots, such as colors, line styles, markers, and other display properties.
    2. Display Units: Use these to configure the units used for displaying spectral axes (e.g., wavelength, frequency, energy) and flux values.

    Detailed configuration for each is available in the plot_options and display_units documentation sections.

  12. Overview of jdaviz viewers and capabilities

    main

    jdaviz is a GUI-based astronomical data analysis visualization tool that provides several types of viewers:

    • Image viewers: Support 2D images with tools for panning, zooming, aperture photometry, and catalogs.
    • Spectrum viewers: Support 1D and 2D spectra with tools for extraction, measuring spectral features, and line fitting.
    • Cube viewers: Provide views of spectroscopic data cubes (e.g., JWST MIRI) along with extracted 1D spectra.
    • Table, Scatter, and Histogram viewers: Allow interactive exploration of tabular data and source catalogs.
    • Mosviz: A standalone configuration (not yet integrated into the main application in v5.0) for visualizing many astronomical spectra, such as multi-object spectrograph outputs (e.g., JWST NIRSpec).