ElNullAnalyses.h

Go to the documentation of this file.

#pragma once
 
#include <complex>
#include <optional>
#include <vector>
 
#include <Eigen/Dense>
 
#include <isce3/core/EMatrix.h>
#include <isce3/core/Linspace.h>
 
#include "detail/BinarySearchFunc.h"

namespace isce3 { namespace antenna {
 
// Aliases
using RowMatrixXcf = isce3::core::EMatrix2D<std::complex<float>>;
using Linspace_t = isce3::core::Linspace<double>;
// coef_left (complex), coef_right (complex), el angles (rad)
using tuple_ant = std::tuple<Eigen::ArrayXcd, Eigen::ArrayXcd, Eigen::ArrayXd>;
// echo null power pattern (dB) , el angles (rad), slant range (m)
using tuple_echo = std::tuple<Eigen::ArrayXd, Eigen::ArrayXd, detail::ArrayXui>;
 
// functions:
Eigen::ArrayXcd linearInterpComplex1d(
        const Eigen::Ref<const Eigen::ArrayXd>& x0, const Linspace_t& x,
        const Eigen::Ref<const Eigen::ArrayXcd>& y);

tuple_ant genAntennaPairCoefs(
        const Eigen::Ref<const Eigen::ArrayXcd>& el_cut_left,
        const Eigen::Ref<const Eigen::ArrayXcd>& el_cut_right,
        double el_ang_start, double el_ang_step,
        std::optional<double> el_res_max = {});

std::tuple<double, Eigen::Index, double, Eigen::ArrayXd> locateAntennaNull(
        const Eigen::Ref<const Eigen::ArrayXcd>& coef_left,
        const Eigen::Ref<const Eigen::ArrayXcd>& coef_right,
        const Eigen::Ref<const Eigen::ArrayXd>& el_ang_vec);

tuple_echo formEchoNull(const std::vector<std::complex<float>>& chirp_ref,
        const Eigen::Ref<const RowMatrixXcf>& echo_left,
        const Eigen::Ref<const RowMatrixXcf>& echo_right, double sr_start,
        double sr_spacing, const Eigen::Ref<const Eigen::ArrayXcd>& coef_left,
        const Eigen::Ref<const Eigen::ArrayXcd>& coef_right,
        const Eigen::Ref<const Eigen::ArrayXd>& sr_coef);
 
}} // namespace isce3::antenna