% The xDSL simulation tool - Main routines
%
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
% Functions to set up an experiment
%
%  setupParam           Routine to set up the parameter part of the ex struct.
%  setupLClist          Set up theoretical line code dependent structures
%
%  calcPSD              Generates a PSD mask from a PSD description
%  setupPSDplan         Generate a PSD description from a simple list
%  makeUFplan		Generate a tfplan from a freq. grid and 'ud' directions
%  planConvertion       Convert a frequency grid into a plan based
%                       on center fq and bw
%  planConvertion2Band  Convert a frequency grid into a plan based
%                       on upper and lower edges
%  TTsetup              Sets up a tt traffic and topology structure
%                       from a list of modems
%
%  plotTFplan           Plots the PSD mask for a certain TF plan
%  plotTTstructure      Plots the TT structure
%
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
% Functions for the evaluation of an experiment
%
%  evalExperiment       The main evaluation routine
%  buildAttMtr          Initialize and create the Att_mtr matrix
%  checkEx              Check experiment description in the global structure ex
%  evalNoise  		Calc noise in LT & NT nodes between start and stop node
%  calcUPBO  		Calculates power back-off (PBO) for upstream
%  getMinFreqaxis  	Finds minimal set of frequencies for frequency axis
%  getDM                Finds index in traffic that match modem types (ADSL/VDSL)
%  addFSAN              Adds noise according to the FSAN combination method
%  setTT                Modify a tt struct by replacing generic names with specific ones
%  sqrcPSD		Generate a square root raised cosine mask
%
%  getIL                Get the attenuation (insertion loss) in a topology
%  getABCD              Get the ABCD parameters in a topology   
%  getTwoPortModel      Get the two port model [Z0,gamma] for cable 'name' 
%  ABCDprod             Multiply two ABCD matrices (over all f)
%
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
% Post processing and results
%
%  calcXDSLresult       Calculate all disturbed modem bitrates (linecode dep.)
%  calcResultTheo  	Calculate resulting theoretical bit rates
%  NOTE, other calcResult routines can be found in xdsldefs
%
%  plotResult  		Plot a result plot
%
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
% GUI suport routines
%
%  getNoiseModels       Gets all available noise models for this tool
%  getUPBOmethods       Gets all available upstream PBO methods for this tool
%
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
% List handling routines
%
%  getList		Get an object from a list based on the object name
%  getNameList		Get list of names of the objects in a list
%  insertList		Insert an object into a list
%  setList		Set a named object in a list to a new value (object)
%
% Other help functions
%  findStrIndex         Find string (index) in array of strings
%
% Misc
%  Content  		This file
%  xDSLsimuVersion	Returns current simulator version
%  printTree            Prints structured content (useful for debugging)

%% ===========================================================================
% Copyright (C):
%       1998-2000 by Telia Research AB, Lulea, Sweden;
%       2000-2009 by Forschungszentrum Telekommunikation Wien, Austria;
%                                                         All rights reserved.
% Description   : The contents of the main xDSL simulation tool directory
%
% File          : Content.m
% Project       : FTW's xDSLsimu
% Author(s)     : Tomas Nordstrom (Tomas.Nordstrom@FTW.at)
%               : Daniel Bengtsson (Daniel.J.Bengtsson@Telia.se)
%
% CVS:       $Id: Contents.m 752 2009-01-02 13:03:52Z tono $
%% ===========================================================================
% Change History
%      1998-11-13 (ToNo) Created
%      1998-12-18 (ToNo) Added the new files
%      1998-12-21 (ToNo) Added even more new files
%      1999-01-11 (ToNo) Updated before release
%      1999-01-18 (ToNo) Added getMaxVDSLlength
%      1999-03-25 (ToNo) Updated before release
%      1999-11-19 (ToNo) Updated before release version 2
%      2000-03-13 (ToNo) Some minor editing
%      2000-03-14 (ToNo) Restructured into pre step, eval, and a post step
%      2000-04-04 (DaB)  Removed calcRate
%      2000-09-17 (ToNo) Removed some unused functions and added some new ones
%      2001-01-19 (ToNo) Removed some unused functions
%      2005-01-21 (ToNo) Updated with new and moved functions
%      2005-03-29 (ToNo) Updated with new and moved functions after UPBO rev.
%% ===========================================================================