SuperDARN · carleyjmartin · Mar 14, 2023 · Mar 14, 2023 · Apr 26, 2023 · Oct 6, 2023
diff --git a/.zenodo.json b/.zenodo.json
@@ -3,11 +3,6 @@
         {
             "name": "SuperDARN Data Visualization Working Group"
         },
-        {
-            "affiliation": "University of Saskatchewan",
-            "name": "Rohel, R.A.",
-            "orcid": "0000-0003-2208-1553"
-        },
         {
             "affiliation": "University of Saskatchewan",
             "name": "Martin, C.J.",
@@ -18,6 +13,24 @@
             "name": "Billett, D.D.",
             "orcid": "0000-0002-8905-8609"
         },
+        {
+            "affiliation": "Virginia Tech",
+            "name": "Wanner, T.D.",
+            "orcid":"0009-0007-0616-5796"
+        },
+        {
+            "affiliation": "University of Saskatchewan",
+            "name": "Kucharyshen, K."
+        },
+        {
+            "affiliation": "University of Saskatchewan",
+            "name": "Sylvestre, R."
+        },
+        {
+            "affiliation": "University of Saskatchewan",
+            "name": "Rohel, R.A.",
+            "orcid": "0000-0003-2208-1553"
+        },
         {
             "affiliation": "Virginia Tech",
             "name": "Sterne, K.T.",

diff --git a/README.md b/README.md
@@ -9,12 +9,13 @@ Python data visualization library for the Super Dual Auroral Radar Network (Supe
 
 ## Changelog
 
-## Version 4.2 - Major Release!
+## Version 4.3 - Minor Release!
 
-This major release includes:
-- Updates to pyDARNio interface: faster reading of files
-- `nightshade` added to range-time plot options
-- ENUM use for retrieving radar information
+This minor release includes:
+- Updated SciPy restriction and changes associated
+- NEW: True velocity in map plots
+- NEW: FITACF data detrending algorithm
+- Bug Fix: Updating HDW files on Windows fixed
 
 ## Documentation
 
@@ -51,7 +52,7 @@ plt.show()
 
 For more information and tutorials on pyDARN please see the [tutorial section](https://pydarn.readthedocs.io/en/main/).
 
-We also have a [Jupyter notebook](https://zenodo.org/record/7005203) with many examples to support our recent [publication](https://doi.org/10.3389/fspas.2022.1022690).
+We also have a [Jupyter notebook](https://zenodo.org/record/7005203) with many examples to support our [publication](https://doi.org/10.3389/fspas.2022.1022690). This notebook may be out of date.
 
 ## Getting involved
 

diff --git a/docs/imgs/detrend.png b/docs/imgs/detrend.png
diff --git a/docs/user/axis.md b/docs/user/axis.md
@@ -83,7 +83,7 @@ plt.show()
 | coastline_linewidth=(float)    | Uses Cartopy to set line width of the coastlines                                     |
 | grid_lines=(bool)              | Uses Cartopy to plot grid lines                                                      |
 | nightshade=(int)               | Uses the value given to calculate and show where on the plot the Earth is in shadow  |
-| plot_center=[float,float]      | Longitude and latitude of the desired center of the plot (e.g. [-90, 60])            |
+| plot_center=[float,float]      | MLT(MAG)/Longitude(GEO) and latitude of the desired center of the plot (e.g. [6, 60])            |
 | plot_extent=[float,float]      | Plotting extent in terms of percentage of the earth (e.g. [80,50])                   |
 
 This choice will return an `ax` object and a Cartopy `ccrs` object (coordinate reference system).

diff --git a/docs/user/coordinates.md b/docs/user/coordinates.md
@@ -140,4 +140,4 @@ plt.show()
 ```
 
 !!! Note
-        Nightshade is now available in range-time plots. See [range-time plots](user/range_time.md).
+    Nightshade is now available in range-time plots. See [range-time plots](user/range_time.md).
diff --git a/docs/user/fan.md b/docs/user/fan.md
@@ -134,6 +134,7 @@ Here is a list of all the current options than can be used with `plot_fan`
 | colorbar_label=(string)       | Label that appears next to the color bar, requires colorbar to be True                                  |
 | coastline=(bool)              | Plots outlines of coastlines below data (Uses Cartopy)                                                  |
 | beam=(int)                    | Only plots data/outline of specified beam (default: None)                                               |
+| plot_tight=(bool)*            | Centers the radars FOV in the plot and calculates extents based on FOV (default: False)                 |
 | kwargs **                     | Axis Polar settings. See [polar axis](axis.md)                                                          |
 
 
@@ -142,6 +143,9 @@ Here is a list of all the current options than can be used with `plot_fan`
     In other cases, the user may want to specify the channel and use an integer (N) for the `scan_index`. Be aware that this will show the
     data for the Nth scan of only the chosen channel, not that of the entire file. 
 
+!!! Note
+    * plot_tight option only works with MAG and GEO projections, plot_tight will overwrite plot_center and plot_extent options from axis setup 
+
 !!! Warning
     Not all data is designed to be plotted on a fan plot. Some CPID's, such as camping beam/themisscan, do not plot well due to overlapping beams in a single scan. It is up to the user to interpret the suitability of the plotting method used.
 

diff --git a/docs/user/filters.md b/docs/user/filters.md
@@ -12,13 +12,9 @@ and conditions of version 3 of the GNU General Public License, supplemented by
 the additional permissions listed below.
 -->
 
-# Filtering Data
+# Filtering and Detrending Data
 ---
 
-
-
-Currently pyDARN has one filtering option. 
-
 ## Boxcar Filtering
 
 !!! Note
@@ -81,4 +77,19 @@ plt.show()
 ```
 
 ![](../imgs/unfiltered.png)
-![](../imgs/filtered.png)
+![](../imgs/filtered.png)
+
+## Data Detrending
+
+FITACF level data can be detrended to view background periodic fluctuations in data. 
+You can choose between using a mean value of the window length ('mean'), or using the Sovitsky-Golay filter ('sov-gal').
+
+```python
+import pydarn
+
+data, _ = pydarn.read_fitacf('superdarn.data.file.fitacf')
+
+dmap_detrended = pydarn.Detrend.detrend_fitacf(data, parameter='both', window_length=600, detrend_type='mean')
+```
+
+![](../imgs/detrend.png)
diff --git a/docs/user/fov.md b/docs/user/fov.md
@@ -60,8 +60,13 @@ Here is a list of all the current options than can be used with `plot_fov`
 | radar_label=(bool)      | Places the radar 3-letter abbreviation next to the radar location                                       |
 | coastline=(bool)        | Plots outlines of coastlines below FOV (Uses Cartopy)                                                   |
 | beam=(int)              | Only plots outline/fill of specified beam (default: None)                                               |
+| plot_tight=(bool)*      | Centers the radars FOV in the plot and calculates extents based on FOV (default: False)                 |
 | kwargs **               | Axis Polar settings. See [polar axis](axis.md)                                                          |
 
+!!! Note
+    * plot_tight option only works with MAG and GEO projections, plot_tight will overwrite plot_center and plot_extent options from axis setup 
+
+
 
 ### Examples
 

diff --git a/docs/user/install.md b/docs/user/install.md
@@ -35,6 +35,9 @@ pip3 install --upgrade pydarn
 
 Installing in virtual environments is recommended, see below for details.
 
+!!! Note
+    Many funding agencies count acknowledgements and citations when assessing projects. Please remember to [acknowledge](/citing.md) the SuperDARN data, and tools you are using so we can keep producing high quality data and tools to use it!
+
 ## Prerequisites
 
 pyDARN requires **python 3.8** or later, see list below for library dependencies.
@@ -59,7 +62,7 @@ You can check your python version using
 On installation, pyDARN will download the following dependencies: 
 
 - [NumPy](https://numpy.org/)
-- [scipy <1.15.0](https://scipy.org/)
+- [scipy 1.17.0+](https://scipy.org/)
 - [matplotlib 3.7.0+](https://matplotlib.org/) 
 - [PyYAML](https://pyyaml.org/wiki/PyYAMLDocumentation)
 - [pyDARNio 2.0.0+](https://pydarnio.readthedocs.io/en/latest/user/install/)

diff --git a/docs/user/io.md b/docs/user/io.md
@@ -18,7 +18,7 @@ the additional permissions listed below.
 # Reading in DMap structured SuperDARN data files
 ---
 
-Data Map (DMap) is a binary self-describing format that was developed by Rob Barnes. 
+Data Map (DMap) is a binary self-describing format that was developed by the SuperDARN community. 
 This format is currently the primary format used by SuperDARN. 
 For more information on DMap please see [RST Documentation](https://radar-software-toolkit-rst.readthedocs.io/en/latest/).
 Types of files used by SuperDARN which are usually accessed in DMap format are:

diff --git a/docs/user/map.md b/docs/user/map.md
@@ -24,6 +24,7 @@ Map field descriptions can be found [here](https://radar-software-toolkit-rst.re
 | ------------------ | ----------------------------- | ----------------------------- |
 | Fitted Velocity    | `MapParams.FITTED_VELOCITIES` | see Fitted Velocities section |
 | Modeled Velocities | `MapParams.MODEL_VELOCITIES`  | `model.vel.median`            |
+| True Velocities    | `MapParams.TRUE_VELOCITIES`   | see True Velocities section   |
 | Raw Velocities     | `MapParams.RAW_VELOCITIES`    | `vector.vel.median`           |
 | Power              | `MapParams.POWER`             | `vector.pwr.median`           |
 | Spectral Width     | `MapParams.SPECTRAL_WIDTH`    | `vector.wdt.median`           |
@@ -38,6 +39,11 @@ Fitted velocities are velocity vectors which represent the fitted convection pat
 
 Fitted velocity vectors are by default only calculated at the same positions of the line-of-sight vectors, but fit vectors at an arbitrary position can be obtained by using the `calculated_fitted_velocities` function in `map.py`.
 
+### True Velocities
+
+True velocity is a name given to a value of velocity derived from the fitted and raw velocities. Note that is not the 'absolute true' velocity that is occuring in the ionosphere, it is just a different representation of the velocities. 
+The True velocity is given by combining the average line-of-sight velocity measured at each grid cell with the component of the fitted velocity which is perpendicular to the line-of-sight direction. More information can be read in [Chisham et al.2002](https://agupubs.onlinelibrary.wiley.com/doi/10.1029/2001JA009124).
+
 ## Basic usage
 
 pyDARN and pyplot need to be imported and the desired MAP file needs to be [read in](https://pydarn.readthedocs.io/en/main/user/io/):

diff --git a/docs/user/superdarn_data.md b/docs/user/superdarn_data.md
@@ -24,7 +24,7 @@ The [Data Distribution Working Group (DDWG)](https://github.com/SuperDARN/DDWG)
 ## Data Mirrors
 To get access to rawacf, fitacf and sometimes higher lever data, there are three possible data servers: one utilizes *Globus*, others use `rsync`, `sftp` and `scp`:
 
-  - [SuperDARN Canada](https://superdarn.ca/): uses [Globus](https://github.com/SuperDARNCanada/globus) to allow access to the SuperDARN data. Contact [[email protected]](mailto:[email protected]) for access.
+  - [SuperDARN Canada](https://superdarn.ca/data-access): uses [Globus](https://github.com/SuperDARNCanada/globus) to allow access to the SuperDARN data. Contact [[email protected]](mailto:[email protected]) for access or fill in the online form at the link above.
   - [BAS](https://www.bas.ac.uk/project/superdarn/#about): information on data access can be found [here](https://www.bas.ac.uk/project/superdarn/#data)
   - [NSSC](https://www.nssdc.ac.cn/nssdc_en/html/task/sdarn.html): please contact NSSC for access.
 

diff --git a/pydarn/__init__.py b/pydarn/__init__.py
@@ -55,6 +55,7 @@
 from .utils.terminator import terminator
 from .utils.recalculate_elevation import recalculate_elevation
 from .utils.filters import Boxcar
+from .utils.detrend import Detrend
 
 # import plotting
 from .plotting.color_maps import PyDARNColormaps

diff --git a/pydarn/exceptions/plot_exceptions.py b/pydarn/exceptions/plot_exceptions.py
@@ -16,6 +16,14 @@
 # supplemented by the additional permissions listed below.
 import datetime
 
+class GeneralError(Exception):
+    '''
+    Error for general messages
+    '''
+    def __init__(self, message):
+        self.message = message
+        super().__init__(self.message)
+
 
 class PartialRecordsError(Exception):
     """