AGN Emission Models

We define a set of premade models, including a complex UnifiedAGN model to calculate and combine emission from an AGN’s disc, Narrow Line Region (NLR), Broad Line Region (BLR), and torus.

You are, of course, free to construct whatever emission model you want using the preexisting AGN grids

As with the stellar models, before we define any AGN models we need the grids to use with them. For AGN models there are currently two grids, one for the NLR and one for the BLR

[1]:
from unyt import kelvin

from synthesizer import Grid
from synthesizer.emission_models import Blackbody, Greybody
from synthesizer.emission_models.attenuation import PowerLaw

# Get the NLR and BLR grids
nlr_grid = Grid("test_grid_agn-nlr")
blr_grid = Grid("test_grid_agn-blr")

When defining all of the following models we will explicitly provide covering fractions for each component, however, these can be freely omitted and instead attached to the BlackHole/s explicitly. This is done to allow for the possibility of having a single covering fraction for all components, or for the covering fraction to be defined on a per black hole basis.

NLRIncidentEmission & BLRIncidentEmission

The incident NLR emission is the pure disc emission incident onto the NLR. Similarly, the incident BLR emission is the pure disc emission incident onto the BLR.

A NLR / BLR incident model defines the extraction of the "incident" NLR / BLR spectra from an AGN grid.

[2]:
from synthesizer.emission_models import (
    BLRIncidentEmission,
    NLRIncidentEmission,
)

nlr_incident = NLRIncidentEmission(grid=nlr_grid)
print(nlr_incident)

blr_incident = BLRIncidentEmission(grid=blr_grid)
print(blr_incident)
|==== EmissionModel: nlr_incident ====|
|-------------------------------------|
|  NLR_INCIDENT (blackhole)           |
|-------------------------------------|
|Extraction model:                    |
|  Grid: test_grid_agn-nlr            |
|  Extract key: incident              |
|  Use velocity shift: False          |
|  Save emission: True                |
|=====================================|
|==== EmissionModel: blr_incident ====|
|-------------------------------------|
|  BLR_INCIDENT (blackhole)           |
|-------------------------------------|
|Extraction model:                    |
|  Grid: test_grid_agn-blr            |
|  Extract key: incident              |
|  Use velocity shift: False          |
|  Save emission: True                |
|=====================================|

NLRTransmittedEmission & BLRTransmittedEmission

The transmitted NLR emission is the incident NLR emission which is transmitted through the NLR. Similarly, a transmitted BLR emission is the incident BLR emission which is transmitted through the BLR.

A NLR / BLR transmitted model defines the extraction of the "transmitted" NLR / BLR spectra from an AGN grid, including a covering fraction (escape fraction) defining how much of the disc emission is transmitted through the NLR / BLR.

[3]:
from synthesizer.emission_models import (
    BLRTransmittedEmission,
    NLRTransmittedEmission,
)

nlr_transmitted = NLRTransmittedEmission(grid=nlr_grid, covering_fraction=0.1)
print(nlr_transmitted)

blr_transmitted = BLRTransmittedEmission(grid=blr_grid, covering_fraction=0.1)
print(blr_transmitted)
|====================================== EmissionModel: nlr_transmitted ======================================|
|------------------------------------------------------------------------------------------------------------|
|  FULL_NLR_TRANSMITTED (blackhole)                                                                          |
|------------------------------------------------------------------------------------------------------------|
|Extraction model:                                                                                           |
|  Grid: test_grid_agn-nlr                                                                                   |
|  Extract key: transmitted                                                                                  |
|  Use velocity shift: False                                                                                 |
|  Save emission: True                                                                                       |
|------------------------------------------------------------------------------------------------------------|
|  NLR_TRANSMITTED (blackhole)                                                                               |
|------------------------------------------------------------------------------------------------------------|
|Transformer model:                                                                                          |
|  Transformer: <class 'synthesizer.emission_models.transformers.escape_fraction.CoveringFraction'>          |
|  Apply to: full_nlr_transmitted                                                                            |
|  Save emission: True                                                                                       |
|  Fixed parameters:                                                                                         |
|    - fesc: 0.1                                                                                             |
|============================================================================================================|
|====================================== EmissionModel: blr_transmitted ======================================|
|------------------------------------------------------------------------------------------------------------|
|  FULL_BLR_TRANSMITTED (blackhole)                                                                          |
|------------------------------------------------------------------------------------------------------------|
|Extraction model:                                                                                           |
|  Grid: test_grid_agn-blr                                                                                   |
|  Extract key: transmitted                                                                                  |
|  Use velocity shift: False                                                                                 |
|  Save emission: True                                                                                       |
|------------------------------------------------------------------------------------------------------------|
|  BLR_TRANSMITTED (blackhole)                                                                               |
|------------------------------------------------------------------------------------------------------------|
|Transformer model:                                                                                          |
|  Transformer: <class 'synthesizer.emission_models.transformers.escape_fraction.CoveringFraction'>          |
|  Apply to: full_blr_transmitted                                                                            |
|  Save emission: True                                                                                       |
|  Fixed parameters:                                                                                         |
|    - fesc: 0.1                                                                                             |
|============================================================================================================|

NLREmission & BLREmission

The NLR emission is the emission coming directly from the NLR. Similarly, the BLR emission is the emission coming directly from the BLR.

A NLR / BLR model defines the extraction of the "nebular" NLR / BLR spectra from an AGN grid.

[4]:
from synthesizer.emission_models import NLREmission

nlr = NLREmission(grid=nlr_grid)
print(nlr)

blr = NLREmission(grid=blr_grid)
print(blr)
|========= EmissionModel: nlr ========|
|-------------------------------------|
|  NLR (blackhole)                    |
|-------------------------------------|
|Extraction model:                    |
|  Grid: test_grid_agn-nlr            |
|  Extract key: nebular               |
|  Use velocity shift: False          |
|  Save emission: True                |
|=====================================|
|========= EmissionModel: nlr ========|
|-------------------------------------|
|  NLR (blackhole)                    |
|-------------------------------------|
|Extraction model:                    |
|  Grid: test_grid_agn-blr            |
|  Extract key: nebular               |
|  Use velocity shift: False          |
|  Save emission: True                |
|=====================================|

DiscIncidentEmission

The disc incident emission is the emission directly from the disc incident onto the NLR and BLR. A disc incident model defines the extraction of the "incident" NLR spectra from an AGN grid.

Ignoring any geometry considerations, DiscIncidentEmission, NLRIncidentEmission, and BLRIncidentEmission are all equivalent models (we consider the geometry in the UnifiedAGN model).

[5]:
from synthesizer.emission_models import DiscIncidentEmission

disc_incident = DiscIncidentEmission(grid=nlr_grid)
print(disc_incident)
|==== EmissionModel: disc_incident ===|
|-------------------------------------|
|  DISC_INCIDENT (blackhole)          |
|-------------------------------------|
|Extraction model:                    |
|  Grid: test_grid_agn-nlr            |
|  Extract key: incident              |
|  Use velocity shift: False          |
|  Save emission: True                |
|=====================================|

DiscTransmittedEmission

The disc transmitted emission is the disc emission transmitted through both the NLR and BLR. A disc transmitted model defines the combination of NLRTransmittedEmission and BLRTransmittedEmission, in the presence of a covering fraction (escape fraction), for each region.

[6]:
from synthesizer.emission_models import DiscTransmittedEmission

