calculate_xray_luminosity

sunpy.instr.goes.calculate_xray_luminosity(goeslc)[source] [edit on github]

Calculates GOES solar X-ray luminosity.

This function calculates the solar X-ray luminosity in the GOES wavelength ranges (1-8 angstroms and 0.5-4 angstroms) based on the observed GOES fluxes. The units of the results are W. The calculation is made by simply assuming that the radiation is emitted isotropically, i.e. is distributed over a spherical surface area with a radius equal to the Sun-Earth distance. Once the luminosity in each GOES passband is found, they are returned in a new LightCurve object also containing the metadata and data of the input LightCurve object.

Parameters:goeslc (LightCurve) – LightCurve object containing GOES flux data which MUST be in units of W/m^2.
Returns:lc_new (LightCurve) – Contains same metadata and data as input LightCurve with the following additional data columns;
goeslc_new.data.luminosity_xrsa - Xray luminosity in 0.5-4A channel unit=[W]
goeslc_new.data.luminosity_xrsb - Xray luminosity in 1-8A channel unit=[W]

Examples

>>> from sunpy.instr.goes import calculate_xray_luminosity
>>> import sunpy.lightcurve as lc
>>> time1 = "2014-01-01 00:00:00"
>>> time2 = "2014-01-01 00:00:08"
>>> goeslc = lc.GOESLightCurve.create(time1, time2)  
>>> goeslc.data  
                                    xrsa      xrsb
2014-01-01 00:00:00.421999  9.187300e-08  0.000004
2014-01-01 00:00:02.468999  9.187300e-08  0.000004
2014-01-01 00:00:04.518999  9.187300e-08  0.000004
2014-01-01 00:00:06.564999  9.298800e-08  0.000004
>>> goeslc_new = calculate_xray_luminosity(goeslc)  
>>> goeslc_new.data   
                                    xrsa      xrsb  luminosity_xrsa  \
2014-01-01 00:00:00.421999  9.187300e-08  0.000004     2.498454e+16
2014-01-01 00:00:02.468999  9.187300e-08  0.000004     2.498454e+16
2014-01-01 00:00:04.518999  9.187300e-08  0.000004     2.498454e+16
2014-01-01 00:00:06.564999  9.298800e-08  0.000004     2.528776e+16

                            luminosity_xrsb
2014-01-01 00:00:00.421999     9.544507e+17
2014-01-01 00:00:02.468999     9.544507e+17
2014-01-01 00:00:04.518999     9.530365e+17
2014-01-01 00:00:06.564999     9.530365e+17