Welcome to DAO’s documentation!

DAO is a new and open source reflection model for black hole accretion disks.

Table of Contents:

• Introduction
• Installation
  • Prerequisites
  • Installation Steps
• Quick Start
  • Run Code with Python
• Input Parameters
  • Summary
  • Detailed Description
• Output Files
  • Summary
  • Detailed Description
• Example
  • Effect of ionization parameters
  • Effect of incidence angle
  • Ions Fractions
  • Heating and cooling rate
  • Relativistic spectrum
• Theory
  • Radiative transfer
  • Compton scattering
  • Atom Physics
  • Algorithm
• Known Issues and Limitations
• Version
  • v1.1
  • v1.1.2
  • v1.1.3
  • v1.1.4

[1]

T. M. Belloni. States and Transitions in Black Hole Binaries. In Tomaso Belloni, editor, Lecture Notes in Physics, Berlin Springer Verlag, volume 794, pages 53. 2010. doi:10.1007/978-3-540-76937-8_3.

[2]

K. S. Thorne and R. H. Price. Cygnus X-1: an interpretation of the spectrum and its variability. \apjl , 195:L101–L105, February 1975. doi:10.1086/181720.

[3]

R. A. Sunyaev and J. Truemper. Hard X-ray spectrum of CYG X-1. \nat , 279:506–508, June 1979. doi:10.1038/279506a0.

[4]

G. Matt, G. C. Perola, and L. Piro. The iron line and high energy bump as X-ray signatures of cold matter in Seyfert 1 galaxies. \aap , 247:25, July 1991.

[5]

I. D. Novikov and K. S. Thorne. Astrophysics of black holes. In C. DeWitt and B. S. DeWitt, editors, Black Holes (Les Astres Occlus), 343–450. New York, January 1973. Gordon and Breach Science Publishers.

[6]

Adam R. Ingram and Sara E. Motta. A review of quasi-periodic oscillations from black hole X-ray binaries: Observation and theory. \nar , 85:101524, September 2019. arXiv:2001.08758, doi:10.1016/j.newar.2020.101524.

[7]

Honghui Liu, Jiachen Jiang, Zuobin Zhang, Cosimo Bambi, Andrew C. Fabian, Javier A. García, Adam Ingram, Erin Kara, James F. Steiner, John A. Tomsick, Dominic J. Walton, and Andrew J. Young. High-density Reflection Spectroscopy of Black Hole X-Ray Binaries in the Hard State. \apj , 951(2):145, July 2023. arXiv:2303.10593, doi:10.3847/1538-4357/acd8b9.

[8]

R. R. Ross and A. C. Fabian. A comprehensive range of X-ray ionized-reflection models. \mnras , 358(1):211–216, March 2005. arXiv:astro-ph/0501116, doi:10.1111/j.1365-2966.2005.08797.x.

[9]

J. García and T. R. Kallman. X-ray Reflected Spectra from Accretion Disk Models. I. Constant Density Atmospheres. \apj , 718(2):695–706, August 2010. arXiv:1006.0485, doi:10.1088/0004-637X/718/2/695.

[10]

J. García, T. Dauser, C. S. Reynolds, T. R. Kallman, J. E. McClintock, J. Wilms, and W. Eikmann. X-Ray Reflected Spectra from Accretion Disk Models. III. A Complete Grid of Ionized Reflection Calculations. \apj , 768(2):146, May 2013. arXiv:1303.2112, doi:10.1088/0004-637X/768/2/146.

[11]

J. García, T. Dauser, A. Lohfink, T. R. Kallman, J. F. Steiner, J. E. McClintock, L. Brenneman, J. Wilms, W. Eikmann, C. S. Reynolds, and F. Tombesi. Improved Reflection Models of Black Hole Accretion Disks: Treating the Angular Distribution of X-Rays. \apj , 782(2):76, February 2014. arXiv:1312.3231, doi:10.1088/0004-637X/782/2/76.

[12]

T. Kallman, M. Bautista, J. Deprince, J. A. García, C. Mendoza, A. Ogorzalek, P. Palmeri, and P. Quinet. Photoionization Models for High-density Gas. \apj , 908(1):94, February 2021. arXiv:2011.10603, doi:10.3847/1538-4357/abccd6.

[13]

