sample_photons
==============

.. py:method:: luminet.black_hole.BlackHole.sample_photons(n_points=1000) -> Tuple[luminet.photon.Photon]

   Sample points on the accretion disk.

   Photons are appended as class-level attributes.
   Each photon is a :class:`luminet.photon.Photon` with the following properties:

   - ``radius``: radius of the photon on the accretion disk :math:`r`
   - ``alpha``: angle of the photon on the accretion disk :math:`\alpha`
   - ``impact_parameter``: impact parameter of the photon :math:`b`
   - ``z_factor``: redshift factor of the photon :math:`1+z`
   - ``flux_o``: observed flux of the photon :math:`F_o`

   :Parameters: **n_points** (*int*) -- Amount of photons to sample.

   .. attention::

      Sampling is not done uniformly, but biased towards the
      center of the accretion disk, as this is where most of the luminosity comes from.

   :returns: Tuple[:class:`~luminet.photon.Photon`] --     Dataframes containing photons for both direct and ghost image.