Main Content

eclipsingfactor

Range-dependent eclipsing factor

Since R2021a

collapse all in page

    Syntax

    FECL = eclipsingfactor(R,DU,PRF)

    Description

    FECL = eclipsingfactor(R,DU,PRF) computes the range-dependent eclipsing factor FECL in decibels, given unambiguous range R duty cycle for a simple rectangular pulse or vector of samples from an arbitrary waveform DU and pulse repetition frequency PRF.

    example

    Examples

    collapse all

    Open Live Script

    Calculate the range-dependent eclipsing factor at 1 km intervals between zero and the unambiguous range, R, assuming an unmodulated rectangular pulse with a duty cycle of 0.1 and the pulse repetition frequency of 1000 Hz.

    DU = 0.1;
PRF = 1e3;
R = 0:1000:time2range(1/PRF);
FECL = eclipsingfactor(R,DU,PRF);

    Plot the range-dependent eclipsing factor.

    plot(R*1e-3,FECL)
xlabel('Range (km)');
ylabel('Eclipsing Factor (dB)');
ylim([-25 1]);
grid on;
title('Range-Dependent Eclipsing Factor');

    Figure contains an axes object. The axes object with title Range-Dependent Eclipsing Factor, xlabel Range (km), ylabel Eclipsing Factor (dB) contains an object of type line.

    Input Arguments

    collapse all

    Range at which to compute the eclipsing factor, specified as a positive scalar or as a length-J vector in meters.

    Duty cycle, specified as a nonnegative scalar in the range [0,1] or length-M vector with each element in the range [0,1].

    • If you specify DU as a scalar, the eclipsing factor is computed for an unmodulated rectangular pulse with the specified duty cycle.

    • If you specify DU as a length-M vector, the eclipsing factor is computed for a waveform, using time domain samples taken over a one-pulse interval.

    Pulse repetition frequency, specified as a positive scalar or as a length-K vector in Hz.

    Output Arguments

    collapse all

    Eclipsing factor, returned as a J-by-K matrix in decibels with rows corresponding to the ranges in R and columns corresponding to the values in PRF.

    Extended Capabilities

    C/C++ Code Generation
    Generate C and C++ code using MATLAB® Coder™.

    Version History

    Introduced in R2021a

    See Also