# Friday Harbor ## sc02 [Warning](warning.md) **Use Case Updated June 4, 2023 to use gnssir_input. Your outputs will be slightly different than those shown here.**
rinex2snr sc02 2021 15
Use our utility quickLook with defaults [(For more details on quickLook output)](../pages/quickLook.md):
quickLook sc02 2021 15
These results for reflector height in the top panel are pretty bad (gray means the retrieval does not pass QC). Why?
The reflector height defaults are restricted to 0.5-6 meters, which includes part of
the tidal range, but not all of it. Furthermore, the default elevation angles of 5 to 25 degrees are
not acceptable here, as these elevation angles include rocks and soil in addition to the water.
Now let's make better choices. Following the suggestions of *Larson, Ray, and Williams* (2017), use
elevation angle restrictions of 5 to 13 degrees and reflector height restrictions of 3 to 12 meters. And let's
use a modern GPS signal, L2C.
quickLook sc02 2021 15 -e1 5 -e2 13 -h1 3 -h2 12 -fr 20
Now instead of vast numbers of unsuccessful reflector height retrivals, you can begin to
see where the acceptable azimuths will be, ~50 to 230 degrees. A peak to noise ratio
of 3 works pretty well. The Lomb Scargle periodograms show the
retrievals in periodogram space. You can see here that the northwest
is a dead zone for water reflections, and that was expected.
We can also check the retrievals stats for L1 to make sure these look good too.
### Measure Tides with GNSS-IR
We will not attempt to analyze a long time series, but instead focus here on
the process. We will be using three+ weeks of GNSS data from 2021 as our sample dataset.
The orbit option is used to make sure that multi-GNSS signals can be used.
rinex2snr sc02 2021 15 -doy_end 40 -orb gnss
Then you need to make the list of analysis inputs.
gnssir_input sc02 -e1 5 -e2 13 -h1 3 -h2 12 -peak2noise 3 -frlist 1 20 5 101 102 201 205 207 208 -azlist2 60 220
Once you have the json file set up, you can go ahead and analyze all the data with a single command:
gnssir sc02 2021 15 -doy_end 40
This produces reflector heights for every rising and setting satellite track that meets the
quality control metrics that you have set. We have some preliminary code that will help you evaluate
these RH retrievals. It is a work in progress, so it does not do everything yet. It starts
by concatenating the daily results and applying a sigma outlier criterion . The default is set to
2.5 sigma, but you can enter on the command line a more or less stringent value:
subdaily sc02 2021
The output is stored in a plain text or csv file. This code will also apply the RH dot correction.
Below are shown the initial solutions with a spline fit and outliers identified.
Note: These figures were generated from an earlier version of the code, and should be
updated.
Residuals to the spline fit with and without a RHdot correction:
**PLEASE NOTE: the RHdot corrected values are not written to column 3. Look into the file.**
A summary of the number of satellite arcs that are available:
Some statistics come to the screen that give you some perspective
on the performance of the different frequencies and constellations.
Note that there *should* be biases because we have not yet applied
*phase center corrections*. This also shows that the RHdot correction
should be applied at this site, as it does reduce the scatter. Once
the phase center corrections are made, the precision will be further
improved.
RMS no RHdot correction (m) 0.139
RMS w/ RHdot correction (m) 0.106
Freq Bias Sigma NumObs
(m) (m)
1 0.08 0.11 1025
20 -0.02 0.09 803
5 -0.04 0.09 615
101 0.06 0.09 613
102 -0.03 0.10 667
201 0.07 0.09 603
205 -0.04 0.08 616
207 -0.03 0.08 617
208 -0.05 0.08 616
This is a standard Lomb Scargle analysis of reflection data at sc02.
Multiple authors have recommended using different analysis strategies, and
you are most definitely encouraged to look at using these techniques. In most cases
smoothness strategies are used to improve the retrievals.
I have recently posted Simon Williams tidal estimation code to python. I will do my best to add it to this
package.
How well does this simple analyis compare
to the [official NOAA tide gauge data stream?](https://tidesandcurrents.noaa.gov/stationhome.html?id=9449880)
You can download the NOAA data yourselves or use our utility:
download_tides 9449880 noaa -date1 20210115 -date2 20210209
We then compared the two series.
**PLEASE NOTE:**
Since I originally wrote this use case, I have added an option to subdaily to
remove inter-frequency biases. The results of this analysis are written to a
new file and the corrected RH values are in a new column! Please look at the file.