Metadata-Version: 2.1
Name: vice
Version: 1.3.0rc2
Summary: Galactic Chemical Evolution Integrator
Home-page: https://github.com/giganano/VICE.git
Author: James W. Johnson
Author-email: giganano9@gmail.com
Maintainer: James W. Johnson
Maintainer-email: giganano9@gmail.com
License: MIT
Project-URL: Bug Tracker, https://github.com/giganano/VICE/issues
Project-URL: Documentation, https://vice-astro.readthedocs.io/
Project-URL: Source Code, https://github.com/giganano/VICE.git
Keywords: galaxies,simulations,abundances
Platform: Linux
Platform: Mac OS X
Platform: Unix
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Science/Research
Classifier: License :: OSI Approved :: MIT License
Classifier: Natural Language :: English
Classifier: Operating System :: MacOS
Classifier: Operating System :: POSIX
Classifier: Operating System :: Unix
Classifier: Programming Language :: C
Classifier: Programming Language :: Cython
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: Implementation :: CPython
Classifier: Topic :: Scientific/Engineering
Classifier: Topic :: Scientific/Engineering :: Astronomy
Classifier: Topic :: Scientific/Engineering :: Physics
Classifier: 
Provides: vice
Requires-Python: >=3.6.*, <4
License-File: LICENSE


VICE: Versatile Integrator for Chemical Evolution

* 77 elements on the periodic table
* Fast integration of one-zone models
* Enrichment from single stellar populations
* Highly flexible nucleosynthetic yield calculations
* User-defined mathematical forms describing:
	- Nucleosynthetic yields in simulations
	- Mixing processes in multi-zone models
	- Infall and star formation histories
	- The stellar initial mass function
	- The star formation law
	- Element-by-element infall metallicities
	- Type Ia supernova delay-time distributions

How to Access the Documentation:
--------------------------------
Documentation is available in several forms:

	1. Online: http://vice-astro.readthedocs.io
	2. In PDF format, available for download at the same address
	3. In the docstrings embedded within the software

Running ``vice --docs`` from the terminal will open the online documentation
in the default web browser.

First time users should go through VICE's QuickStartTutorial jupyter notebook,
available under examples/ in the git repository. This can be launched from
the command line by running ``vice --tutorial``. Other example scripts can
be found there as well.

Contents
--------
singlezone : ``object``
	Simulate a single-zone galactic chemical evolution model
multizone : ``object``
	Simulate a multi-zone galactic chemical evolution model
milkyway : ``object``
	A ``multizone`` object optimized for modeling the Milky Way.
output : ``object``
	Read and store output from ``singlezone`` simulations.
multioutput : ``object``
	Read and store output from ``multizone`` simulations.
migration : <module>
	Utilities for mixing prescriptions in multizone simulations.
single_stellar_population : <function>
	Simulate enrichment from a single conatal star cluster
cumulative_return_fraction : <function>
	Calculate the cumulative return fraction of a star cluster of known age
main_sequence_mass_fraction : <function>
	Calculate the main sequence mass fraction of a star cluster of known age
imf : <module>
	Built-in funcitonal forms of popular stellar initial mass functions.
mlr : ``object``
	Built-in popular function forms of the stellar mass-lifetime relationship.
	Also stores which form to adopt in chemical evolution models.
yields : <module>
	Calculate, access, and declare nucleosynthetic yield settings for use in
	simulations.
elements : <module>
	Access, and declare nucleosynthetic yield settings for use in simulations.
	Access other relevant information for each element such as the solar
	abundance or atomic number.
dataframe : ``object``
	A dictionary-like object with case-insensitive lookup and data storage.
history : <function>
	Reads in time-evolution of interstellar medium from singlezone simulation.
mdf : <function>
	Reads in stellar metallicity distribution from singlezone simulation.
stars : <function>
	Read in stellar population abundances from a multizone simulation output.
toolkit : <module>
	Generally useful utilities.

Built-In Dataframes
-------------------
- atomic_number : The atomic number of each element
- primordial : The abundance of each element following big bang nucleosynthesis.
- solar_z : The abundance of each element in the sun.
- sources : The primary astrophysical production channels of each element.
- stable_isotopes : Lists of each elements' stable isotopes.

Utilities
---------
- VisibleDeprecationWarning : A DeprecationWarning that is visible by default.
- VisibleRuntimeWarning : A RuntimeWarning that is visible by default.
- ScienceWarning : A Warning concerning scientific accuracy and precision.
- test : Runs VICE's unit tests.
- version : VICE's version breakdown.
- __version__ : The version string.