disc_transmitted = DiscTransmittedEmission(
    nlr_grid=nlr_grid,
    blr_grid=blr_grid,
    covering_fraction_nlr=0.1,
    covering_fraction_blr=0.2,
)
print(disc_transmitted)
disc_transmitted.plot_emission_tree()
|===================================== EmissionModel: disc_transmitted ======================================|
|------------------------------------------------------------------------------------------------------------|
|  FULL_NLR_TRANSMITTED (blackhole)                                                                          |
|------------------------------------------------------------------------------------------------------------|
|Extraction model:                                                                                           |
|  Grid: test_grid_agn-nlr                                                                                   |
|  Extract key: transmitted                                                                                  |
|  Use velocity shift: False                                                                                 |
|  Save emission: True                                                                                       |
|------------------------------------------------------------------------------------------------------------|
|  FULL_BLR_TRANSMITTED (blackhole)                                                                          |
|------------------------------------------------------------------------------------------------------------|
|Extraction model:                                                                                           |
|  Grid: test_grid_agn-blr                                                                                   |
|  Extract key: transmitted                                                                                  |
|  Use velocity shift: False                                                                                 |
|  Save emission: True                                                                                       |
|------------------------------------------------------------------------------------------------------------|
|  NLR_TRANSMITTED (blackhole)                                                                               |
|------------------------------------------------------------------------------------------------------------|
|Transformer model:                                                                                          |
|  Transformer: <class 'synthesizer.emission_models.transformers.escape_fraction.CoveringFraction'>          |
|  Apply to: full_nlr_transmitted                                                                            |
|  Save emission: True                                                                                       |
|  Fixed parameters:                                                                                         |
|    - fesc: 0.1                                                                                             |
|------------------------------------------------------------------------------------------------------------|
|  BLR_TRANSMITTED (blackhole)                                                                               |
|------------------------------------------------------------------------------------------------------------|
|Transformer model:                                                                                          |
|  Transformer: <class 'synthesizer.emission_models.transformers.escape_fraction.CoveringFraction'>          |
|  Apply to: full_blr_transmitted                                                                            |
|  Save emission: True                                                                                       |
|  Fixed parameters:                                                                                         |
|    - fesc: 0.2                                                                                             |
|------------------------------------------------------------------------------------------------------------|
|  DISC_TRANSMITTED (blackhole)                                                                              |
|------------------------------------------------------------------------------------------------------------|
|Combination model:                                                                                          |
|  Combine models: nlr_transmitted, blr_transmitted                                                          |
|  Save emission: True                                                                                       |
|============================================================================================================|
../../_images/emission_models_premade_models_agn_models_12_1.png
[6]:
(<Figure size 600x600 with 1 Axes>, <Axes: >)

DiscEscapedEmission

The disc escaped emission is the disc incident emission not transmitted through the NLR or BLR. A disc escaped model defines the extraction of the "incident" NLR spectra from an AGN grid, with fesc=1 - covering_fraction_nlr - covering_fraction_blr.

[7]:
from synthesizer.emission_models import DiscEscapedEmission

disc_escaped = DiscEscapedEmission(
    grid=nlr_grid, covering_fraction_nlr=0.1, covering_fraction_blr=0.2
)
print(disc_escaped)
|======================================= EmissionModel: disc_escaped ========================================|
|------------------------------------------------------------------------------------------------------------|
|  DISC_INCIDENT (blackhole)                                                                                 |
|------------------------------------------------------------------------------------------------------------|
|Extraction model:                                                                                           |
|  Grid: test_grid_agn-nlr                                                                                   |
|  Extract key: incident                                                                                     |
|  Use velocity shift: False                                                                                 |
|  Save emission: True                                                                                       |
|------------------------------------------------------------------------------------------------------------|
|  DISC_ESCAPED (blackhole)                                                                                  |
|------------------------------------------------------------------------------------------------------------|
|Transformer model:                                                                                          |
|  Transformer: <class 'synthesizer.emission_models.transformers.escape_fraction.EscapingFraction'>          |
|  Apply to: disc_incident                                                                                   |
|  Save emission: True                                                                                       |
|  Fixed parameters:                                                                                         |
|    - covering_fraction_nlr: 0.1                                                                            |
|    - covering_fraction_blr: 0.2                                                                            |
|============================================================================================================|

DiscEmission

The disc emission is the combined emission from the disc including both the emission transmitted through the line regions and the escaping disc emission. A disc model defines the combination of DiscTransmittedEmission and DiscEscapedEmission.

[8]:
from synthesizer.emission_models import DiscEmission

disc = DiscEmission(
    nlr_grid=nlr_grid,
    blr_grid=blr_grid,
    covering_fraction_nlr=0.1,
    covering_fraction_blr=0.2,
)
print(disc)
disc.plot_emission_tree()
|=========================================== EmissionModel: disc ============================================|
|------------------------------------------------------------------------------------------------------------|
|  DISC_INCIDENT (blackhole)                                                                                 |
|------------------------------------------------------------------------------------------------------------|
|Extraction model:                                                                                           |
|  Grid: test_grid_agn-nlr                                                                                   |
|  Extract key: incident                                                                                     |
|  Use velocity shift: False                                                                                 |
|  Save emission: True                                                                                       |
|------------------------------------------------------------------------------------------------------------|
|  FULL_BLR_TRANSMITTED (blackhole)                                                                          |
|------------------------------------------------------------------------------------------------------------|
|Extraction model:                                                                                           |
|  Grid: test_grid_agn-blr                                                                                   |
|  Extract key: transmitted                                                                                  |
|  Use velocity shift: False                                                                                 |
|  Save emission: True                                                                                       |
|------------------------------------------------------------------------------------------------------------|
|  FULL_NLR_TRANSMITTED (blackhole)                                                                          |
|------------------------------------------------------------------------------------------------------------|
|Extraction model:                                                                                           |
|  Grid: test_grid_agn-nlr                                                                                   |
|  Extract key: transmitted                                                                                  |
|  Use velocity shift: False                                                                                 |
|  Save emission: True                                                                                       |
|------------------------------------------------------------------------------------------------------------|
|  DISC_ESCAPED (blackhole)                                                                                  |
|------------------------------------------------------------------------------------------------------------|
|Transformer model:                                                                                          |
|  Transformer: <class 'synthesizer.emission_models.transformers.escape_fraction.EscapingFraction'>          |
|  Apply to: disc_incident                                                                                   |
|  Save emission: True                                                                                       |
|  Fixed parameters:                                                                                         |
|    - covering_fraction_nlr: 0.1                                                                            |
|    - covering_fraction_blr: 0.2                                                                            |
|------------------------------------------------------------------------------------------------------------|
|  BLR_TRANSMITTED (blackhole)                                                                               |
|------------------------------------------------------------------------------------------------------------|
|Transformer model:                                                                                          |
|  Transformer: <class 'synthesizer.emission_models.transformers.escape_fraction.CoveringFraction'>          |
|  Apply to: full_blr_transmitted                                                                            |
|  Save emission: True                                                                                       |
|  Fixed parameters:                                                                                         |
|    - fesc: 0.2                                                                                             |
|------------------------------------------------------------------------------------------------------------|
|  NLR_TRANSMITTED (blackhole)                                                                               |
|------------------------------------------------------------------------------------------------------------|
|Transformer model:                                                                                          |
|  Transformer: <class 'synthesizer.emission_models.transformers.escape_fraction.CoveringFraction'>          |
|  Apply to: full_nlr_transmitted                                                                            |
|  Save emission: True                                                                                       |
|  Fixed parameters:                                                                                         |
|    - fesc: 0.1                                                                                             |
|------------------------------------------------------------------------------------------------------------|
|  DISC_TRANSMITTED (blackhole)                                                                              |
|------------------------------------------------------------------------------------------------------------|
|Combination model:                                                                                          |
|  Combine models: nlr_transmitted, blr_transmitted                                                          |
|  Save emission: True                                                                                       |
|------------------------------------------------------------------------------------------------------------|
|  DISC (blackhole)                                                                                          |
|------------------------------------------------------------------------------------------------------------|
|Combination model:                                                                                          |
|  Combine models: disc_transmitted, disc_escaped                                                            |
|  Save emission: True                                                                                       |
|============================================================================================================|
../../_images/emission_models_premade_models_agn_models_16_1.png
[8]:
(<Figure size 600x600 with 1 Axes>, <Axes: >)

TorusEmission

The torus emission is the reprocessed emission from the disc incident on the torus. A torus model defines the generation of a spectra scaled by the DiscIncidentEmission, which can either be passed directly, or a grid must be passed and it will be generated.

[9]:
from synthesizer.emission_models import TorusEmission

torus = TorusEmission(
    torus_emission_model=Blackbody(1000 * kelvin), disc_incident=disc_incident
)
print(torus)
|================================== EmissionModel: torus ==================================|
|------------------------------------------------------------------------------------------|
|  DISC_INCIDENT (blackhole)                                                               |
|------------------------------------------------------------------------------------------|
|Extraction model:                                                                         |
|  Grid: test_grid_agn-nlr                                                                 |
|  Extract key: incident                                                                   |
|  Use velocity shift: False                                                               |
|  Save emission: True                                                                     |
|------------------------------------------------------------------------------------------|
|  TORUS (blackhole)                                                                       |
|------------------------------------------------------------------------------------------|
|Generation model:                                                                         |
|  Emission generation model: Blackbody(scaler=disc_incident, temperature=1000 K)          |
|  Scaler model: disc_incident                                                             |
|  Save emission: True                                                                     |
|  Scaling by:                                                                             |
|    - torus_fraction                                                                      |
|==========================================================================================|

AGNIntrinsicEmission

