@@ -173,14 +173,32 @@ only dependent on the aperture size. See `Tools of Radio Astronomy
173173<http://books.google.com/books?id=9KHw6R8rQEMC&pg=PA179&source=gbs_toc_r&cad=4#v=onepage&q&f=false> `__
174174for details.
175175
176- The `~astropy.units.equivalencies.brightness_temperature ` equivalency
177- requires the beam area and frequency as arguments. Example::
176+ The `~astropy.units.equivalencies.brightness_temperature ` equivalency requires
177+ the beam area and frequency as arguments. Recalling that the area of a 2D
178+ gaussian is :math: `2 \pi \sigma ^2 ` (see `wikipedia
179+ <http://en.wikipedia.org/wiki/Gaussian_function#Two-dimensional_Gaussian_function> `_),
180+ here is an example::
178181
179182 >>> import numpy as np
180- >>> omega_B = np.pi * (50 * u.arcsec)**2
183+ >>> beam_sigma = 50*u.arcsec
184+ >>> omega_B = 2 * np.pi * beam_sigma**2
181185 >>> freq = 5 * u.GHz
182186 >>> u.Jy.to(u.K, equivalencies=u.brightness_temperature(omega_B, freq))
183- 7.052588858...
187+ 3.526294...
188+
189+ If you have beam full-width half-maxima (FWHM), which are often quoted and are
190+ the values stored in the FITS header keywords BMAJ and BMIN, a more appropriate
191+ example converts the FWHM to sigma::
192+
193+ >>> import numpy as np
194+ >>> beam_fwhm = 50*u.arcsec
195+ >>> fwhm_to_sigma = 1./(8*np.log(2))**0.5
196+ >>> beam_sigma = beam_fwhm*fwhm_to_sigma
197+ >>> omega_B = 2 * np.pi * beam_sigma**2
198+ >>> freq = 5 * u.GHz
199+ >>> u.Jy.to(u.K, equivalencies=u.brightness_temperature(omega_B, freq))
200+ 19.55392833...
201+
184202
185203Temperature Energy Equivalency
186204^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
0 commit comments