- heliopy.data.util.pitchdist_cdf2df(cdf, distkeys, energykey, timekey, anglelabels)¶
Converts cdf file of a pitch angle distribution to a pandas dataframe.
MultiIndexing is used as a pitch angle distribution is essentially a 3D dataset f(time, energy, angle). See http://pandas.pydata.org/pandas-docs/stable/advanced.html#multiindex-advanced-indexing for more information.
This has been constructed for importing wind swe pitch angle distributions, and might not generalise very well to other data sets.
Assumes that each energy in the cdf has its own 2D array (time, angle). In the below description of the function there are
ntime data points
menergy data points
langlular data points
cdf (cdflib.CDF) – Opened cdf file.
distkeys (list) – A list of the cdf keys for a given energies. Each array accessed by distkeys is shape
(n, l), and there must be
energykey (str) – The cdf key for the energy values. The array accessed by energykey must have shape
acan be anything. If it has shape
(a, m), we assume energies measured don’t change, and take the first row as the energies for all times.
timekey (str) – The cdf key for the timestamps. The array access by timekey must have shape
anglelabels (list) – A list of the labels to give each anglular bin (eg. [0, 10, 20] in degrees). Must be of length
df – Data frame with read in data.
- Return type