The AGN intrinsic emission is the total emission from an AGN, including the emission from the narrow and broad line regions, disc, and torus. An AGN intrinsic model defines the combination of DiscEmission, NLREmission, BLREmission, and TorusEmission.

[10]:
from synthesizer.emission_models import AGNIntrinsicEmission

agn_intrinsic = AGNIntrinsicEmission(
    nlr_grid=nlr_grid,
    blr_grid=blr_grid,
    torus_emission_model=Blackbody(1000 * kelvin),
    covering_fraction_nlr=0.1,
    covering_fraction_blr=0.2,
)
print(agn_intrinsic)
agn_intrinsic.plot_emission_tree()
|========================================= EmissionModel: intrinsic =========================================|
|------------------------------------------------------------------------------------------------------------|
|  FULL_BLR_TRANSMITTED (blackhole)                                                                          |
|------------------------------------------------------------------------------------------------------------|
|Extraction model:                                                                                           |
|  Grid: test_grid_agn-blr                                                                                   |
|  Extract key: transmitted                                                                                  |
|  Use velocity shift: False                                                                                 |
|  Save emission: True                                                                                       |
|------------------------------------------------------------------------------------------------------------|
|  FULL_NLR_TRANSMITTED (blackhole)                                                                          |
|------------------------------------------------------------------------------------------------------------|
|Extraction model:                                                                                           |
|  Grid: test_grid_agn-nlr                                                                                   |
|  Extract key: transmitted                                                                                  |
|  Use velocity shift: False                                                                                 |
|  Save emission: True                                                                                       |
|------------------------------------------------------------------------------------------------------------|
|  DISC_INCIDENT (blackhole)                                                                                 |
|------------------------------------------------------------------------------------------------------------|
|Extraction model:                                                                                           |
|  Grid: test_grid_agn-nlr                                                                                   |
|  Extract key: incident                                                                                     |
|  Use velocity shift: False                                                                                 |
|  Save emission: True                                                                                       |
|------------------------------------------------------------------------------------------------------------|
|  BLR_TRANSMITTED (blackhole)                                                                               |
|------------------------------------------------------------------------------------------------------------|
|Transformer model:                                                                                          |
|  Transformer: <class 'synthesizer.emission_models.transformers.escape_fraction.CoveringFraction'>          |
|  Apply to: full_blr_transmitted                                                                            |
|  Save emission: True                                                                                       |
|  Fixed parameters:                                                                                         |
|    - fesc: 0.2                                                                                             |
|------------------------------------------------------------------------------------------------------------|
|  NLR_TRANSMITTED (blackhole)                                                                               |
|------------------------------------------------------------------------------------------------------------|
|Transformer model:                                                                                          |
|  Transformer: <class 'synthesizer.emission_models.transformers.escape_fraction.CoveringFraction'>          |
|  Apply to: full_nlr_transmitted                                                                            |
|  Save emission: True                                                                                       |
|  Fixed parameters:                                                                                         |
|    - fesc: 0.1                                                                                             |
|------------------------------------------------------------------------------------------------------------|
|  DISC_TRANSMITTED (blackhole)                                                                              |
|------------------------------------------------------------------------------------------------------------|
|Combination model:                                                                                          |
|  Combine models: nlr_transmitted, blr_transmitted                                                          |
|  Save emission: True                                                                                       |
|------------------------------------------------------------------------------------------------------------|
|  DISC_ESCAPED (blackhole)                                                                                  |
|------------------------------------------------------------------------------------------------------------|
|Transformer model:                                                                                          |
|  Transformer: <class 'synthesizer.emission_models.transformers.escape_fraction.EscapingFraction'>          |
|  Apply to: disc_incident                                                                                   |
|  Save emission: True                                                                                       |
|  Fixed parameters:                                                                                         |
|    - covering_fraction_nlr: 0.1                                                                            |
|    - covering_fraction_blr: 0.2                                                                            |
|------------------------------------------------------------------------------------------------------------|
|  DISC (blackhole)                                                                                          |
|------------------------------------------------------------------------------------------------------------|
|Combination model:                                                                                          |
|  Combine models: disc_transmitted, disc_escaped                                                            |
|  Save emission: True                                                                                       |
|------------------------------------------------------------------------------------------------------------|
|  TORUS (blackhole)                                                                                         |
|------------------------------------------------------------------------------------------------------------|
|Generation model:                                                                                           |
|  Emission generation model: Blackbody(scaler=disc_incident, temperature=1000 K)                            |
|  Scaler model: disc_incident                                                                               |
|  Save emission: True                                                                                       |
|  Scaling by:                                                                                               |
|    - torus_fraction                                                                                        |
|------------------------------------------------------------------------------------------------------------|
|  INTRINSIC (blackhole)                                                                                     |
|------------------------------------------------------------------------------------------------------------|
|Combination model:                                                                                          |
|  Combine models: disc, torus                                                                               |
|  Save emission: True                                                                                       |
|============================================================================================================|
../../_images/emission_models_premade_models_agn_models_20_1.png
[10]:
(<Figure size 600x600 with 1 Axes>, <Axes: >)

UnifiedAGN

The UnifiedAGN model is similar to the AGNIntrinsicEmission model, but folds in a lot of extra considerations about the relative geometry of the AGN, both internally and with respect to the observer. UnifiedAGN introduces several geometric properties:

inclination (\(\theta\))

The inclination (or viewing angle) of the disc relative to the observer.

  • \(\theta = 0\): face-on

  • \(\theta = \pi/2\): edge-on

When using the QSOSED or RELQSO disc models, the inclination also affects the incident spectrum.

theta_torus (\(\Theta_{\rm torus}\))

The torus opening angle \(\Theta_{\rm torus}\) determines when the disc and BLR emission are obscured along with the fraction of the disc light that is reprocessed.

  • The disc and BLR are obscured when \(\theta > 90^\circ - \Theta_{\rm torus}\)

  • The torus reprocesses a fraction \(2\Theta_{\rm torus} / \pi\) of the isotropic disc emission, re-emitted according to the selected torus_emission_model.

torus_emission_model

The model describing the shape of the emission from the torus.

covering_fraction_blr (\(f_{\rm cov, BLR}\))

The covering fraction of the broad line region (BLR), determines:

  • the fraction of the isotropic disc incident emission that is reprocessed by the BLR.

  • the probability that the disc incident emission is transmitted through the BLR when the disc_transmission="random" scenario is used.

  • the fraction of the disc incident emission that is transmitted through the BLR when the disc_transmission="weighted_combination" scenario is chosen.

covering_fraction_nlr (\(f_{\rm cov, NLR}\))

The covering fraction of the narrow line region (NLR), determines:

  • the fraction of the isotropic disc incident emission that is reprocessed by the NLR.

  • the probability that the disc incident emission is transmitted through the NLR when the disc_transmission="random" scenario is used.

  • the fraction of the disc incident emission that is transmitted through the NLR when the disc_transmission="weighted_combination" scenario is chosen.

disc_transmission:

The UnifiedAGN model can flexibly account for the transmission of light from the disc. Available modes:

  • disc_transmission="none": light from the disc escapes unimpeded.

  • disc_transmission="BLR": all transmitted emission passes through the BLR.

  • disc_transmission="NLR": all transmitted emission passes through the NLR.

  • disc_transmission="weighted_combination": the transmitted spectrum is the weighted sum of unobscured, BLR-transmitted, and NLR-transmitted components. This approximates the average over all unobscured sight-lines.

  • disc_transmission="random": a transmission path (unobscured, BLR, or NLR) is chosen randomly, with probabilities given by the covering fractions.

diffuse_dust_curve:

If a dust attenuation curve (diffuse_dust_curve) is provided, and either tau_v is set on the black hole object or supplied directly to UnifiedAGN, the model will automatically apply attenuation from diffuse dust. Diffuse dust is assumed to affect all emission components.

diffuse_dust_emission_model:

If a dust emission model (diffuse_dust_emission_model) is also specified, then synthesizer will use energy balance to compute the corresponding diffuse dust emission and add this contribution to the returned spectrum.

[11]:
from synthesizer.emission_models import UnifiedAGN

# model with no dust attenuation or emission
uni_model = UnifiedAGN(
    nlr_grid,
    blr_grid,
    torus_emission_model=Blackbody(1000 * kelvin),
)
print(uni_model)