C. Bruce Tarter, Wallace H. Tucker, and Edwin E. Salpeter. The Interaction of X-Ray Sources with Optically Thin Environments. \apj , 156:943, June 1969. doi:10.1086/150026.

[14]

A. A. Zdziarski, W. N. Johnson, and P. Magdziarz. Broad-band \ensuremath \gamma -ray and X-ray spectra of NGC 4151 and their implications for physical processes and geometry. \mnras , 283(1):193–206, November 1996. arXiv:astro-ph/9607015, doi:10.1093/mnras/283.1.193.

[15]

Lev Titarchuk. Generalized Comptonization Models and Application to the Recent High-Energy Observations. \apj , 434:570, October 1994. doi:10.1086/174760.

[16]

N. Grevesse, A. Noels, and A. J. Sauval. Standard Abundances. In Stephen S. Holt and George Sonneborn, editors, Cosmic Abundances, volume 99 of Astronomical Society of the Pacific Conference Series, 117. January 1996.

[17]

Yimin Huang, Honghui Liu, Temurbek Mirzaev, Ningyue Fan, Cosimo Bambi, Zuobin Zhang, Thomas Dauser, Javier A. García, Adam Ingram, Jiachen Jiang, Guglielmo Mastroserio, Shafqat Riaz, and Swarnim Shashank. X-Ray Reflection Spectroscopy with Improved Calculations of the Emission Angle. \apj , 989(2):168, August 2025. arXiv:2506.00946, doi:10.3847/1538-4357/adf111.

[18]

T. Dauser, J. Wilms, C. S. Reynolds, and L. W. Brenneman. Broad emission lines for a negatively spinning black hole. \mnras , 409(4):1534–1540, December 2010. arXiv:1007.4937, doi:10.1111/j.1365-2966.2010.17393.x.

[19]

K. A. Arnaud. XSPEC: The First Ten Years. In George H. Jacoby and Jeannette Barnes, editors, Astronomical Data Analysis Software and Systems V, volume 101 of Astronomical Society of the Pacific Conference Series, 17. January 1996.

[20]

Arthur Schuster. Radiation Through a Foggy Atmosphere. \apj , 21:1, January 1905. doi:10.1086/141186.

[21]

Lawrence Auer. Improved Boundary Conditions for the Feautrier Method. \apjl , 150:L53, October 1967. doi:10.1086/180091.

[22]

D. I. Nagirner and Yu. J. Poutanen. Compton scattering by Maxwellian electrons - Redistribution of radiation according to frequencies and directions. Astronomy Letters, 19(7):262–267, July 1993.

[23]

Juri Poutanen and Roland Svensson. The Two-Phase Pair Corona Model for Active Galactic Nuclei and X-Ray Binaries: How to Obtain Exact Solutions. \apj , 470:249, October 1996. arXiv:astro-ph/9605073, doi:10.1086/177865.

[24]

Juri Poutanen and Indrek Vurm. Theory of Compton Scattering by Anisotropic Electrons. \apjs , 189(2):286–308, August 2010. arXiv:1006.2397, doi:10.1088/0067-0049/189/2/286.

[25]

J. Madej, A. Różańska, A. Majczyna, and M. Należyty. On the Compton scattering redistribution function in plasma. \mnras , 469(2):2032–2041, August 2017. arXiv:1602.05088, doi:10.1093/mnras/stx994.

[26]

Javier A. García, Ekaterina Sokolova-Lapa, Thomas Dauser, Jerzy Madej, Agata Różańska, Agnieszka Majczyna, Fiona A. Harrison, and Jörn Wilms. Accurate Treatment of Comptonization in X-Ray Illuminated Accretion Disks. \apj , 897(1):67, July 2020. arXiv:2005.04852, doi:10.3847/1538-4357/ab919b.

[27]

R. R. Ross, R. Weaver, and R. McCray. The Comptonization of iron X-ray features in compact X-ray sources. \apj , 219:292–299, January 1978. doi:10.1086/155776.

[28]

Sergei Nayakshin, Demosthenes Kazanas, and Timothy R. Kallman. Thermal Instability and Photoionized X-Ray Reflection in Accretion Disks. \apj , 537(2):833–852, July 2000. arXiv:astro-ph/9909359, doi:10.1086/309054.

[29]

R. Svensson. The pair annihilation process in relativistic plasmas. \apj , 258:321–334, July 1982. doi:10.1086/160081.

[30]

missing publisher in 1973erh..book.....P