titantuner 0.1.1

A package for tuning quality control parameters in titanlib

Titantuner

The titantuner is a web interface for tuning the many parameters of quality control methods in titanlib.

Installation

Titantuner is available on pypi, and can be installed as follows:

pip3 install titantuner

To install from source, run the following in the root of this repository:

pip3 install .

Running titantuner

titantuner [-p port]

This starts a webserver locally on your computer, making the titantuner available in the browser. Use -p to speicy the port, otherwise it will appear on port 8081. Some sample data from Norwegian Synop stations are provided by default.

Select the test you want to perform (SCT, Isolation, Buddy, Buddy event, SCT resistant, SCT dual, First Guess), and set the test parameters in the UI. Then click on the update button (below the parameters) to see the map showing the results of the tests.

Running titantuner on your own data

Titantuner can parse data files organzed as follows:

lon;lat;elev;value
9.4023;61.5308;928;3.1
10.6878;60.0513;360;2.6

where lat and lon are in degrees, elev in meters, and value is the measurement. Each row represents one observation, and each file represents observations for one time.

Supply a data directory when starting titantuner, which will load all data files in that directory:

titantuner -d <datadir>

Using the autotune function (beta version)

Ongoing development. This function aims at finding optimized parameters for quality control methods. When running the autotune function as it is, three parameters are optimized for the buddy check run on temperature observations. These optimized parameters are the search radius, the minimum number of buddies a station can have, and the variance threshold for flagging the station.

./titantuner/autotune.py obs_ta_20230924T12Z.txt

With obs_ta_20230924T12Z.txt containing 5 columns of data (temperature values) following this format:

lat;lon;elev;value;prid;dqc
61.1697;10.4107;205.0;13.70;5;0
58.2968;8.4620;70.0;14.60;5;7