Full list of tools Importing data Plotting data


RPI script collection

To aid analysis of data extracted from the RPI BinBrowser (available at UMass Lowell), a family of Matlab scripts were developed. We ensure compatability with BinBrowser version 2.2, though higher versions will also likely work. The entire collection of Matlab scripts developed for analyzing RPI data can be downloaded here:

Download tools

Tutorials for the scripts can be found below. If you still have questions after viewing the documentation, feel free to contact us for technical questions (contact info).

.............................................................................................

Importing data from RPI into Matlab View tutorial

rpiDataReader
Multi-format data reader. Processes plasmagram images, bin files, spin files, and global parameters.

rpiBinReader
Reads in bin data file, which is the numerical equivalent of the corresponding plasmagram. Amplitudes on all three antenna are available.

rpiSpinReader
Reads in spin data file, which contains the spacecraft spin information. In particular, the antenna orientation may be useful in analyzing signal amplitudes.

rpiPngReader
Reads in a set of plasmagram images. If each image filename contains the default timestamp provided by BinBrowser, then the times of the records are also parsed.

rpiCoordinateTransform
Calculates coordinates of IMAGE and antennae in various coordinate systems.

rpiHistRead
Reads in a set of data files for PGH events in general and creates a histogram structure for plotting.

rpiHistSupplement
Should be used in conjunction with rpiHistRead to fill in missing information not extracted by script automation.

rpiResRead
Reads in a set of data files specialized for resonances. Histogram structure is similar to that produced by rpiHistRead.

rpiExtractNe
Calculates the electron density from a dynamic spectrogram. This is more accurate than using the model fpe values in BinBrowser.

rpiImportNe
Reads in a set of electron density MAT files, which are produced by processing dynamic spectrograms taken from BinBrowser through rpiExtractNe.

.............................................................................................

Plotting RPI data in Matlab View tutorial

rpi3DPlot
Converts a plasmagram into a 3D plot, where amplitude is the vertical variable.

rpi3DMovie
Converts a set of plasmagrams into an AVI animation.

rpiPlotEarthFigure
Creates a meridian cross-section view of where events occur in space given the L-shell and magnetic latitude values.

rpiHistPlot
Generates a set of histograms for different physical parameters. Histogram structure should be created by rpiHistRead.

rpiResPlot
Generates a set of histograms for resonances. Histogram structure should be created by rpiResRead.

rpiResContrastPlot
Generates two sets of histograms for side-by-side analysis of two sets of resonance (or non-resonance) data.

rpiSpinVsFreq
Plots spacecraft spin info (e.g. antenna orientation) against the sounding frequency, for a set of plasmagrams.

rpiPlasmagramPlot
Creates plasmagram plots on which special markers can be placed.

.............................................................................................

Miscellaneous scripts

rpiFreqConvert
Converts electron gyrofrequency and plasma frequency values into X cutoff, Z cutoff, and upper hybrid frequency values.