dbthelp.m

阵列信号处理的工具箱

%DBTHELP Help file for the DBT toolbox, with a list of useful functions and scripts.
%
%   *  DBT, A Matlab Toolbox for Radar Signal Processing  *
% (c) FOA 1994-2000. See the file dbtright.m for copyright notice.
%
%For an overview of the toolbox, see reference [2].
%The following example scripts for the end user are currently implemented:
%
%   dbtex1.m    : An example with an ULA with isotropical elements.
%   dbtex2.m    : An example of DOA-estimation with coherent signals.
%   dbtex3.m    : An example with the AIMT application example.
%   dbtex4.m    : An example with PTMF.
%   dbtex51.m   : Demonstrates conventional radar signal processing.
%   dbtex5.m    : Demonstrates the conventional signal processing chain in
%                 the AIMT application example.
%   dbtex6.m    : An example doing Monte-Carlo simulations with DML and ULA.
%   dbtex7.m    : An example of beamforming on measured data from the AIMT
%                 experimental antenna.
%   dbtex8.m    : An example doing statistical analysis with the AIMT
%                 experimental antenna.
%   dbtex9.m    : An example of beamforming on measured data from the AIMT
%                 experimental antenna with different calibration compen-
%                 sations of the steering matrix.
%   dbtex10.m   : An example of beamforming on measured data from the AIMT
%                 experimental antenna with calibration compensation on the
%                 signals. NOTE: the implementation is not finnished. This
%                 example does not work yet.
%   dbtex15.m   : An example of plotting antenna patterns.
%   dbtex20.m   : An example for the simulator "simradarsig".
%   dbtex21.m   : An example of beamforming of radar signals.
%   dbtex22.m   : An example of pulse compression of radar signals.
%   dbtex23.m   : An example of doppler filtering of radar signals.
%   dbtex25.m   : An example of conventional and high resolution doppler 
%                 filtering.
%   dbtex26.m   : An example of conventional and high resolution simultaneous 
%                 beamforming and doppler filtering (slow-time STAP).
%   dbtex28.m   : Another example of conventional and high resolution 
%                 simultaneous beamforming and doppler filtering (slow-time 
%                 STAP).
%   dbtex29.m   : An example of noncoherent and coherent integration.
%   dbtex30.m   : An example of radar signal simulation, including clutter,
%                 with a flying side-looking array radar.
%   dbtex60.m   : An example of beamforming and DOA estimation on measured
%                 signals that are reflected against a rough surface.
%   dbtex70.m   : An example of performing radar signal processing on and
%                 plotting of measured radar signals.
%   dbtex80.m   : An example of the creation of an array antenna with
%                 subarrays using antenna type BFArray.
%   dbtex81.m   : An example of the creation and use of a circular array
%                 antenna.
%   moderrgui.m : An example of a graphical tool for model error analysis
%                 using the DBT toolbox.
%
%   dbthelp.m   : This help file.
%
%The following functions for the end user are currently implemented:
%
% Definition of antennas.
%   defant      : Defines an antenna.
%   pantpat3    : Plots the antenna pattern (mechanical scan) of an antenna.
%   spantpat3   : Simple or short calling form of pantpat3.
%   gettap1     : Calculates taperings for conventional beamforming.
%
% Non-radar signal simulation.
%   compsim4    : Simulates received antenna signals. Only one range bin
%                 (passive mode).
%   simwidebandkernel : Simulates wideband radio signals received with array
%                 antennas. Only one range bin (passive mode).
%   simwideband : Like simwidebandkernel but with other input parameters.
%
% Radar signal simulation
%   simradarsig : Simulates received radar antenna signals (active mode).
%                 Multiple range bins and multiple modulation codes are used
%                 together with "simnoise" and "simtarget".
%   deftarget   : Defines a target for the function "simaradarsig".
%   defnoise    : Defines a noise for the function "simaradarsig".
%   defclutter  : Defines clutter for the function "simaradarsig".
%   defjammer   : Defines a jammer for the function "simaradarsig".
%   defsources  : Combines several signal source definitions from the
%                 functions "deftarget", "defnoise", "defclutter", 
%                 "defjammer" to a single input parameter to "simradarsig".
%   defwave     : Defines a waveform for use with, for example, "simradarsig".
%   getmod      : Returns a pulscode modulation for use with for example
%                 "defwave" and "pulscomp".
%
% Low level radar signal simulation (usually not called by the end user).
%   simnoise    : Simulates received noise signals. Called by simradarsig.
%   simtarget   : Simulates radarsignals from targets. Called by simradarsig.
%   simclutter  : Simulates clutter. Called by simradarsig.
%
% Using signals from the FOA experimental antenna.
%   expsig1     : Gets measured antenna signals.
%   setcal1     : Sets calibration compensation to use with sdoaspc,
%                sdoapar1 etc. via spastemat.
%   sigcomp2    : Does calibration compensation on the signals.
%   dbsfileinfo : Displays information about a DBS-file.
%   dbcfileinfo : Displays information about a DBC-file.
%
% Radar signal management and analysis.
%   basecorrm   : Base estimates of the antenna signal correlation matrix.
%   ecorrm      : Antenna signal correlation matrix estimate or modfication
%                 of the estimate.
%   sigsize     : Returns the size of a radar signal.
%   sigplot2    : Plots a 1D- or 2D-slice of a radar signal.
%   sigplot2win : Interactiv version of "sigplot2" via a GUI.
%   addsig      : Adds two radar signals.
%   sigsubix    : Gets some specified elements (indices) of a radar signal.
%   sigsplitdim : Splits a dimension in a radar signal into two dimensions.
%   sigswapdim  : Swaps two dimensions in a radar signal.
%   normcohpulse: Makes a radar signal coherent between pulses.
%   normsig     : Normalizes a radar signal or a spatial correlation matrix 
%                 relative the noise power.
%   estnoisepower:Estimates the noise power in a radar signal.
%   RxRadarSigT : Creates a variable of the data type "RxRadarSigT", i.e.
%                 a radar signal.
%   msigmat2    : Rearranges the received antenna signals to a multi-
%                 dimensional matrix with time, distance and direction as 
%                 indices.
%   examsigw    : Examines a received radar signal waveform in various ways.
%   RxCorrMatT  : Creates a variable of the data type "RxCorrMatT", i.e. 
%                 spatial correlation matrices.
%   eigplot1    : Plots the eigenvalues of correlation matrices.
%   correig2sig : Calculates the eigenvalues of correlation matrices and
%                 converts the result to a radar signal so that it can be
%                 plotted with functions intended for radar signals.
%   corrmplot   : Plots a spatial correlation matrix.
%
% Simulation of channel errors.
%   simcherr    : Simulates channel errors.
%
% Spectral DOA estimation ("beamforming").
%   sdoaspc     : Estimates a DOA-spectrum with different methods. 
%                 Implemented methods are Conventional beamforming, Capon, 
%                 Music, Min-norm.
%   doaspc1     : Like sdoapar but with som extra input parameters.
%   splot2      : Plots one or more DOA spectrums.
%   doapeak     : Finds the peaks of a DOA spectrum.
%   doaspc2sig  : Converts a DOA spectrum to a radar signal so that it can be
%                 plotted with functions intended for radar signals.
%   DoaSpecT    : Creates a variable of the data type "DoaSpecT", i.e.
%                 a DOA spectrum.
%
% Parametric DOA estimation.
%   sdoapar1    : Estimates DOA:s with different methods. Implemented
%                 methods are DML, SML, PTMF, WSF, SSF, Root Music, ESPRIT.
%   doapar1     : Like sdoapar but with som extra input parameters.
%   stardoa     : Finds the startvalues for parametric algorithms.
%   pdoapar     : Presents on the screen information about DOA:s.
%   pdoait      : Plots the DOA:s for all iterations from PTMF.
%   perrfun     : Plots the error function for all iterations from PTMF.
%
% Estimation of number of signal sources.
%   spanosrc    : Estimates the number of signals sources using spatial
%                 information.
%
% High level radar signal processing functions.
%   beamform    : Conventional beamforming with or without tapering and
%                 with or without side lobe cancellation.
%   dbf         : Performs conventional beamforming (old function).
%   pulscomp    : Performs pulse compression.
%   dopplerfilt : Dopplerfilter bank by correlation.
%   dfb2        : Doppler filter bank by FFT.
%   videoint    : Video integration (incoherent summation) of all coherent
%                 processing intervalls.
%   cfar        :
%
% Low level radar signal processing functions.
%   spafilt     : Spatial linear filtering (beamforming).
%   pulfilt     : Pulse (slow-time) linear filtering (doppler filtering).
%   ranfilt     : Range (fast-time) linear filtering (pulse compression).
%   spapulfilt  : Space-pulse (space-slow time) linear filtering 
%                 (slow-time STAP).
%   sparanfilt  : Space-range (space-fast time) linear filtering 
%                 (fast-time STAP).
%
% Weigting functions.
%   taylorlp    : Calculates Taylor weights.
%   chebylp     : Calculates Dolhp-Chebychev weights.
%   bartlett    : Calculates Bartlett weights (Signal Processing Toolbox).
%   blackman    : Calculates Blackman weights (Signal Processing Toolbox).
%   hamming     : Calculates Hamming weights (Signal Processing Toolbox).
%   hanning     : Calculates Hanning weights (Signal Processing Toolbox).
%   kaiser      : Calculates Kaiser weights (Signal Processing Toolbox).
%   triang      : Calculates triangular weights (Signal Processing Toolbox).
%
%
%Miscellaneous processing functions.
%   estlocalfreq: Estimates the local (instantaneous) frequency of a signal.
%
%Auxiliary functions.