calculate_xray_luminosity

sunpy.instr.goes.calculate_xray_luminosity(goests)[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

goests (XRSTimeSeries) – LightCurve object containing GOES flux data which MUST be in units of W/m^2.

Returns

ts_new (XRSTimeSeries) – Contains same metadata and data as input LightCurve with the following additional data columns;

goests_new.data.luminosity_xrsa - Xray luminosity in 0.5-4A channel unit=[W]
goests_new.data.luminosity_xrsb - Xray luminosity in 1-8A channel unit=[W]

Examples

>>> import sunpy.timeseries as ts
>>> from sunpy.instr.goes import calculate_xray_luminosity
>>> from sunpy.data.sample import GOES_XRS_TIMESERIES  
>>> goests = ts.TimeSeries(GOES_XRS_TIMESERIES)  
>>> goests.data[0:10]  
                                       xrsa          xrsb
2011-06-06 23:59:59.961999893  1.000000e-09  1.887100e-07
2011-06-07 00:00:02.008999944  1.000000e-09  1.834600e-07
2011-06-07 00:00:04.058999896  1.000000e-09  1.860900e-07
2011-06-07 00:00:06.104999900  1.000000e-09  1.808400e-07
2011-06-07 00:00:08.151999950  1.000000e-09  1.860900e-07
2011-06-07 00:00:10.201999903  1.000000e-09  1.808400e-07
2011-06-07 00:00:12.248999953  1.000000e-09  1.860900e-07
2011-06-07 00:00:14.298999906  1.000000e-09  1.834600e-07
2011-06-07 00:00:16.344999909  1.000000e-09  1.808400e-07
2011-06-07 00:00:18.391999960  1.000000e-09  1.834600e-07
>>> goests_new = calculate_xray_luminosity(goests)  
>>> goests_new.data[0:10]   
                                       xrsa          xrsb  luminosity_xrsa  luminosity_xrsb
2011-06-06 23:59:59.961999893  1.000000e-09  1.887100e-07     2.896209e+14     5.465435e+16
2011-06-07 00:00:02.008999944  1.000000e-09  1.834600e-07     2.896209e+14     5.313384e+16
2011-06-07 00:00:04.058999896  1.000000e-09  1.860900e-07     2.896209e+14     5.389555e+16
2011-06-07 00:00:06.104999900  1.000000e-09  1.808400e-07     2.896209e+14     5.237503e+16
2011-06-07 00:00:08.151999950  1.000000e-09  1.860900e-07     2.896209e+14     5.389555e+16
2011-06-07 00:00:10.201999903  1.000000e-09  1.808400e-07     2.896209e+14     5.237503e+16
2011-06-07 00:00:12.248999953  1.000000e-09  1.860900e-07     2.896209e+14     5.389555e+16
2011-06-07 00:00:14.298999906  1.000000e-09  1.834600e-07     2.896209e+14     5.313384e+16
2011-06-07 00:00:16.344999909  1.000000e-09  1.808400e-07     2.896209e+14     5.237503e+16
2011-06-07 00:00:18.391999960  1.000000e-09  1.834600e-07     2.896209e+14     5.313384e+16