This is a library for handling Direction Finding calculations.

The main purpose is to collect position/bearing reports from various stations and compute estimates of target location from them.

From a user's perspective, the most important classes to use are:

DFLib::Proj::Report

DFLib::ProjReportCollection

All of these are derived classes from more abstract classes where the hard work is done.

Here's the basic work flow for any program that uses DFLib:

-Create a ReportCollection (either DFLib::ReportCollection or DFLib::ProjReportCollection)

-for each DF report, create a Report (DFLib::Proj::Report being the most general, supporting multiple coordinate systems)

-add reports to the report collection using the addReport method.

-compute various fixes using the "computeXXXFix" methods of the report collection.

The program SimpleDF.cpp is a very trivial example program that uses DFLib to compute fixes from DF reports supplied in a rigidly-formatted text file. Two example text files for input to SimpleDF (ELTPractice and ELT_excluded)are included. SimpleDF is a demo program that does very little error checking, but it does show how to make use of DFLib classes.

The program testlsDF_proj.cpp is a test harness that was used during development of DFLib. It uses a known transmitter location and a list of receiver locations, randomizes the bearing errors from receiver to transmitter, and computes fixes from the randomized problem. Repeated runs of testlsDF_proj will use different randomized bearings, and therefore produce very different DF fixes. It can be used to see the variability of the different methods.

DFLib source can be accessed at its GitHub project page. If you're just interested in downloading without using git, you can download a tarball or zipfile of the source code.

A companion GUI program, qDF, is also on GitHub.