Skip to content

Latest commit

 

History

History
118 lines (79 loc) · 3.83 KB

index.rst

File metadata and controls

118 lines (79 loc) · 3.83 KB
Raw

Galaxy Tools

Marvin Tools provide the core functionality for accessing MaNGA data with Marvin. At the lowest level they are class wrappers around data products or elements (DRP datacubes, DAP maps, and spaxels). Their purpose is to provide a more natural way to interact with the data, unconstrained by specific data storage architectures such as files or databases. The tools are built on top of the data access modes <marvin-dam>, which abstracts the data access regardless of their actual origin. Marvin Tools provide:

  • Access to DRP Cubes <marvin-cube> and their spectra.
  • Access to Row-stacked Spectra <marvin-rss> files.
  • Access to DAP Maps <marvin-maps> and ModelCubes <marvin-modelcube>.
  • Convenient access to all the DRP and DAP properties for a given Spaxel or Bin <marvin-spaxel>.
  • The data delivered as Astropy quantities <marvin-quantities> with the inverse variance and mask, as well as associated properties.
  • Easy handling of maskbits <marvin-maskbit> and labels.
  • DAP Map arithmetic <marvin-enhanced-map>.
  • Autocompletion of properties and channels (powered by a datamodel).
  • The ability to extract all spaxels within a region <marvin-get-aperture>.
  • Access to NSA and DRPall data.
  • Access to contributed MaNGA VACS<marvin-vacs>
  • Easy data download <marvin-download-objects>.

The following sections explain how to use the tools in detail. They assume that you have read our marvin-getting_started and are familiar with Astropy quantities <marvin-quantities>.

:rubric-h2:Using the tools

cube rss modelcube maps map plate spaxel image vacs

:rubric-h2:Common Tools Features

../core/data-access-modes

downloads pickling

catalogues

aperture

utils/maskbit

datamodel

utils/plotting analysis_tools

context

:rubric-h2:Visual guide

All object- and search-based tools in Marvin are linked together. To better understand the flow amongst the various Tools, here is a visual guide.

marvin visual guide

  • The red squares and green squares indicate the set of Marvin Tools available.
  • The orange circles highlight how each Tool links together via a method or an attribute. In each transition link, a lowercase Tool name represents an instantiation of that tool, e.g. cube = Cube(). To go from a Marvin Cube to a Marvin Spaxel, you can use the cube.getSpaxel method or the cube[x,y] notation. Conversely, to go from a Spaxel to a Cube, you would use the spaxel.cube attribute. Single or bidirectional arrows tell you which directions you can flow to and from the various tools.
  • Purple circles represent display endpoints. If you want to display something, this shows you how which tool the plotting command is connected to, and how to navigate there.

:rubric-h2:Reference

:rubric-h3:Tools

marvin.tools.cube.Cube marvin.tools.rss.RSS marvin.tools.maps.Maps marvin.tools.modelcube.ModelCube marvin.tools.image.Image

:rubric-h3:Quantities

marvin.tools.quantities.analysis_props.AnalysisProperty marvin.tools.quantities.spectrum.Spectrum marvin.tools.quantities.map.Map marvin.tools.rss.RSSFiber marvin.tools.quantities.datacube.DataCube

:rubric-h3:MixIns

marvin.tools.mixins.nsa.NSAMixIn marvin.tools.mixins.dapall.DAPallMixIn marvin.tools.mixins.aperture.GetApertureMixIn