Metadata-Version: 2.4
Name: xdust
Version: 1.0
Summary: Library of dust scattering codes
Author-email: Lia Corrales <liac@umich.edu>
License: BSD 2-clause
Project-URL: Homepage, https://github.com/eblur/xdust
Project-URL: Documentation, https://eblur.github.io/xdust
Requires-Python: >=3.7
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: numpy
Requires-Dist: astropy
Requires-Dist: scipy
Requires-Dist: matplotlib
Provides-Extra: dev
Requires-Dist: pytest>=7.0; extra == "dev"
Provides-Extra: docs
Requires-Dist: sphinx>=7.0; extra == "docs"
Requires-Dist: furo; extra == "docs"
Requires-Dist: sphinx-autodoc-typehints; extra == "docs"
Requires-Dist: sphinx-autobuild; extra == "docs"
Requires-Dist: myst-nb; extra == "docs"
Dynamic: license-file

# Xdust


*Previously eblur/newdust* 

[![DOI](https://zenodo.org/badge/DOI/10.5281/zenodo.7500048.svg)](https://doi.org/10.5281/zenodo.7500048) 

This package calculates extinction curves and small-angle scattering halos from a user-defined dust grain size distribution. It calculates scattering and absorption from first principles (optical constants of the material, Mie or Rayleigh-Gans scattering).

**Updated 2026.06** to by installable via PyPI and documented with Sphinx

**Documentation:** https://eblur.github.io/xdust

## Installation

### Typical installation

```
pip install xdust
```

### For developers

If you need to stay up to date with development versions of xdust, use:

```
git clone https://github.com/eblur/xdust.git

cd xdust

pip install -e .
```

## To invoke:

```
import xdust
```

## How to use:

See the jupyter notebooks in **examples/** 
for examples of setting up grain populations and modeling scattering halos from Galactic dust.