uni_model.plot_emission_tree(fontsize=7)
|========================================================= EmissionModel: intrinsic ========================================================|
|-------------------------------------------------------------------------------------------------------------------------------------------|
|  DISC_INCIDENT_ISOTROPIC (blackhole)                                                                                                      |
|-------------------------------------------------------------------------------------------------------------------------------------------|
|Extraction model:                                                                                                                          |
|  Grid: test_grid_agn-nlr                                                                                                                  |
|  Extract key: incident                                                                                                                    |
|  Use velocity shift: False                                                                                                                |
|  Save emission: True                                                                                                                      |
|  Fixed parameters:                                                                                                                        |
|    - cosine_inclination: 0.5                                                                                                              |
|    - hydrogen_density: hydrogen_density_blr                                                                                               |
|    - ionisation_parameter: ionisation_parameter_blr                                                                                       |
|-------------------------------------------------------------------------------------------------------------------------------------------|
|  DISC_INCIDENT_MASKED (blackhole)                                                                                                         |
|-------------------------------------------------------------------------------------------------------------------------------------------|
|Extraction model:                                                                                                                          |
|  Grid: test_grid_agn-nlr                                                                                                                  |
|  Extract key: incident                                                                                                                    |
|  Use velocity shift: False                                                                                                                |
|  Save emission: True                                                                                                                      |
|  Fixed parameters:                                                                                                                        |
|    - hydrogen_density: hydrogen_density_blr                                                                                               |
|    - ionisation_parameter: ionisation_parameter_blr                                                                                       |
|    - torus_edgeon_cond: ParameterFunction(torus_edgeon_condition, sets='torus_edgeon_cond', args=('inclination', 'theta_torus'))          |
|  Masks:                                                                                                                                   |
|    - torus_edgeon_cond < 90 degree                                                                                                        |
|-------------------------------------------------------------------------------------------------------------------------------------------|
|  DISC_TRANSMITTED_BLR_FULL (blackhole)                                                                                                    |
|-------------------------------------------------------------------------------------------------------------------------------------------|
|Extraction model:                                                                                                                          |
|  Grid: test_grid_agn-blr                                                                                                                  |
|  Extract key: transmitted                                                                                                                 |
|  Use velocity shift: False                                                                                                                |
|  Save emission: True                                                                                                                      |
|  Fixed parameters:                                                                                                                        |
|    - hydrogen_density: hydrogen_density_blr                                                                                               |
|    - ionisation_parameter: ionisation_parameter_blr                                                                                       |
|    - torus_edgeon_cond: ParameterFunction(torus_edgeon_condition, sets='torus_edgeon_cond', args=('inclination', 'theta_torus'))          |
|  Masks:                                                                                                                                   |
|    - torus_edgeon_cond < 90 degree                                                                                                        |
|-------------------------------------------------------------------------------------------------------------------------------------------|
|  DISC_TRANSMITTED_NLR_FULL (blackhole)                                                                                                    |
|-------------------------------------------------------------------------------------------------------------------------------------------|
|Extraction model:                                                                                                                          |
|  Grid: test_grid_agn-nlr                                                                                                                  |
|  Extract key: transmitted                                                                                                                 |
|  Use velocity shift: False                                                                                                                |
|  Save emission: True                                                                                                                      |
|  Fixed parameters:                                                                                                                        |
|    - hydrogen_density: hydrogen_density_nlr                                                                                               |
|    - ionisation_parameter: ionisation_parameter_nlr                                                                                       |
|    - torus_edgeon_cond: ParameterFunction(torus_edgeon_condition, sets='torus_edgeon_cond', args=('inclination', 'theta_torus'))          |
|  Masks:                                                                                                                                   |
|    - torus_edgeon_cond < 90 degree                                                                                                        |
|-------------------------------------------------------------------------------------------------------------------------------------------|
|  FULL_REPROCESSED_NLR (blackhole)                                                                                                         |
|-------------------------------------------------------------------------------------------------------------------------------------------|
|Extraction model:                                                                                                                          |
|  Grid: test_grid_agn-nlr                                                                                                                  |
|  Extract key: nebular                                                                                                                     |
|  Use velocity shift: False                                                                                                                |
|  Save emission: True                                                                                                                      |
|  Fixed parameters:                                                                                                                        |
|    - cosine_inclination: 0.5                                                                                                              |
|    - hydrogen_density: hydrogen_density_nlr                                                                                               |
|    - ionisation_parameter: ionisation_parameter_nlr                                                                                       |
|-------------------------------------------------------------------------------------------------------------------------------------------|
|  FULL_REPROCESSED_BLR (blackhole)                                                                                                         |
|-------------------------------------------------------------------------------------------------------------------------------------------|
|Extraction model:                                                                                                                          |
|  Grid: test_grid_agn-blr                                                                                                                  |
|  Extract key: nebular                                                                                                                     |
|  Use velocity shift: False                                                                                                                |
|  Save emission: True                                                                                                                      |
|  Fixed parameters:                                                                                                                        |
|    - torus_edgeon_cond: ParameterFunction(torus_edgeon_condition, sets='torus_edgeon_cond', args=('inclination', 'theta_torus'))          |
|    - cosine_inclination: 0.5                                                                                                              |
|    - hydrogen_density: hydrogen_density_blr                                                                                               |
|    - ionisation_parameter: ionisation_parameter_blr                                                                                       |
|  Masks:                                                                                                                                   |
|    - torus_edgeon_cond < 90 degree                                                                                                        |
|-------------------------------------------------------------------------------------------------------------------------------------------|
|  DISC_TRANSMITTED_BLR_ISOTROPIC_FULL (blackhole)                                                                                          |
|-------------------------------------------------------------------------------------------------------------------------------------------|
|Extraction model:                                                                                                                          |
|  Grid: test_grid_agn-blr                                                                                                                  |
|  Extract key: transmitted                                                                                                                 |
|  Use velocity shift: False                                                                                                                |
|  Save emission: True                                                                                                                      |
|  Fixed parameters:                                                                                                                        |
|    - cosine_inclination: 0.5                                                                                                              |
|    - hydrogen_density: hydrogen_density_blr                                                                                               |
|    - ionisation_parameter: ionisation_parameter_blr                                                                                       |
|-------------------------------------------------------------------------------------------------------------------------------------------|
|  DISC_TRANSMITTED_NLR_ISOTROPIC_FULL (blackhole)                                                                                          |
|-------------------------------------------------------------------------------------------------------------------------------------------|
|Extraction model:                                                                                                                          |
|  Grid: test_grid_agn-nlr                                                                                                                  |
|  Extract key: transmitted                                                                                                                 |
|  Use velocity shift: False                                                                                                                |
|  Save emission: True                                                                                                                      |
|  Fixed parameters:                                                                                                                        |
|    - cosine_inclination: 0.5                                                                                                              |
|    - hydrogen_density: hydrogen_density_nlr                                                                                               |
|    - ionisation_parameter: ionisation_parameter_nlr                                                                                       |
|-------------------------------------------------------------------------------------------------------------------------------------------|
|  DISC_INCIDENT (blackhole)                                                                                                                |
|-------------------------------------------------------------------------------------------------------------------------------------------|
|Extraction model:                                                                                                                          |
|  Grid: test_grid_agn-nlr                                                                                                                  |
|  Extract key: incident                                                                                                                    |
|  Use velocity shift: False                                                                                                                |
|  Save emission: True                                                                                                                      |
|  Fixed parameters:                                                                                                                        |
|    - hydrogen_density: hydrogen_density_blr                                                                                               |
|    - ionisation_parameter: ionisation_parameter_blr                                                                                       |
|-------------------------------------------------------------------------------------------------------------------------------------------|
|  FULL_CONTINUUM_NLR (blackhole)                                                                                                           |
|-------------------------------------------------------------------------------------------------------------------------------------------|
|Extraction model:                                                                                                                          |
|  Grid: test_grid_agn-nlr                                                                                                                  |
|  Extract key: nebular_continuum                                                                                                           |
|  Use velocity shift: False                                                                                                                |
|  Save emission: True                                                                                                                      |
|  Fixed parameters:                                                                                                                        |
|    - cosine_inclination: 0.5                                                                                                              |
|    - hydrogen_density: hydrogen_density_nlr                                                                                               |
|    - ionisation_parameter: ionisation_parameter_nlr                                                                                       |
|-------------------------------------------------------------------------------------------------------------------------------------------|
|  FULL_CONTINUUM_BLR (blackhole)                                                                                                           |
|-------------------------------------------------------------------------------------------------------------------------------------------|
|Extraction model:                                                                                                                          |
|  Grid: test_grid_agn-blr                                                                                                                  |
|  Extract key: nebular_continuum                                                                                                           |
|  Use velocity shift: False                                                                                                                |
|  Save emission: True                                                                                                                      |
|  Fixed parameters:                                                                                                                        |
|    - torus_edgeon_cond: ParameterFunction(torus_edgeon_condition, sets='torus_edgeon_cond', args=('inclination', 'theta_torus'))          |
|    - cosine_inclination: 0.5                                                                                                              |
|    - hydrogen_density: hydrogen_density_blr                                                                                               |
|    - ionisation_parameter: ionisation_parameter_blr                                                                                       |
|  Masks:                                                                                                                                   |
|    - torus_edgeon_cond < 90 degree                                                                                                        |
|-------------------------------------------------------------------------------------------------------------------------------------------|
|  TORUS (blackhole)                                                                                                                        |
|-------------------------------------------------------------------------------------------------------------------------------------------|
|Generation model:                                                                                                                          |
|  Emission generation model: Blackbody(scaler=disc_incident_isotropic, temperature=1000 K)                                                 |
|  Scaler model: disc_incident_isotropic                                                                                                    |
|  Save emission: True                                                                                                                      |
|  Scaling by:                                                                                                                              |
|    - torus_fraction                                                                                                                       |
|-------------------------------------------------------------------------------------------------------------------------------------------|
|  DISC_ESCAPED (blackhole)                                                                                                                 |
|-------------------------------------------------------------------------------------------------------------------------------------------|
|Transformer model:                                                                                                                         |
|  Transformer: <class 'synthesizer.emission_models.transformers.escape_fraction.CoveringFraction'>                                         |
|  Apply to: disc_incident_masked                                                                                                           |
|  Save emission: True                                                                                                                      |
|  Fixed parameters:                                                                                                                        |
|    - transmission_fraction_escape: transmission_fraction_escape                                                                           |
|-------------------------------------------------------------------------------------------------------------------------------------------|
|  DISC_TRANSMITTED_BLR (blackhole)                                                                                                         |
|-------------------------------------------------------------------------------------------------------------------------------------------|
|Transformer model:                                                                                                                         |
|  Transformer: <class 'synthesizer.emission_models.transformers.escape_fraction.CoveringFraction'>                                         |
|  Apply to: disc_transmitted_blr_full                                                                                                      |
|  Save emission: True                                                                                                                      |
|  Fixed parameters:                                                                                                                        |
|    - transmission_fraction_blr: transmission_fraction_blr                                                                                 |
|-------------------------------------------------------------------------------------------------------------------------------------------|
|  DISC_TRANSMITTED_NLR (blackhole)                                                                                                         |
|-------------------------------------------------------------------------------------------------------------------------------------------|
|Transformer model:                                                                                                                         |
|  Transformer: <class 'synthesizer.emission_models.transformers.escape_fraction.CoveringFraction'>                                         |
|  Apply to: disc_transmitted_nlr_full                                                                                                      |
|  Save emission: True                                                                                                                      |
|  Fixed parameters:                                                                                                                        |
|    - transmission_fraction_nlr: transmission_fraction_nlr                                                                                 |
|-------------------------------------------------------------------------------------------------------------------------------------------|
|  DISC_TRANSMITTED (blackhole)                                                                                                             |
|-------------------------------------------------------------------------------------------------------------------------------------------|
|Combination model:                                                                                                                         |
|  Combine models: disc_escaped, disc_transmitted_nlr, disc_transmitted_blr                                                                 |
|  Save emission: True                                                                                                                      |
|-------------------------------------------------------------------------------------------------------------------------------------------|
|  DISC (blackhole)                                                                                                                         |
|-------------------------------------------------------------------------------------------------------------------------------------------|
|Combination model:                                                                                                                         |
|  Combine models: disc_transmitted                                                                                                         |
|  Save emission: True                                                                                                                      |
|-------------------------------------------------------------------------------------------------------------------------------------------|
|  NLR (blackhole)                                                                                                                          |
|-------------------------------------------------------------------------------------------------------------------------------------------|
|Transformer model:                                                                                                                         |
|  Transformer: <class 'synthesizer.emission_models.transformers.escape_fraction.CoveringFraction'>                                         |
|  Apply to: full_reprocessed_nlr                                                                                                           |
|  Save emission: True                                                                                                                      |
|-------------------------------------------------------------------------------------------------------------------------------------------|
|  BLR (blackhole)                                                                                                                          |
|-------------------------------------------------------------------------------------------------------------------------------------------|
|Transformer model:                                                                                                                         |
|  Transformer: <class 'synthesizer.emission_models.transformers.escape_fraction.CoveringFraction'>                                         |
|  Apply to: full_reprocessed_blr                                                                                                           |
|  Save emission: True                                                                                                                      |
|-------------------------------------------------------------------------------------------------------------------------------------------|
|  INTRINSIC (blackhole)                                                                                                                    |
|-------------------------------------------------------------------------------------------------------------------------------------------|
|Combination model:                                                                                                                         |
|  Combine models: disc, nlr, blr, torus                                                                                                    |
|  Save emission: True                                                                                                                      |
|-------------------------------------------------------------------------------------------------------------------------------------------|
|  DISC_TRANSMITTED_NLR_WEIGHTED (blackhole)                                                                                                |
|-------------------------------------------------------------------------------------------------------------------------------------------|
|Transformer model:                                                                                                                         |
|  Transformer: <class 'synthesizer.emission_models.transformers.escape_fraction.CoveringFraction'>                                         |
|  Apply to: disc_transmitted_nlr_full                                                                                                      |
|  Save emission: True                                                                                                                      |
|-------------------------------------------------------------------------------------------------------------------------------------------|
|  DISC_ESCAPED_WEIGHTED (blackhole)                                                                                                        |
|-------------------------------------------------------------------------------------------------------------------------------------------|
|Transformer model:                                                                                                                         |
|  Transformer: <class 'synthesizer.emission_models.transformers.escape_fraction.CoveringFraction'>                                         |
|  Apply to: disc_incident_masked                                                                                                           |
|  Save emission: True                                                                                                                      |
|-------------------------------------------------------------------------------------------------------------------------------------------|
|  DISC_TRANSMITTED_BLR_WEIGHTED (blackhole)                                                                                                |
|-------------------------------------------------------------------------------------------------------------------------------------------|
|Transformer model:                                                                                                                         |
|  Transformer: <class 'synthesizer.emission_models.transformers.escape_fraction.CoveringFraction'>                                         |
|  Apply to: disc_transmitted_blr_full                                                                                                      |
|  Save emission: True                                                                                                                      |
|-------------------------------------------------------------------------------------------------------------------------------------------|
|  DISC_TRANSMITTED_WEIGHTED_COMBINATION (blackhole)                                                                                        |
|-------------------------------------------------------------------------------------------------------------------------------------------|
|Combination model:                                                                                                                         |
|  Combine models: disc_escaped_weighted, disc_transmitted_nlr_weighted, disc_transmitted_blr_weighted                                      |
|  Save emission: True                                                                                                                      |
|-------------------------------------------------------------------------------------------------------------------------------------------|
|  DISC_ESCAPED_ISOTROPIC (blackhole)                                                                                                       |
|-------------------------------------------------------------------------------------------------------------------------------------------|
|Transformer model:                                                                                                                         |
|  Transformer: <class 'synthesizer.emission_models.transformers.escape_fraction.EscapingFraction'>                                         |
|  Apply to: disc_incident_isotropic                                                                                                        |
|  Save emission: True                                                                                                                      |
|-------------------------------------------------------------------------------------------------------------------------------------------|
|  DISC_TRANSMITTED_BLR_ISOTROPIC (blackhole)                                                                                               |
|-------------------------------------------------------------------------------------------------------------------------------------------|
|Transformer model:                                                                                                                         |
|  Transformer: <class 'synthesizer.emission_models.transformers.escape_fraction.CoveringFraction'>                                         |
|  Apply to: disc_transmitted_blr_isotropic_full                                                                                            |
|  Save emission: True                                                                                                                      |
|-------------------------------------------------------------------------------------------------------------------------------------------|
|  DISC_TRANSMITTED_NLR_ISOTROPIC (blackhole)                                                                                               |
|-------------------------------------------------------------------------------------------------------------------------------------------|
|Transformer model:                                                                                                                         |
|  Transformer: <class 'synthesizer.emission_models.transformers.escape_fraction.CoveringFraction'>                                         |
|  Apply to: disc_transmitted_nlr_isotropic_full                                                                                            |
|  Save emission: True                                                                                                                      |
|-------------------------------------------------------------------------------------------------------------------------------------------|
|  DISC_AVERAGED_WITHOUT_TORUS (blackhole)                                                                                                  |
|-------------------------------------------------------------------------------------------------------------------------------------------|
|Combination model:                                                                                                                         |
|  Combine models: disc_escaped_isotropic, disc_transmitted_nlr_isotropic, disc_transmitted_blr_isotropic                                   |
|  Save emission: True                                                                                                                      |
|-------------------------------------------------------------------------------------------------------------------------------------------|
|  DISC_AVERAGED (blackhole)                                                                                                                |
|-------------------------------------------------------------------------------------------------------------------------------------------|
|Transformer model:                                                                                                                         |
|  Transformer: <class 'synthesizer.emission_models.transformers.escape_fraction.EscapingFraction'>                                         |
|  Apply to: disc_averaged_without_torus                                                                                                    |
|  Save emission: True                                                                                                                      |
|-------------------------------------------------------------------------------------------------------------------------------------------|
|  NLR_CONTINUUM (blackhole)                                                                                                                |
|-------------------------------------------------------------------------------------------------------------------------------------------|
|Transformer model:                                                                                                                         |
|  Transformer: <class 'synthesizer.emission_models.transformers.escape_fraction.CoveringFraction'>                                         |
|  Apply to: full_continuum_nlr                                                                                                             |
|  Save emission: True                                                                                                                      |
|-------------------------------------------------------------------------------------------------------------------------------------------|
|  LINE_REGIONS (blackhole)                                                                                                                 |
|-------------------------------------------------------------------------------------------------------------------------------------------|
|Combination model:                                                                                                                         |
|  Combine models: nlr, blr                                                                                                                 |
|  Save emission: True                                                                                                                      |
|-------------------------------------------------------------------------------------------------------------------------------------------|
|  BLR_CONTINUUM (blackhole)                                                                                                                |
|-------------------------------------------------------------------------------------------------------------------------------------------|
|Transformer model:                                                                                                                         |
|  Transformer: <class 'synthesizer.emission_models.transformers.escape_fraction.CoveringFraction'>                                         |
|  Apply to: full_continuum_blr                                                                                                             |
|  Save emission: True                                                                                                                      |
|===========================================================================================================================================|
../../_images/emission_models_premade_models_agn_models_22_1.png
[11]:
(<Figure size 600x600 with 1 Axes>, <Axes: >)
[12]:
# model with dust attenuation and emission
uni_model = UnifiedAGN(
    nlr_grid,
    blr_grid,
    torus_emission_model=Blackbody(1000 * kelvin),
    diffuse_dust_curve=PowerLaw(slope=-1.0),
    diffuse_dust_emission_model=Greybody(30 * kelvin, emissivity=2.0),
)
print(uni_model)

