Interstellar Dust Attenuation¶
dust_attenuation
is a python package to provide models of interstellar dust
attenuation curves.
Attenuation describes the effects of dust on a group of stars or a star with circumstellar dust. The effects include in attenuation are dust absorption, dust scattering out of the line-of-sight, and dust scattering into the line-of-sight. In general, attenuation models are used to model or correct the effects of dust on observations of galaxies (or regions thereof).
In contrast, dust extinction refers to the effects of dust on measurements of a single star. See Attenuation versus Extinction. For extinction models, see the dust_extinction package.
This package is developed in the astropy affiliated package template and uses the astropy.modeling framework.
User Documentation¶
Installation¶
Repository¶
GitHub: dust_attenuation
Quick Start¶
Need to add.
Reporting Issues¶
If you have found a bug in dust_attenuation
please report it by creating a
new issue on the dust_attenuation
GitHub issue tracker.
Please include an example that demonstrates the issue sufficiently so that the developers can reproduce and fix the problem. You may also be asked to provide information about your operating system and a full Python stack trace. The developers will walk you through obtaining a stack trace if it is necessary.
Contributing¶
If you have found a bug in dust_attenuation
please report it by creating a
new issue on the dust_attenuation
GitHub issue tracker.
Please include an example that demonstrates the issue sufficiently so that the developers can reproduce and fix the problem. You may also be asked to provide information about your operating system and a full Python stack trace. The developers will walk you through obtaining a stack trace if it is necessary.
Contributing¶
Like the Astropy project, dust_attenuation
is made both by and for its
users. We accept contributions at all levels, spanning the gamut from fixing a
typo in the documentation to developing a major new feature. We welcome
contributors who will abide by the Python Software Foundation Code of Conduct.
dust_attenuation
follows the same workflow and coding guidelines as
Astropy. Take a look at the astropy
developer documentation for
guidelines.
For the complete list of contributors please see the dust_attenuation contributors page on Github.
Reference API¶
dust_attenuation.averages Module¶
Classes¶
|
Attenuation curve of Calzetti et al. (2000). |
|
Attenuation curve of Leitherer et al. (2002). |
Class Inheritance Diagram¶
digraph inheritancefa1a2e49e5 { bgcolor=transparent; rankdir=LR; size="8.0, 12.0"; "BaseAttAvModel" [URL="api/dust_attenuation.baseclasses.BaseAttAvModel.html#dust_attenuation.baseclasses.BaseAttAvModel",fillcolor=white,fontname="Vera Sans, DejaVu Sans, Liberation Sans, Arial, Helvetica, sans",fontsize=10,height=0.25,shape=box,style="setlinewidth(0.5),filled",target="_top",tooltip="Base attenuation Av Model. Do not use."]; "BaseAttModel" -> "BaseAttAvModel" [arrowsize=0.5,style="setlinewidth(0.5)"]; "BaseAttModel" [URL="api/dust_attenuation.baseclasses.BaseAttModel.html#dust_attenuation.baseclasses.BaseAttModel",fillcolor=white,fontname="Vera Sans, DejaVu Sans, Liberation Sans, Arial, Helvetica, sans",fontsize=10,height=0.25,shape=box,style="setlinewidth(0.5),filled",target="_top",tooltip="Base Attenuation Model. Do not use."]; "Fittable1DModel" -> "BaseAttModel" [arrowsize=0.5,style="setlinewidth(0.5)"]; "C00" [URL="api/dust_attenuation.averages.C00.html#dust_attenuation.averages.C00",fillcolor=white,fontname="Vera Sans, DejaVu Sans, Liberation Sans, Arial, Helvetica, sans",fontsize=10,height=0.25,shape=box,style="setlinewidth(0.5),filled",target="_top",tooltip="Attenuation curve of Calzetti et al. (2000)"]; "BaseAttAvModel" -> "C00" [arrowsize=0.5,style="setlinewidth(0.5)"]; "Fittable1DModel" [URL="https://docs.astropy.org/en/stable/api/astropy.modeling.Fittable1DModel.html#astropy.modeling.Fittable1DModel",fillcolor=white,fontname="Vera Sans, DejaVu Sans, Liberation Sans, Arial, Helvetica, sans",fontsize=10,height=0.25,shape=box,style="setlinewidth(0.5),filled",target="_top",tooltip="Base class for one-dimensional fittable models."]; "FittableModel" -> "Fittable1DModel" [arrowsize=0.5,style="setlinewidth(0.5)"]; "FittableModel" [URL="https://docs.astropy.org/en/stable/api/astropy.modeling.FittableModel.html#astropy.modeling.FittableModel",fillcolor=white,fontname="Vera Sans, DejaVu Sans, Liberation Sans, Arial, Helvetica, sans",fontsize=10,height=0.25,shape=box,style="setlinewidth(0.5),filled",target="_top",tooltip="Base class for models that can be fitted using the built-in fitting"]; "Model" -> "FittableModel" [arrowsize=0.5,style="setlinewidth(0.5)"]; "L02" [URL="api/dust_attenuation.averages.L02.html#dust_attenuation.averages.L02",fillcolor=white,fontname="Vera Sans, DejaVu Sans, Liberation Sans, Arial, Helvetica, sans",fontsize=10,height=0.25,shape=box,style="setlinewidth(0.5),filled",target="_top",tooltip="Attenuation curve of Leitherer et al. (2002)."]; "BaseAttAvModel" -> "L02" [arrowsize=0.5,style="setlinewidth(0.5)"]; "Model" [URL="https://docs.astropy.org/en/stable/api/astropy.modeling.Model.html#astropy.modeling.Model",fillcolor=white,fontname="Vera Sans, DejaVu Sans, Liberation Sans, Arial, Helvetica, sans",fontsize=10,height=0.25,shape=box,style="setlinewidth(0.5),filled",target="_top",tooltip="Base class for all models."]; }dust_attenuation.radiative_transfer Module¶
Classes¶
|
Attenuation curve of Witt & Gordon (2000) |
Class Inheritance Diagram¶
digraph inheritance8af6306cd7 { bgcolor=transparent; rankdir=LR; size="8.0, 12.0"; "BaseAttModel" [URL="api/dust_attenuation.baseclasses.BaseAttModel.html#dust_attenuation.baseclasses.BaseAttModel",fillcolor=white,fontname="Vera Sans, DejaVu Sans, Liberation Sans, Arial, Helvetica, sans",fontsize=10,height=0.25,shape=box,style="setlinewidth(0.5),filled",target="_top",tooltip="Base Attenuation Model. Do not use."]; "Fittable1DModel" -> "BaseAttModel" [arrowsize=0.5,style="setlinewidth(0.5)"]; "BaseAtttauVModel" [URL="api/dust_attenuation.baseclasses.BaseAtttauVModel.html#dust_attenuation.baseclasses.BaseAtttauVModel",fillcolor=white,fontname="Vera Sans, DejaVu Sans, Liberation Sans, Arial, Helvetica, sans",fontsize=10,height=0.25,shape=box,style="setlinewidth(0.5),filled",target="_top",tooltip="Base attenuation tau_V Model. Do not use."]; "BaseAttModel" -> "BaseAtttauVModel" [arrowsize=0.5,style="setlinewidth(0.5)"]; "Fittable1DModel" [URL="https://docs.astropy.org/en/stable/api/astropy.modeling.Fittable1DModel.html#astropy.modeling.Fittable1DModel",fillcolor=white,fontname="Vera Sans, DejaVu Sans, Liberation Sans, Arial, Helvetica, sans",fontsize=10,height=0.25,shape=box,style="setlinewidth(0.5),filled",target="_top",tooltip="Base class for one-dimensional fittable models."]; "FittableModel" -> "Fittable1DModel" [arrowsize=0.5,style="setlinewidth(0.5)"]; "FittableModel" [URL="https://docs.astropy.org/en/stable/api/astropy.modeling.FittableModel.html#astropy.modeling.FittableModel",fillcolor=white,fontname="Vera Sans, DejaVu Sans, Liberation Sans, Arial, Helvetica, sans",fontsize=10,height=0.25,shape=box,style="setlinewidth(0.5),filled",target="_top",tooltip="Base class for models that can be fitted using the built-in fitting"]; "Model" -> "FittableModel" [arrowsize=0.5,style="setlinewidth(0.5)"]; "Model" [URL="https://docs.astropy.org/en/stable/api/astropy.modeling.Model.html#astropy.modeling.Model",fillcolor=white,fontname="Vera Sans, DejaVu Sans, Liberation Sans, Arial, Helvetica, sans",fontsize=10,height=0.25,shape=box,style="setlinewidth(0.5),filled",target="_top",tooltip="Base class for all models."]; "WG00" [URL="api/dust_attenuation.radiative_transfer.WG00.html#dust_attenuation.radiative_transfer.WG00",fillcolor=white,fontname="Vera Sans, DejaVu Sans, Liberation Sans, Arial, Helvetica, sans",fontsize=10,height=0.25,shape=box,style="setlinewidth(0.5),filled",target="_top",tooltip="Attenuation curve of Witt & Gordon (2000)"]; "BaseAtttauVModel" -> "WG00" [arrowsize=0.5,style="setlinewidth(0.5)"]; }dust_attenuation.shapes Module¶
Classes¶
|
Attenuation curve using a modified version of the Calzetti law allowing for a varying UV slope and the presence of a UV bump. |
|
Attenuation curve using a modified version of the Calzetti law allowing for a varying UV slope and the presence of a UV bump. |
Class Inheritance Diagram¶
digraph inheritance118023c830 { bgcolor=transparent; rankdir=LR; size="8.0, 12.0"; "BaseAttAvModel" [URL="api/dust_attenuation.baseclasses.BaseAttAvModel.html#dust_attenuation.baseclasses.BaseAttAvModel",fillcolor=white,fontname="Vera Sans, DejaVu Sans, Liberation Sans, Arial, Helvetica, sans",fontsize=10,height=0.25,shape=box,style="setlinewidth(0.5),filled",target="_top",tooltip="Base attenuation Av Model. Do not use."]; "BaseAttModel" -> "BaseAttAvModel" [arrowsize=0.5,style="setlinewidth(0.5)"]; "BaseAttModel" [URL="api/dust_attenuation.baseclasses.BaseAttModel.html#dust_attenuation.baseclasses.BaseAttModel",fillcolor=white,fontname="Vera Sans, DejaVu Sans, Liberation Sans, Arial, Helvetica, sans",fontsize=10,height=0.25,shape=box,style="setlinewidth(0.5),filled",target="_top",tooltip="Base Attenuation Model. Do not use."]; "Fittable1DModel" -> "BaseAttModel" [arrowsize=0.5,style="setlinewidth(0.5)"]; "Fittable1DModel" [URL="https://docs.astropy.org/en/stable/api/astropy.modeling.Fittable1DModel.html#astropy.modeling.Fittable1DModel",fillcolor=white,fontname="Vera Sans, DejaVu Sans, Liberation Sans, Arial, Helvetica, sans",fontsize=10,height=0.25,shape=box,style="setlinewidth(0.5),filled",target="_top",tooltip="Base class for one-dimensional fittable models."]; "FittableModel" -> "Fittable1DModel" [arrowsize=0.5,style="setlinewidth(0.5)"]; "FittableModel" [URL="https://docs.astropy.org/en/stable/api/astropy.modeling.FittableModel.html#astropy.modeling.FittableModel",fillcolor=white,fontname="Vera Sans, DejaVu Sans, Liberation Sans, Arial, Helvetica, sans",fontsize=10,height=0.25,shape=box,style="setlinewidth(0.5),filled",target="_top",tooltip="Base class for models that can be fitted using the built-in fitting"]; "Model" -> "FittableModel" [arrowsize=0.5,style="setlinewidth(0.5)"]; "Model" [URL="https://docs.astropy.org/en/stable/api/astropy.modeling.Model.html#astropy.modeling.Model",fillcolor=white,fontname="Vera Sans, DejaVu Sans, Liberation Sans, Arial, Helvetica, sans",fontsize=10,height=0.25,shape=box,style="setlinewidth(0.5),filled",target="_top",tooltip="Base class for all models."]; "N09" [URL="api/dust_attenuation.shapes.N09.html#dust_attenuation.shapes.N09",fillcolor=white,fontname="Vera Sans, DejaVu Sans, Liberation Sans, Arial, Helvetica, sans",fontsize=10,height=0.25,shape=box,style="setlinewidth(0.5),filled",target="_top",tooltip="Attenuation curve using a modified version of the Calzetti law"]; "BaseAttAvModel" -> "N09" [arrowsize=0.5,style="setlinewidth(0.5)"]; "SBL18" [URL="api/dust_attenuation.shapes.SBL18.html#dust_attenuation.shapes.SBL18",fillcolor=white,fontname="Vera Sans, DejaVu Sans, Liberation Sans, Arial, Helvetica, sans",fontsize=10,height=0.25,shape=box,style="setlinewidth(0.5),filled",target="_top",tooltip="Attenuation curve using a modified version of the Calzetti law"]; "N09" -> "SBL18" [arrowsize=0.5,style="setlinewidth(0.5)"]; }dust_attenuation.baseclasses Module¶
Classes¶
|
Base Attenuation Model. |
|
Base attenuation Av Model. |
|
Base attenuation tau_V Model. |