The Astropy project supports and fosters the development of open-source and openly-developed Python packages that provide commonly-needed functionality to the astronomical community. A key element of the Astropy project is the core package Astropy, which serves as the foundation for more specialized projects and packages. In this article, we provide an overview of the organization of the Astropy project and summarize key features in the core package as of the recent major release, version 2.0. We then describe the project infrastructure designed to facilitate and support development for a broader ecosystem of inter-operable packages. We conclude with a future outlook of planned new features and directions for the broader Astropy project.

General relativistic magnetohydrodynamic (GRMHD) simulations are providing influential models for black hole spin measurements, gamma ray bursts, and supermassive black hole feedback. Many of these simulations use the same initial condition: a rotating torus of fluid in hydrostatic equilibrium. A persistent concern is that simulation results sometimes depend on arbitrary features of the initial torus. For example, the Bernoulli parameter (which is related to outflows), appears to be controlled by the Bernoulli parameter of the initial torus. In this paper, we give a new equilibrium torus solution and describe two applications for the future. First, it can be used as a more physical initial condition for GRMHD simulations than earlier torus solutions. Second, it can be used in conjunction with earlier torus solutions to isolate the simulation results that depend on initial conditions. We assume axisymmetry, an ideal gas equation of state, constant entropy, and ignore self-gravity. We fix an angular momentum distribution and solve the relativistic Euler equations in the Kerr metric. The Bernoulli parameter, rotation rate, and geometrical thickness of the torus can be adjusted independently. Our torus tends to be more bound and have a larger radial extent than earlier torus solutions. While this paper was in preparation, several GRMHD simulations appeared based on our equilibrium torus. We believe it will continue to provide a more realistic starting point for future simulations.

We present an analytical formula for the position and shape of the spots on the surface of accreting magnetized stars in cases where a star has a dipole magnetic field tilted at a small misalignment angle Theta < 30 degrees about the rotational axis, and the magnetosphere is 2.5-5 times the radius of the star. We observed that the azimuthal position of the spots varies significantly when the position of the inner disc varies. In contrast, the polar position of the spots varies only slightly because of the compression of the magnetosphere. The azimuthal width of the spots strongly varies with Theta: spots have the shape of an arc at larger misalignment angles, and resemble a ring at very small misalignment angles. The polar width of the spots varies only slightly with changes in parameters. The motion of the spots in the azimuthal direction can provide phase-shifts in accreting millisecond pulsars, and the "drift" of the period in Classical T Tauri stars. The position and shape of the spots are determined by three parameters: misalignment angle Theta; normalized corotation radius, r_c/R_* and normalized magnetospheric radius, r_m/R_*, where R_* is the stellar radius. We also use our data to check the formula for the Alfv\'en radius, where the main dependencies are r_m \sim (\mu^2/\dot M)^{2/7}, where \mu is the magnetic moment of the star, and \dot M is the accretion rate. We found that the dependence is more gradual, r_m \sim (\mu^2/\dot M)^{1/5}, which can be explained by the compression of the magnetosphere by the disc matter and by the non-dipole shape of the magnetic field lines of the external magnetosphere.

Almost all hydrodynamic accretion disk models parametrize viscosity with the dimensionless parameter alpha. There is no detailed model for alpha, so it is usually taken to be a constant. However, global simulations of magnetohydrodynamic disks find that alpha varies with distance from the central object. Also, Newtonian simulations tend to find smaller alpha's than general relativistic simulations. We seek a one-dimensional model for alpha that can reproduce these two observations. We are guided by data from six general relativistic magnetohydrodynamic accretion disk simulations. The variation of alpha in the inner, laminar regions of the flow results from stretching of mean magnetic field lines by the flow. The variation of alpha in the outer, turbulent regions results from the dependence of the magnetorotational instability on the dimensionless shear rate. We give a one-dimensional prescription for alpha(r) that captures these two effects and reproduces the radial variation of alpha observed in the simulations. For thin disks, the prescription simplifies to the formula alpha(r)=0.025[q(r)/1.5]^6, where the shear parameter, q(r), is an analytical function of radius in the Kerr metric. The coefficient and exponent are inferred from our simulations and will change as better simulation data becomes available. We conclude that the alpha-viscosity prescription can be extended to the radially varying alpha's observed in simulations. It is possible that Newtonian simulations find smaller alpha's than general relativistic simulations because the shear parameter is lower in Newtonian flows.

