Package: sdss-marvin
Marvin is the ultimate tool to visualise and analyse MaNGA data. It is
developed and maintained by the MaNGA team.InstallationTo install Marvin:pip install sdss-marvinIf you would like to contribute to Marvin’s development, you can clone
this git repo, and run pip install in editable mode which will install all the
dev dependencies:git clone https://github.com/sdss/marvin
cd marvin
pip install -e ".[dev,web,db]"This will install all dependencies needed for development and testing, including for
the Marvin web/api server and the Marvin use of the MaNGA database.TestingTo run the test suite on Marvin, usepytest tests/.  By default this will run all tests against
Marvin’s core file access mode, as well as its database and remote access modes. The test suite uses
the following two galaxies:8485-1901and7443-12701for testing. To successfully run all tests
you will need:The file data for the two test galaxiesA local MaNGA database with the galaxy loaded into itA local Marvin web server runningYou can download the necessary test data with the command.python bin/get_test_data.pyYou can run a local Marvin web server with the following command.  This will start a local web server running
in debug mode on port 5000.cd bin/
run_marvin -d -p 5000You can disable database and web server tests by using Pytest markers.  The availble markers and options are:slow: Run only slow tests.uses_db: Run only tests that use the database.uses_web: Run only tests that use the web/api server.–local-only: Run only tests that use local data.To run the test suite minimally against the core marvin package with local file access, use the following command:pytest --local-only -m "not uses_db and not uses_web and not slow" tests/What is Marvin?Marvin is a complete ecosystem designed for overcoming the challenge of
searching, accessing, and visualizing the MaNGA data. It consists of a
three-pronged approach of a web app, a python package, and an API. The
web app, Marvin-web, provides an easily accessible interface for
searching the MaNGA data and visual exploration of individual MaNGA
galaxies or of the entire sample. The python package, in particular
Marvin-tools, allows users to easily and efficiently interact with the
MaNGA data via local files, files retrieved from theScience Archive
Server, or data directly grabbed from the
database. The tools come mainly in the form of convenience functions and
classes for interacting with the data. An additional tool is a powerful
query functionality that uses the API to query the MaNGA databases and
return the search results to your python session. Marvin-API is the
critical link that allows Marvin-tools and Marvin-web to interact with
the databases, which enables users to harness the statistical power of
the MaNGA data set.DocumentationYou can find the latest Marvin documentationhere.Citation and AcknowledgementsIf you use Marvin for work/research presented in a publication (whether
directly, or as a dependency to another package), we ask that you cite
theMarvin Software(BibTeX). We
provide the following as a standard acknowledgment you can use if there
is not a specific place to cite the DOI:*This research made use of Marvin, a core Python package and web framework for MaNGA data, developed by Brian Cherinka, José Sánchez-Gallego, Brett Andrews, and Joel Brownstein. (MaNGA Collaboration, 2018).*Marvin’s Bibtex entry to use:@ARTICLE{2019AJ....158...74C,
       author = {{Cherinka}, Brian and {Andrews}, Brett H. and
         {S{\'a}nchez-Gallego}, Jos{\'e} and {Brownstein}, Joel and
         {Argudo-Fern{\'a}ndez}, Mar{\'\i}a and {Blanton}, Michael and
         {Bundy}, Kevin and {Jones}, Amy and {Masters}, Karen and
         {Law}, David R. and {Rowlands}, Kate and {Weijmans}, Anne-Marie and
         {Westfall}, Kyle and {Yan}, Renbin},
        title = "{Marvin: A Tool Kit for Streamlined Access and Visualization of the SDSS-IV MaNGA Data Set}",
      journal = {\aj},
     keywords = {astronomical databases: miscellaneous, methods: data analysis, surveys, Astrophysics - Instrumentation and Methods for Astrophysics, Astrophysics - Astrophysics of Galaxies},
         year = 2019,
        month = aug,
       volume = {158},
       number = {2},
          eid = {74},
        pages = {74},
          doi = {10.3847/1538-3881/ab2634},
archivePrefix = {arXiv},
       eprint = {1812.03833},
 primaryClass = {astro-ph.IM},
       adsurl = {https://ui.adsabs.harvard.edu/abs/2019AJ....158...74C},
      adsnote = {Provided by the SAO/NASA Astrophysics Data System}
}LicenseMarvin is licensed under a 3-clause BSD style license - see theLICENSE.mdfile.