owlps/owlps-positioner/autocalibration.hh

66 lines
2.1 KiB
C++

/*
* This file is part of the Owl Positioning System (OwlPS) project.
* It is subject to the copyright notice and license terms in the
* COPYRIGHT.t2t file found in the top-level directory of this
* distribution and at
* https://code.lm7.fr/mcy/owlps/src/master/COPYRIGHT.t2t
* No part of the OwlPS Project, including this file, may be copied,
* modified, propagated, or distributed except according to the terms
* contained in the COPYRIGHT.t2t file; the COPYRIGHT.t2t file must be
* distributed along with this file, either separately or by replacing
* this notice by the COPYRIGHT.t2t file's contents.
*/
#ifndef _OWLPS_POSITIONING_AUTOCALIBRATION_HH_
#define _OWLPS_POSITIONING_AUTOCALIBRATION_HH_
class Point3D ;
#include "measurement.hh"
/// Base class for the autocalibration methods
class Autocalibration
{
private:
/// Number of generated "virtual" mobiles
static uint32_t nb_virtual_mobiles ;
/// Characteristics of the virtual mobile
double vmob_gain, vmob_pow ;
/// Work to do before actually generating a SS with generate_ss()
bool init_ss_generation(void) ;
protected:
/// The coordinates of the reference point to generate
const Point3D &point ;
/// Current CP to generate a SS for
std::unordered_map<std::string, CapturePoint>::const_iterator rx ;
/// Generated measurements' list
std::unordered_map<std::string, Measurement> measurements ;
/// Generates the SSs for the current CP (#rx)
/**
* Once the preliminary work done, this function should call
* compute_ss() to actually compute the signal strength.
*/
virtual void generate_ss(void) = 0 ;
/// Computes the SS of the virtual mobile
void compute_ss(void) ;
/// Computes a SS with several packets in it
virtual void compute_multi_packet_ss(void) = 0 ;
/// Computes a SS with only one packet in it
virtual bool compute_single_packet_ss(pkt_id_t pkt_id) = 0 ;
public:
explicit Autocalibration(const Point3D &_point): point(_point) {}
/// Generates a single reference point
void generate_reference_point(void) ;
} ;
#endif // _OWLPS_POSITIONING_AUTOCALIBRATION_HH_