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, which abstracts the data access regardless of their actual origin. Marvin Tools provide:

• Access to DRP Cubes and their spectra.

• Access to Row-stacked Spectra files.

• Access to DAP Maps and ModelCubes.

• Convenient access to all the DRP and DAP properties for a given Spaxel or Bin.

• The data delivered as Astropy quantities with the inverse variance and mask, as well as associated properties.

• Easy handling of maskbits and labels.

• DAP Map arithmetic.

• Autocompletion of properties and channels (powered by a datamodel).

• The ability to extract all spaxels within a region.

• Access to NSA and DRPall data.

• Access to contributed MaNGA VACS

• Easy data download.

The following sections explain how to use the tools in detail. They assume that you have read our Getting Started and are familiar with Astropy quantities.

Using the tools

• Cube
  • Initializing a Cube
  • Basic Attributes
  • The DataModel
  • DataCubes and Spectra
  • Extracting a Spaxel
  • Accessing Maps
  • Saving and Restoring
  • Reference/API
• Row-Stacked Spectra (RSS)
  • The RSS.obsinfo table
  • Accessing individual fibres
  • Lazy loading and autoload
  • Reference/API
• ModelCube
  • Initializing a ModelCube
  • Basic Attributes
  • The DataModel
  • Accessing an Individual Spaxel
  • The HYB10 bintype
  • Reference/API
• Maps
  • Initializing a Maps
  • Basic Attributes
  • Maps DataModel
  • Accessing an Individual Map
  • Accessing an Individual Spaxel
  • Getting Bin IDs
  • Accessing Other Marvin Objects for the Same Galaxy
  • Saving and Restoring
  • BPT Diagram
  • Reference/API
• Map
  • Initializing a Map
  • Basic Attributes
  • Accessing an Individual Spaxel
  • Accessing the Parent Maps Object
  • Map Arithmetic
  • Masking
  • Plotting
  • Saving and Restoring
  • Reference/API
  • EnhancedMap
• Plate
  • Getting Started
  • Using Plate
  • Reference/API
• Spaxel
  • Getting and working with spaxels
  • DataModels
  • Working with Bins
  • Reference/API
• Image
  • Getting Started
  • Using Image
  • Reference/API
• Value-Added Catalogs (VACS)
  • Target Specific VAC Access
  • Full Catalog VAC Access

Common Tools Features

• Data Access Modes
  • Auto Mode
  • Local Mode
  • Remote Mode
  • Mode Decision Tree
• Downloading Objects
  • Download Authentication
  • Via Config
  • Via Tools
  • Via Query Results
  • Via Explicit Call
• Pickling Marvin Instances
• Catalogue mixins
  • DRPall / NSA
  • DAPall
  • Value-Added Catalogs (VACS)
  • Reference
• Using getAperture
  • Defining apertures
  • Working with masks
  • More on getSpaxels
  • Reference
• Maskbits
  • Introduction
  • Getting Started
  • Using Maskbit
  • Reference/API
• Datamodel
  • Getting started with the datamodel
  • Datacubes, spectra, and properties
  • The maskbit datamodel
  • Using to_table()
  • Available datamodels
• Plotting Methods
  • Map (marvin.utils.plot.map)
  • Colorbar (marvin.utils.plot.colorbar)
  • Histogram Plotting
  • Scatter (marvin.utils.plot.scatter)
• Analysis Tools
  • BPT Diagrams
• Tools as Context-managers

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.

• 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.

Reference

Tools

marvin.tools.cube.Cube([input, filename, ...])	A class to interface with MaNGA DRP data cubes.
marvin.tools.rss.RSS([input, filename, ...])	A class to interface with a MaNGA DRP row-stacked spectra file.
marvin.tools.maps.Maps([input, filename, ...])	A class that represents a DAP MAPS file.
marvin.tools.modelcube.ModelCube([input, ...])	A class to interface with MaNGA DAP model cubes.
marvin.tools.image.Image([input, filename, ...])	A class to interface with MaNGA images.

Quantities

marvin.tools.quantities.analysis_props.AnalysisProperty(value)	A class describing a measurement with additional information.
marvin.tools.quantities.spectrum.Spectrum(...)	A class representing an spectrum with extra functionality.
marvin.tools.quantities.map.Map(array[, ...])	Describes 2D array object with addtional features.
marvin.tools.rss.RSSFiber(fiberid, rss, ...)	A Quantity representing a fibre observation.
marvin.tools.quantities.datacube.DataCube(...)	A Quantity-powered representation of a 3D data cube.

MixIns

marvin.tools.mixins.nsa.NSAMixIn([nsa_source])	A mixin that provides access to NSA paremeters.
marvin.tools.mixins.dapall.DAPallMixIn()	A mixin that provides access to DAPall paremeters.
marvin.tools.mixins.aperture.GetApertureMixIn()