We present results from two long-duration GRMHD simulations of advection-dominated accretion around a non-spinning black hole. The first simulation was designed to avoid significant accumulation of magnetic flux around the black hole. This simulation was run for a time of 200,000GM/c^3 and achieved inflow equilibrium out to a radius \sim90GM/c^2. Even at this relatively large radius, the mass outflow rate \dot{M}_{out} is found to be only 60% of the net mass inflow rate \dot{M}_{BH} into the black hole. The second simulation was designed to achieve substantial magnetic flux accumulation around the black hole in a magnetically arrested disc. This simulation was run for a shorter time of 100,000GM/c^3. Nevertheless, because the mean radial velocity was several times larger than in the first simulation, it reached inflow equilibrium out to a radius \sim170GM/c^2. Here, \dot{M}_{out} becomes equal to \dot{M}_{BH} at r\sim 160GM/c^2. Since the mass outflow rates in the two simulations do not show robust convergence with time, it is likely that the true outflow rates are lower than our estimates. The effect of black hole spin on mass outflow remains to be explored. Neither simulation shows strong evidence for convection, though a complete analysis including the effect of magnetic fields is left for the future.

It is generally thought that the light coming from the inner plunging region of black hole accretion discs contributes negligibly to the disc's overall spectrum, i.e. the plunging fluid is swallowed by the black hole before it has time to radiate. In the standard disc model used to fit X-ray observations of accretion discs, the plunging region is assumed to be perfectly dark. However, numerical simulations that include the full physics of the magnetized flow predict that a small fraction of the disc's total luminosity emanates from the plunging region. We investigate the observational consequences of this neglected inner light. We compute radiative transfer based disc spectra that correspond to 3D general relativistic magnetohydrodynamic simulated discs (which produce light inside their plunging regions). In the context of black hole spin estimation, we find that the neglected inner light only has a modest effect (this bias is less than typical observational systematic errors). For rapidly spinning black holes, we find that the combined emission from the plunging region produces a weak power-law tail at high energies. This indicates that infalling matter is the origin for some of the `coronal' emission observed in the thermal dominant and steep power-law states of X-ray binaries.

The X-ray spectra of accretion discs of eight stellar-mass black holes have been analyzed to date using the thermal continuum fitting method, and the spectral fits have been used to estimate the spin parameters of the black holes. However, the underlying model used in this method of estimating spin is the general relativistic thin-disc model of Novikov & Thorne, which is only valid for razor-thin discs. We therefore expect errors in the measured values of spin due to inadequacies in the theoretical model. We investigate this issue by computing spectra of numerically calculated models of thin accretion discs around black holes, obtained via three-dimensional general relativistic magnetohydrodynamic (GRMHD) simulations. We apply the continuum fitting method to these computed spectra to estimate the black hole spins and check how closely the values match the actual spin used in the GRMHD simulations. We find that the error in the dimensionless spin parameter is up to about 0.2 for a non-spinning black hole, depending on the inclination. For black holes with spins of 0.7, 0.9 and 0.98, the errors are up to about 0.1, 0.03 and 0.01 respectively. These errors are comparable to or smaller than those arising from current levels of observational uncertainty. Furthermore, we estimate that the GRMHD simulated discs from which these error estimates are obtained correspond to effective disc luminosities of about 0.4-0.7 Eddington, and that the errors will be smaller for discs with luminosities of 0.3 Eddington or less, which are used in the continuum-fitting method. We thus conclude that use of the Novikov-Thorne thin-disc model does not presently limit the accuracy of the continuum-fitting method of measuring black hole spin.

A typical galaxy is thought to contain tens of millions of stellar-mass black holes, the collapsed remnants of once massive stars, and a single nuclear supermassive black hole. Both classes of black holes accrete gas from their environments. The accreting gas forms a flattened orbiting structure known as an accretion disk. During the past several years, it has become possible to obtain measurements of the spins of the two classes of black holes by modeling the X-ray emission from their accretion disks. Two methods are employed, both of which depend upon identifying the inner radius of the accretion disk with the innermost stable circular orbit (ISCO), whose radius depends only on the mass and spin of the black hole. In the Fe K method, which applies to both classes of black holes, one models the profile of the relativistically-broadened iron line with a special focus on the gravitationally redshifted red wing of the line. In the continuum-fitting method, which has so far only been applied to stellar-mass black holes, one models the thermal X-ray continuum spectrum of the accretion disk. We discuss both methods, with a strong emphasis on the continuum-fitting method and its application to stellar-mass black holes. Spin results for eight stellar-mass black holes are summarized. These data are used to argue that the high spins of at least some of these black holes are natal, and that the presence or absence of relativistic jets in accreting black holes is not entirely determined by the spin of the black hole.

We present recent results of 3D magnetohydrodynamic simulations of neutron stars with small misalignment angles, as regards the features in lightcurves produced by regular movements of the hot spots during accretion onto the star. In particular, we show that the variation of position of the hot spot created by the infalling matter, as observed in 3D simulations, can produce high frequency Quasi Periodic Oscillations with frequencies associated with the inner zone of the disk. Previously reported simulations showed that the usual assumption of a fixed hot spot near the polar region is valid only for misalignment angles relatively large. Otherwise, two phenomena challenge the assumption: one is the presence of Rayleigh-Taylor instabilities at the disk-magnetospheric boundary, which produce tongues of accreting matter that can reach the star almost anywhere between the equator and the polar region; the other one is the motion of the hot spot around the magnetic pole during stable accretion. In this paper we start by showing that both phenomena are capable of producing short-term oscillations in the lightcurves. We then use Monte Carlo techniques to produce model lightcurves based on the features of the movements observed, and we show that the main features of kHz QPOs can be reproduced. Finally, we show the behavior of the frequencies of the moving spots as the mass accretion rate changes, and propose a mechanism for the production of double QPO peaks.

The magnetic field of the classical T Tauri star BP Tau can be approximated as a superposition of dipole and octupole moments with respective strengths of the polar magnetic fields of 1.2 kG and 1.6 kG (Donati et al. 2008). We adopt the measured properties of BP Tau and model the disc accretion onto the star. We observed in simulations that the disc is disrupted by the dipole component and matter flows towards the star in two funnel streams which form two accretion spots below the dipole magnetic poles. The octupolar component becomes dynamically important very close to the star and it redirects the matter flow to higher latitudes. The spots are meridionally elongated and are located at higher latitudes, compared with the pure dipole case, where crescent-shaped, latitudinally elongated spots form at lower latitudes. The position and shape of the spots are in good agreement with observations. The disk-magnetosphere interaction leads to the inflation of the field lines and to the formation of magnetic towers above and below the disk. The magnetic field of BP Tau is close to the potential only near the star, inside the magnetospheric surface, where magnetic stress dominates over the matter stress. A series of simulation runs were performed for different accretion rates. They show that an accretion rate is lower than obtained in many observations, unless the disc is truncated close to the star. The torque acting on the star is about an order of magnitude lower than that which is required for the rotational equilibrium. We suggest that a star could lose most of its angular momentum at earlier stages of its evolution.

The magnetic field of the classical T Tauri star V2129 Oph can be modeled approximately by superposing slightly tilted dipole and octupole moments, with polar magnetic field strengths of 0.35kG and 1.2kG respectively (Donati et al. 2007). Here we construct a numerical model of V2129 Oph incorporating this result and simulate accretion onto the star. Simulations show that the disk is truncated by the dipole component and matter flows towards the star in two funnel streams. Closer to the star, the flow is redirected by the octupolar component, with some of the matter flowing towards the high-latitude poles, and the rest into the octupolar belts. The shape and position of the spots differ from those in a pure dipole case, where crescent-shaped spots are observed at the intermediate latitudes. Simulations show that if the disk is truncated at the distance of 6.2 R_* which is comparable with the co-rotation radius, 6.8 R_*, then the high-latitude polar spots dominate, but the accretion rate obtained from the simulations is about an order of magnitude lower than the observed one. The accretion rate matches the observed one if the disk is disrupted much closer to the star, at 3.4 R_*. However, the octupolar belt spots strongly dominate. Better match has been obtained in experiments with a dipole field twice as strong. The torque on the star from the disk-magnetosphere interaction is small, and the time-scale of spin evolution, 2 x10^7-10^9 years is longer than the 2x10^6 years age of V2129 Oph. The external magnetic flux of the star is strongly influenced by the disk: the field lines connecting the disk and the star inflate and form magnetic towers above and below the disk. The potential (vacuum) approximation is still valid inside the Alfv\'en (magnetospheric) surface where the magnetic stress dominates over the matter stress.

3D Magnetohydrodynamic simulations show that when matter accretes onto neutron stars, in particular if the misalignment angle is small, it does not constantly fall at a fixed spot. Instead, the location at which matter reaches the star moves. These moving hot spots can be produced both during stable accretion, where matter falls near the magnetic poles of the star, and unstable accretion, characterized by the presence of several tongues of matter which fall on the star near the equator, due to Rayleigh-Taylor instabilities. Precise modeling with Monte Carlo simulations shows that those movements could be observed as high frequency Quasi Periodic Oscillations. We performed a number of new simulation runs with a much wider set of parameters, focusing on neutron stars with a small misalignment angle. In most cases we observe oscillations whose frequency is correlated with the mass accretion rate $\dot{M}$. Moreover, in some cases double QPOs appear, each of them showing the same correlation with $\dot{M}$.

We investigate the photometric variability of magnetized stars, particularly neutron stars, accreting through a magnetic Rayleigh-Taylor-type instability at the disk-magnetosphere interface, and compare it with the variability during stable accretion, with the goal of looking for possible quasi-periodic oscillations. The lightcurves during stable accretion show periodicity at the star's frequency and sometimes twice that, due to the presence of two funnel streams that produce antipodal hotspots near the magnetic poles. On the other hand, lightcurves during unstable accretion through tongues penetrating the magnetosphere are more chaotic due to the stochastic behaviour of the tongues, and produce noisier power spectra. However, the power spectra do show some signs of quasi-periodic variability. Most importantly, the rotation frequency of the tongues and the resulting hotspots is close to the inner-disk orbital frequency, except in the most strongly unstable cases. There is therefore a high probability of observing QPOs at that frequency in longer simulations. In addition, the lightcurves in the unstable regime show periodicity at the star's rotation frequency in many of the cases investigated here, again except in the most strongly unstable cases which lack funnel flows and the resulting antipodal hotspots. The noisier power spectra result in the fractional rms amplitudes of the Fourier peaks being smaller. We also study in detail the effect of the misalignment angle between the rotation and magnetic axes of the star on the variability, and find that at misalignment angles $\gtrsim 25^\circ$, the star's period always appears in the lightcurves.

We report on the numerical discovery of quasi-periodic oscillations (QPOs) associated with accretion through a non-axisymmetric magnetic boundary layer in the unstable regime, when two ordered equatorial streams form and rotate synchronously at approximately the angular velocity of the inner disk The streams hit the star's surface producing hot spots. Rotation of the spots leads to high-frequency QPOs. We performed a number of simulation runs for different magnetospheric sizes from small to tiny, and observed a definite correlation between the inner disk radius and the QPO frequency: the frequency is higher when the magnetosphere is smaller. In the stable regime a small magnetosphere forms and accretion through the usual funnel streams is observed, and the frequency of the star is expected to dominate the lightcurve. We performed exploratory investigations of the case in which the magnetosphere becomes negligibly small and the disk interacts with the star through an equatorial belt. We also performed investigation of somewhat larger magnetospheres where one or two ordered tongues may dominate over other chaotic tongues. In application to millisecond pulsars we obtain QPO frequencies in the range of 350 Hz to 990 Hz for one spot. The frequency associated with rotation of one spot may dominate if spots are not identical or antipodal. If the spots are similar and antipodal then the frequencies are twice as high. We show that variation of the accretion rate leads to drift of the QPO peak.

We present results of global 3D MHD simulations of disk accretion to a rotating star with dipole and more complex magnetic fields using a Godunov-type code based on the "cubed sphere" grid developed earlier in our group. We describe the code and the grid and show examples of simulation results.

The appearance and time variability of accreting millisecond X-ray pulsars (hereafter AMXPs, e.g. Wijnands & van der Klis 1998) depends strongly on the accretion rate, the effective viscosity and the effective magnetic diffusivity of the disk-magnetosphere boundary. The accretion rate is the main parameter which determines the location of the magnetospheric radius of the star for a given stellar magnetic field. We introduce a classification of accreting neutron stars as a function of the accretion rate and show the corresponding stages obtained from our global 3D magnetohydrodynamic (MHD) simulations and from our axisymmetric MHD simulations. We discuss the expected variability features in each stage of accretion, both periodic and quasi-periodic (QPOs). We conclude that the periodicity may be suppressed at both very high and very low accretion rates. In addition the periodicity may disappear when ordered funnel flow accretion is replaced by disordered accretion through the interchange instability.

We present results of 3D simulations of MHD instabilities at the accretion disk-magnetosphere boundary. The instability is Rayleigh-Taylor, and develops for a fairly broad range of accretion rates and stellar rotation rates and magnetic fields. It produces tall, thin tongues of plasma that penetrate the magnetosphere in the equatorial plane. The shape and number of the tongues changes with time on the inner-disk dynamical timescale. In contrast with funnel flows, which deposit matter mainly in the polar region, the tongues deposit matter much closer to the stellar equator. The instability appears for relatively small misalignment angles, $\Theta\lesssim30^\circ$, between the star's rotation and magnetic axes, and is associated with higher accretion rates. The hot spots and light curves during accretion through instability are generally much more chaotic than during stable accretion. The unstable state of accretion has possible implications for quasi-periodic oscillations and intermittent pulsations from accreting systems.

We discuss a number of topics relevant to disk-magnetosphere interaction and how numerical simulations illuminate them. The topics include: (1) disk-magnetosphere interaction and the problem of disk-locking; (2) the wind problem; (3) structure of the magnetospheric flow, hot spots at the star's surface, and the inner disk region; (4) modeling of spectra from 3D funnel streams; (5) accretion to a star with a complex magnetic field; (6) accretion through 3D instabilities; (7) magnetospheric gap and survival of protoplanets. Results of both 2D and 3D simulations are discussed.

We present results of 3D simulations of MHD instabilities at the accretion disk-magnetosphere boundary. The instability is Rayleigh-Taylor, and develops for a fairly broad range of accretion rates and stellar rotation rates and magnetic fields. It manifests itself in the form of tall, thin tongues of plasma that penetrate the magnetosphere in the equatorial plane. The shape and number of the tongues changes with time on the inner-disk dynamical timescale. In contrast with funnel flows, which deposit matter mainly in the polar region, the tongues deposit matter much closer to the stellar equator. The instability appears for relatively small misalignment angles, $\Theta\lesssim30^\circ$, between the star's rotation and magnetic axes, and is associated with higher accretion rates. The hot spots and light curves during accretion through instability are generally much more chaotic than during stable accretion. The unstable state of accretion has possible implications for quasi-periodic oscillations and intermittent pulsations from accreting systems, as well as planet migration.

We report on the first global three-dimensional (3D) MHD simulations of disk accretion onto a rotating magnetized star through the Rayleigh-Taylor instability. The star has a dipole field misaligned relative to the rotation axis by a small angle Theta. Simulations show that, depending on the accretion rate, a star may be in the stable or unstable regime of accretion. In the unstable regime, matter penetrates deep into the magnetosphere through several elongated "tongues" which deposit matter at random places on the surface of the star, leading to stochastic light-curves. In the stable regime, matter accretes in ordered funnel streams and the light-curves are almost periodic. A star may switch between these two regimes depending on the accretion rate and may thus show alternate episodes of ordered pulsations and stochastic light-curves. In the intermediate regime, both stochastic and ordered pulsations are observed. For Theta > 30 degrees, the instability is suppressed and stable accretion through funnel streams dominates.

Thermonuclear burning on the surface of a neutron star causes the expansion of a thin outer layer of the star, $\Delta R(t)$. The layer rotates slower than the star due to angular momentum conservation. The shear between the star and the layer acts to twist the star's dipole magnetic field giving at first a trailing spiral field. The twist of the field acts in turn to `torque up' the layer increasing its specific angular momentum. As the layer cools and contracts, its excess specific angular momentum causes it to {\it rotate faster} than the star which gives a leading spiral magnetic field. The process repeats, giving rise to torsional oscillations. We derive equations for the angular velocity and magnetic field of the layer taking into account the diffusivity and viscosity which are probably due to turbulence. The magnetic field causes a nonuniformity of the star's photosphere (at the top of the heated layer), and this gives rise to the observed X-ray oscillations. The fact that the layer periodically rotates faster than the star means that the X-ray oscillation frequency may ``overshoot'' the star's rotation frequency. Comparison of the theory is made with observations of Chakrabarty et al. (2003) of an X-ray burst of SAX J1808.4-3658.