uni_model.plot_emission_tree(fontsize=7, figsize=(8, 6))
|====================================================================== EmissionModel: total ======================================================================|
|------------------------------------------------------------------------------------------------------------------------------------------------------------------|
|  DISC_INCIDENT_ISOTROPIC (blackhole)                                                                                                                             |
|------------------------------------------------------------------------------------------------------------------------------------------------------------------|
|Extraction model:                                                                                                                                                 |
|  Grid: test_grid_agn-nlr                                                                                                                                         |
|  Extract key: incident                                                                                                                                           |
|  Use velocity shift: False                                                                                                                                       |
|  Save emission: True                                                                                                                                             |
|  Fixed parameters:                                                                                                                                               |
|    - cosine_inclination: 0.5                                                                                                                                     |
|    - hydrogen_density: hydrogen_density_blr                                                                                                                      |
|    - ionisation_parameter: ionisation_parameter_blr                                                                                                              |
|------------------------------------------------------------------------------------------------------------------------------------------------------------------|
|  FULL_REPROCESSED_NLR (blackhole)                                                                                                                                |
|------------------------------------------------------------------------------------------------------------------------------------------------------------------|
|Extraction model:                                                                                                                                                 |
|  Grid: test_grid_agn-nlr                                                                                                                                         |
|  Extract key: nebular                                                                                                                                            |
|  Use velocity shift: False                                                                                                                                       |
|  Save emission: True                                                                                                                                             |
|  Fixed parameters:                                                                                                                                               |
|    - cosine_inclination: 0.5                                                                                                                                     |
|    - hydrogen_density: hydrogen_density_nlr                                                                                                                      |
|    - ionisation_parameter: ionisation_parameter_nlr                                                                                                              |
|------------------------------------------------------------------------------------------------------------------------------------------------------------------|
|  DISC_TRANSMITTED_NLR_FULL (blackhole)                                                                                                                           |
|------------------------------------------------------------------------------------------------------------------------------------------------------------------|
|Extraction model:                                                                                                                                                 |
|  Grid: test_grid_agn-nlr                                                                                                                                         |
|  Extract key: transmitted                                                                                                                                        |
|  Use velocity shift: False                                                                                                                                       |
|  Save emission: True                                                                                                                                             |
|  Fixed parameters:                                                                                                                                               |
|    - hydrogen_density: hydrogen_density_nlr                                                                                                                      |
|    - ionisation_parameter: ionisation_parameter_nlr                                                                                                              |
|    - torus_edgeon_cond: ParameterFunction(torus_edgeon_condition, sets='torus_edgeon_cond', args=('inclination', 'theta_torus'))                                 |
|  Masks:                                                                                                                                                          |
|    - torus_edgeon_cond < 90 degree                                                                                                                               |
|------------------------------------------------------------------------------------------------------------------------------------------------------------------|
|  DISC_TRANSMITTED_BLR_FULL (blackhole)                                                                                                                           |
|------------------------------------------------------------------------------------------------------------------------------------------------------------------|
|Extraction model:                                                                                                                                                 |
|  Grid: test_grid_agn-blr                                                                                                                                         |
|  Extract key: transmitted                                                                                                                                        |
|  Use velocity shift: False                                                                                                                                       |
|  Save emission: True                                                                                                                                             |
|  Fixed parameters:                                                                                                                                               |
|    - hydrogen_density: hydrogen_density_blr                                                                                                                      |
|    - ionisation_parameter: ionisation_parameter_blr                                                                                                              |
|    - torus_edgeon_cond: ParameterFunction(torus_edgeon_condition, sets='torus_edgeon_cond', args=('inclination', 'theta_torus'))                                 |
|  Masks:                                                                                                                                                          |
|    - torus_edgeon_cond < 90 degree                                                                                                                               |
|------------------------------------------------------------------------------------------------------------------------------------------------------------------|
|  DISC_INCIDENT_MASKED (blackhole)                                                                                                                                |
|------------------------------------------------------------------------------------------------------------------------------------------------------------------|
|Extraction model:                                                                                                                                                 |
|  Grid: test_grid_agn-nlr                                                                                                                                         |
|  Extract key: incident                                                                                                                                           |
|  Use velocity shift: False                                                                                                                                       |
|  Save emission: True                                                                                                                                             |
|  Fixed parameters:                                                                                                                                               |
|    - hydrogen_density: hydrogen_density_blr                                                                                                                      |
|    - ionisation_parameter: ionisation_parameter_blr                                                                                                              |
|    - torus_edgeon_cond: ParameterFunction(torus_edgeon_condition, sets='torus_edgeon_cond', args=('inclination', 'theta_torus'))                                 |
|  Masks:                                                                                                                                                          |
|    - torus_edgeon_cond < 90 degree                                                                                                                               |
|------------------------------------------------------------------------------------------------------------------------------------------------------------------|
|  FULL_REPROCESSED_BLR (blackhole)                                                                                                                                |
|------------------------------------------------------------------------------------------------------------------------------------------------------------------|
|Extraction model:                                                                                                                                                 |
|  Grid: test_grid_agn-blr                                                                                                                                         |
|  Extract key: nebular                                                                                                                                            |
|  Use velocity shift: False                                                                                                                                       |
|  Save emission: True                                                                                                                                             |
|  Fixed parameters:                                                                                                                                               |
|    - torus_edgeon_cond: ParameterFunction(torus_edgeon_condition, sets='torus_edgeon_cond', args=('inclination', 'theta_torus'))                                 |
|    - cosine_inclination: 0.5                                                                                                                                     |
|    - hydrogen_density: hydrogen_density_blr                                                                                                                      |
|    - ionisation_parameter: ionisation_parameter_blr                                                                                                              |
|  Masks:                                                                                                                                                          |
|    - torus_edgeon_cond < 90 degree                                                                                                                               |
|------------------------------------------------------------------------------------------------------------------------------------------------------------------|
|  DISC_TRANSMITTED_NLR_ISOTROPIC_FULL (blackhole)                                                                                                                 |
|------------------------------------------------------------------------------------------------------------------------------------------------------------------|
|Extraction model:                                                                                                                                                 |
|  Grid: test_grid_agn-nlr                                                                                                                                         |
|  Extract key: transmitted                                                                                                                                        |
|  Use velocity shift: False                                                                                                                                       |
|  Save emission: True                                                                                                                                             |
|  Fixed parameters:                                                                                                                                               |
|    - cosine_inclination: 0.5                                                                                                                                     |
|    - hydrogen_density: hydrogen_density_nlr                                                                                                                      |
|    - ionisation_parameter: ionisation_parameter_nlr                                                                                                              |
|------------------------------------------------------------------------------------------------------------------------------------------------------------------|
|  DISC_TRANSMITTED_BLR_ISOTROPIC_FULL (blackhole)                                                                                                                 |
|------------------------------------------------------------------------------------------------------------------------------------------------------------------|
|Extraction model:                                                                                                                                                 |
|  Grid: test_grid_agn-blr                                                                                                                                         |
|  Extract key: transmitted                                                                                                                                        |
|  Use velocity shift: False                                                                                                                                       |
|  Save emission: True                                                                                                                                             |
|  Fixed parameters:                                                                                                                                               |
|    - cosine_inclination: 0.5                                                                                                                                     |
|    - hydrogen_density: hydrogen_density_blr                                                                                                                      |
|    - ionisation_parameter: ionisation_parameter_blr                                                                                                              |
|------------------------------------------------------------------------------------------------------------------------------------------------------------------|
|  FULL_CONTINUUM_NLR (blackhole)                                                                                                                                  |
|------------------------------------------------------------------------------------------------------------------------------------------------------------------|
|Extraction model:                                                                                                                                                 |
|  Grid: test_grid_agn-nlr                                                                                                                                         |
|  Extract key: nebular_continuum                                                                                                                                  |
|  Use velocity shift: False                                                                                                                                       |
|  Save emission: True                                                                                                                                             |
|  Fixed parameters:                                                                                                                                               |
|    - cosine_inclination: 0.5                                                                                                                                     |
|    - hydrogen_density: hydrogen_density_nlr                                                                                                                      |
|    - ionisation_parameter: ionisation_parameter_nlr                                                                                                              |
|------------------------------------------------------------------------------------------------------------------------------------------------------------------|
|  FULL_CONTINUUM_BLR (blackhole)                                                                                                                                  |
|------------------------------------------------------------------------------------------------------------------------------------------------------------------|
|Extraction model:                                                                                                                                                 |
|  Grid: test_grid_agn-blr                                                                                                                                         |
|  Extract key: nebular_continuum                                                                                                                                  |
|  Use velocity shift: False                                                                                                                                       |
|  Save emission: True                                                                                                                                             |
|  Fixed parameters:                                                                                                                                               |
|    - torus_edgeon_cond: ParameterFunction(torus_edgeon_condition, sets='torus_edgeon_cond', args=('inclination', 'theta_torus'))                                 |
|    - cosine_inclination: 0.5                                                                                                                                     |
|    - hydrogen_density: hydrogen_density_blr                                                                                                                      |
|    - ionisation_parameter: ionisation_parameter_blr                                                                                                              |
|  Masks:                                                                                                                                                          |
|    - torus_edgeon_cond < 90 degree                                                                                                                               |
|------------------------------------------------------------------------------------------------------------------------------------------------------------------|
|  DISC_INCIDENT (blackhole)                                                                                                                                       |
|------------------------------------------------------------------------------------------------------------------------------------------------------------------|
|Extraction model:                                                                                                                                                 |
|  Grid: test_grid_agn-nlr                                                                                                                                         |
|  Extract key: incident                                                                                                                                           |
|  Use velocity shift: False                                                                                                                                       |
|  Save emission: True                                                                                                                                             |
|  Fixed parameters:                                                                                                                                               |
|    - hydrogen_density: hydrogen_density_blr                                                                                                                      |
|    - ionisation_parameter: ionisation_parameter_blr                                                                                                              |
|------------------------------------------------------------------------------------------------------------------------------------------------------------------|
|  TORUS (blackhole)                                                                                                                                               |
|------------------------------------------------------------------------------------------------------------------------------------------------------------------|
|Generation model:                                                                                                                                                 |
|  Emission generation model: Blackbody(scaler=disc_incident_isotropic, temperature=1000 K)                                                                        |
|  Scaler model: disc_incident_isotropic                                                                                                                           |
|  Save emission: True                                                                                                                                             |
|  Scaling by:                                                                                                                                                     |
|    - torus_fraction                                                                                                                                              |
|------------------------------------------------------------------------------------------------------------------------------------------------------------------|
|  NLR (blackhole)                                                                                                                                                 |
|------------------------------------------------------------------------------------------------------------------------------------------------------------------|
|Transformer model:                                                                                                                                                |
|  Transformer: <class 'synthesizer.emission_models.transformers.escape_fraction.CoveringFraction'>                                                                |
|  Apply to: full_reprocessed_nlr                                                                                                                                  |
|  Save emission: True                                                                                                                                             |
|------------------------------------------------------------------------------------------------------------------------------------------------------------------|
|  DISC_TRANSMITTED_NLR (blackhole)                                                                                                                                |
|------------------------------------------------------------------------------------------------------------------------------------------------------------------|
|Transformer model:                                                                                                                                                |
|  Transformer: <class 'synthesizer.emission_models.transformers.escape_fraction.CoveringFraction'>                                                                |
|  Apply to: disc_transmitted_nlr_full                                                                                                                             |
|  Save emission: True                                                                                                                                             |
|  Fixed parameters:                                                                                                                                               |
|    - transmission_fraction_nlr: transmission_fraction_nlr                                                                                                        |
|------------------------------------------------------------------------------------------------------------------------------------------------------------------|
|  DISC_TRANSMITTED_BLR (blackhole)                                                                                                                                |
|------------------------------------------------------------------------------------------------------------------------------------------------------------------|
|Transformer model:                                                                                                                                                |
|  Transformer: <class 'synthesizer.emission_models.transformers.escape_fraction.CoveringFraction'>                                                                |
|  Apply to: disc_transmitted_blr_full                                                                                                                             |
|  Save emission: True                                                                                                                                             |
|  Fixed parameters:                                                                                                                                               |
|    - transmission_fraction_blr: transmission_fraction_blr                                                                                                        |
|------------------------------------------------------------------------------------------------------------------------------------------------------------------|
|  DISC_ESCAPED (blackhole)                                                                                                                                        |
|------------------------------------------------------------------------------------------------------------------------------------------------------------------|
|Transformer model:                                                                                                                                                |
|  Transformer: <class 'synthesizer.emission_models.transformers.escape_fraction.CoveringFraction'>                                                                |
|  Apply to: disc_incident_masked                                                                                                                                  |
|  Save emission: True                                                                                                                                             |
|  Fixed parameters:                                                                                                                                               |
|    - transmission_fraction_escape: transmission_fraction_escape                                                                                                  |
|------------------------------------------------------------------------------------------------------------------------------------------------------------------|
|  DISC_TRANSMITTED (blackhole)                                                                                                                                    |
|------------------------------------------------------------------------------------------------------------------------------------------------------------------|
|Combination model:                                                                                                                                                |
|  Combine models: disc_escaped, disc_transmitted_nlr, disc_transmitted_blr                                                                                        |
|  Save emission: True                                                                                                                                             |
|------------------------------------------------------------------------------------------------------------------------------------------------------------------|
|  DISC (blackhole)                                                                                                                                                |
|------------------------------------------------------------------------------------------------------------------------------------------------------------------|
|Combination model:                                                                                                                                                |
|  Combine models: disc_transmitted                                                                                                                                |
|  Save emission: True                                                                                                                                             |
|------------------------------------------------------------------------------------------------------------------------------------------------------------------|
|  BLR (blackhole)                                                                                                                                                 |
|------------------------------------------------------------------------------------------------------------------------------------------------------------------|
|Transformer model:                                                                                                                                                |
|  Transformer: <class 'synthesizer.emission_models.transformers.escape_fraction.CoveringFraction'>                                                                |
|  Apply to: full_reprocessed_blr                                                                                                                                  |
|  Save emission: True                                                                                                                                             |
|------------------------------------------------------------------------------------------------------------------------------------------------------------------|
|  INTRINSIC (blackhole)                                                                                                                                           |
|------------------------------------------------------------------------------------------------------------------------------------------------------------------|
|Combination model:                                                                                                                                                |
|  Combine models: disc, nlr, blr, torus                                                                                                                           |
|  Save emission: True                                                                                                                                             |
|------------------------------------------------------------------------------------------------------------------------------------------------------------------|
|  ATTENUATED (blackhole)                                                                                                                                          |
|------------------------------------------------------------------------------------------------------------------------------------------------------------------|
|Transformer model:                                                                                                                                                |
|  Transformer: <class 'synthesizer.emission_models.transformers.dust_attenuation.PowerLaw'>                                                                       |
|  Apply to: intrinsic                                                                                                                                             |
|  Save emission: True                                                                                                                                             |
|  Fixed parameters:                                                                                                                                               |
|    - tau_v: tau_v                                                                                                                                                |
|------------------------------------------------------------------------------------------------------------------------------------------------------------------|
|  DIFFUSE_DUST_EMISSION (blackhole)                                                                                                                               |
|------------------------------------------------------------------------------------------------------------------------------------------------------------------|
|Generation model:                                                                                                                                                 |
|  Emission generation model: Greybody(intrinsic=intrinsic, attenuated=attenuated, temperature=30 K, emissivity=2.0, optically_thin=True, lam_0=100.0 μm)          |
|  Intrinsic energy balance model: intrinsic                                                                                                                       |
|  Attenuated energy balance model: attenuated                                                                                                                     |
|  Save emission: True                                                                                                                                             |
|------------------------------------------------------------------------------------------------------------------------------------------------------------------|
|  TOTAL (blackhole)                                                                                                                                               |
|------------------------------------------------------------------------------------------------------------------------------------------------------------------|
|Combination model:                                                                                                                                                |
|  Combine models: attenuated, diffuse_dust_emission                                                                                                               |
|  Save emission: True                                                                                                                                             |
|------------------------------------------------------------------------------------------------------------------------------------------------------------------|
|  DISC_TRANSMITTED_NLR_WEIGHTED (blackhole)                                                                                                                       |
|------------------------------------------------------------------------------------------------------------------------------------------------------------------|
|Transformer model:                                                                                                                                                |
|  Transformer: <class 'synthesizer.emission_models.transformers.escape_fraction.CoveringFraction'>                                                                |
|  Apply to: disc_transmitted_nlr_full                                                                                                                             |
|  Save emission: True                                                                                                                                             |
|------------------------------------------------------------------------------------------------------------------------------------------------------------------|
|  DISC_TRANSMITTED_BLR_WEIGHTED (blackhole)                                                                                                                       |
|------------------------------------------------------------------------------------------------------------------------------------------------------------------|
|Transformer model:                                                                                                                                                |
|  Transformer: <class 'synthesizer.emission_models.transformers.escape_fraction.CoveringFraction'>                                                                |
|  Apply to: disc_transmitted_blr_full                                                                                                                             |
|  Save emission: True                                                                                                                                             |
|------------------------------------------------------------------------------------------------------------------------------------------------------------------|
|  DISC_ESCAPED_WEIGHTED (blackhole)                                                                                                                               |
|------------------------------------------------------------------------------------------------------------------------------------------------------------------|
|Transformer model:                                                                                                                                                |
|  Transformer: <class 'synthesizer.emission_models.transformers.escape_fraction.CoveringFraction'>                                                                |
|  Apply to: disc_incident_masked                                                                                                                                  |
|  Save emission: True                                                                                                                                             |
|------------------------------------------------------------------------------------------------------------------------------------------------------------------|
|  DISC_TRANSMITTED_WEIGHTED_COMBINATION (blackhole)                                                                                                               |
|------------------------------------------------------------------------------------------------------------------------------------------------------------------|
|Combination model:                                                                                                                                                |
|  Combine models: disc_escaped_weighted, disc_transmitted_nlr_weighted, disc_transmitted_blr_weighted                                                             |
|  Save emission: True                                                                                                                                             |
|------------------------------------------------------------------------------------------------------------------------------------------------------------------|
|  DISC_ESCAPED_ISOTROPIC (blackhole)                                                                                                                              |
|------------------------------------------------------------------------------------------------------------------------------------------------------------------|
|Transformer model:                                                                                                                                                |
|  Transformer: <class 'synthesizer.emission_models.transformers.escape_fraction.EscapingFraction'>                                                                |
|  Apply to: disc_incident_isotropic                                                                                                                               |
|  Save emission: True                                                                                                                                             |
|------------------------------------------------------------------------------------------------------------------------------------------------------------------|
|  DISC_TRANSMITTED_NLR_ISOTROPIC (blackhole)                                                                                                                      |
|------------------------------------------------------------------------------------------------------------------------------------------------------------------|
|Transformer model:                                                                                                                                                |
|  Transformer: <class 'synthesizer.emission_models.transformers.escape_fraction.CoveringFraction'>                                                                |
|  Apply to: disc_transmitted_nlr_isotropic_full                                                                                                                   |
|  Save emission: True                                                                                                                                             |
|------------------------------------------------------------------------------------------------------------------------------------------------------------------|
|  DISC_TRANSMITTED_BLR_ISOTROPIC (blackhole)                                                                                                                      |
|------------------------------------------------------------------------------------------------------------------------------------------------------------------|
|Transformer model:                                                                                                                                                |
|  Transformer: <class 'synthesizer.emission_models.transformers.escape_fraction.CoveringFraction'>                                                                |
|  Apply to: disc_transmitted_blr_isotropic_full                                                                                                                   |
|  Save emission: True                                                                                                                                             |
|------------------------------------------------------------------------------------------------------------------------------------------------------------------|
|  DISC_AVERAGED_WITHOUT_TORUS (blackhole)                                                                                                                         |
|------------------------------------------------------------------------------------------------------------------------------------------------------------------|
|Combination model:                                                                                                                                                |
|  Combine models: disc_escaped_isotropic, disc_transmitted_nlr_isotropic, disc_transmitted_blr_isotropic                                                          |
|  Save emission: True                                                                                                                                             |
|------------------------------------------------------------------------------------------------------------------------------------------------------------------|
|  DISC_AVERAGED (blackhole)                                                                                                                                       |
|------------------------------------------------------------------------------------------------------------------------------------------------------------------|
|Transformer model:                                                                                                                                                |
|  Transformer: <class 'synthesizer.emission_models.transformers.escape_fraction.EscapingFraction'>                                                                |
|  Apply to: disc_averaged_without_torus                                                                                                                           |
|  Save emission: True                                                                                                                                             |
|------------------------------------------------------------------------------------------------------------------------------------------------------------------|
|  NLR_CONTINUUM (blackhole)                                                                                                                                       |
|------------------------------------------------------------------------------------------------------------------------------------------------------------------|
|Transformer model:                                                                                                                                                |
|  Transformer: <class 'synthesizer.emission_models.transformers.escape_fraction.CoveringFraction'>                                                                |
|  Apply to: full_continuum_nlr                                                                                                                                    |
|  Save emission: True                                                                                                                                             |
|------------------------------------------------------------------------------------------------------------------------------------------------------------------|
|  LINE_REGIONS (blackhole)                                                                                                                                        |
|------------------------------------------------------------------------------------------------------------------------------------------------------------------|
|Combination model:                                                                                                                                                |
|  Combine models: nlr, blr                                                                                                                                        |
|  Save emission: True                                                                                                                                             |
|------------------------------------------------------------------------------------------------------------------------------------------------------------------|
|  BLR_CONTINUUM (blackhole)                                                                                                                                       |
|------------------------------------------------------------------------------------------------------------------------------------------------------------------|
|Transformer model:                                                                                                                                                |
|  Transformer: <class 'synthesizer.emission_models.transformers.escape_fraction.CoveringFraction'>                                                                |
|  Apply to: full_continuum_blr                                                                                                                                    |
|  Save emission: True                                                                                                                                             |
|==================================================================================================================================================================|
../../_images/emission_models_premade_models_agn_models_23_1.png
[12]:
(<Figure size 800x600 with 1 Axes>, <Axes: >)

Fully worked examples

Fully worked examples demonstrating the use of the UnifiedAGN model can be found in the following notebooks:

  • This notebook provides a step-by-step guide to constructing the intrinsic spectrum of a black hole using the UnifiedAGN framework, including examples of configuring model parameters and generating output spectra.
  • Here we show how to build the full, composite spectrum of a galaxy that includes both stellar emission and an AGN component. The notebook also illustrates how to incorporate attenuation and reprocessing effects.
  • This example demonstrates how to derive broadband photometry from composite galaxy spectra, showing how to apply filter curves, compute fluxes, and generate synthetic observations.

These notebooks provide complete, ready-to-run examples and are the recommended starting point for anyone wishing to use or adapt the UnifiedAGN model in their own workflows.