RTP terminator

[RemingtonRohel]

Scope

Addition of terminator plotting (shading the nightside cells) on RTP plots.

issue: closes #321

Approval

Number of approvals: 1

Test

matplotlib version: 3.9.15

Try out different options for RTP.plot_range_time(), RTP.plot_coord_time() functions with terminator=True.

E.g.

import dmap
from pydarn import RTP, RangeEstimation, Coords
import matplotlib.pyplot as plt


if __name__ == '__main__':
    data = dmap.read_fitacf('fitacf/20211102.0000.00.rkn.a.fitacf')

    fig, axes = plt.subplots(1, 3, figsize=(10,6))
    RTP.plot_range_time(data, ax=axes[0], beam_num=3, range_estimation=RangeEstimation.RANGE_GATE, terminator=True, groundscatter=True, colorbar=False)
    RTP.plot_range_time(data, ax=axes[1], beam_num=3, range_estimation=RangeEstimation.SLANT_RANGE, terminator=True, groundscatter=True, colorbar=False)
    RTP.plot_range_time(data, ax=axes[2], beam_num=3, range_estimation=RangeEstimation.GSMR, terminator=True, groundscatter=True)
    axes[0].set_ylabel("Range Gate")
    axes[1].set_ylabel("Slant Range")
    axes[2].set_ylabel("GSMR")
    plt.show()
    plt.close()

    fig, axes = plt.subplots(2, 2, figsize=(10, 10))
    RTP.plot_coord_time(data, ax=axes[0, 0], beam_num=3, range_estimation=RangeEstimation.GSMR, coords=Coords.GEOGRAPHIC, terminator=True, latlon='lat')
    RTP.plot_coord_time(data, ax=axes[0, 1], beam_num=3, range_estimation=RangeEstimation.SLANT_RANGE, coords=Coords.GEOGRAPHIC, terminator=True, latlon='lat')
    RTP.plot_coord_time(data, ax=axes[1, 0], beam_num=3, range_estimation=RangeEstimation.GSMR, coords=Coords.AACGM, terminator=True, latlon='lon')
    RTP.plot_coord_time(data, ax=axes[1, 1], beam_num=3, range_estimation=RangeEstimation.SLANT_RANGE, coords=Coords.AACGM, terminator=True, latlon='lon')
    plt.show()
    plt.close()