We performed 2D and full 3D magnetohydrodynamic simulations of disk accretion to a rotating star with an aligned or misaligned dipole magnetic field. We investigated the rotational equilibrium state and derived from simulations the ratio between two main frequencies: the spin frequency of the star and the orbital frequency at the inner radius of the disk. In 3D simulations we observed different features related to the non-axisymmetry of the magnetospheric flow. These features may be responsible for high-frequency quasi-periodic oscillations (QPOs). Variability at much lower frequencies may be connected with restructuring of the magnetic flux threading the inner regions of the disk. Such variability is specifically strong at the propeller stage of evolution.

We model the variability profiles of millisecond period X-ray pulsars. We performed three-dimensional magnetohydrodynamic simulations of disk accretion to millisecond period neutron stars with a misaligned magnetic dipole moment, using the pseudo-Newtonian Paczynski-Wiita potential to model general relativistic effects. We found that the shapes of the resulting funnel streams of accreting matter and the hot spots on the surface of the star are quite similar to those for more slowly rotating stars obtained from earlier simulations using the Newtonian potential. The funnel streams and hot spots rotate approximately with the same angular velocity as the star. The spots are bow-shaped (bar-shaped) for small (large) misalignment angles. We found that the matter falling on the star has a higher Mach number when we use the Paczynski-Wiita potential than in the Newtonian case. Having obtained the surface distribution of the emitted flux, we calculated the variability curves of the star, taking into account general relativistic, Doppler and light-travel-time effects. We found that general relativistic effects decrease the pulse fraction (flatten the light curve), while Doppler and light-travel-time effects increase it and distort the light curve. We also found that the light curves from our hot spots are reproduced reasonably well by spots with a gaussian flux distribution centered at the magnetic poles. We also calculated the observed image of the star in a few cases, and saw that for certain orientations, both the antipodal hot spots are simultaneously visible, as noted by earlier authors.