New Feature: IQ Data Plots

[carleyjmartin]

Scope

This PR has a new plotting module for IQ data. There are four types of plots, time-series, single sequence, single record and an overview plot for the IQ data.

Does include documentation changes, but we can test that works when we build the docs before a release.

Anyway, I wasn't really sure what people wanted when they asked to just plot IQ data so if you had different ideas of what was important let me know and we can add it.

Note: chnnum in the data is NOT related to frequency channels used. chnnum is the number of different channels in the IQ data: that means main array and interferometer array (chnnum=2) NOT the frequency channels.

issue: to close #320

Approval

Number of approvals: 2 at least, lots of things

Test

matplotlib version: 3.7.1
Note testers: please indicate what version of matplotlib you are using

If you would like this IQ data please let me know, but I would like if people can test with different data as this file was a bit weird. It only had beams 6-15 and only for 15 minutes. If you have iq data from a radar with different channels being used, please test!

You can plot main array data when interferometer=False, and interferometer data when =True

import pydarn
import matplotlib.pyplot as plt
from datetime import datetime


iq_file = '/Users/carley/Desktop/20160113.1601.00.cly.iqdat'
iq_data = pydarn.SuperDARNRead(iq_file).read_iqdat()

# Use me to test what scalar fields I can plot in time series
print(iq_data[0].keys())

# Plot time series data
pydarn.IQ.plot_time_series(iq_data, beam_num = 7, parameter='tfreq')
plt.show()

# Plot single sequence of IQ data
pydarn.IQ.plot_iq_sequence(iq_data, start_time=datetime(2016,1,13,16,15),
                           beam_num=15, sequence_num = 20,
                           interferometer=False, plot_phase=True)
plt.show()

# Plot IQ data record
pydarn.IQ.plot_iq_record(iq_data, start_time=datetime(2016,1,13,16,0),
                           beam_num=15, interferometer=False)
plt.show()

# Plot IQ data over whole file
pydarn.IQ.plot_iq_overview(iq_data, beam_num='all', interferometer=False)
plt.show()

Should produce:

[RemingtonRohel]

Overall I like this a lot! There are some minor things in the code that I think would be good to change, but otherwise I was able to plot some iqdat data very easily.