Functionality Tests

Back to Wiki Home

Tests run to determine functionality of TTECTrA in various circumstances

Function-by-function testing

in = loadfile(fn,in)

• Missing fields relevant for simulation or redesign: forced redesign vector to 1s
• Missing fields relevant for simulation, but not redesign: forced redesign vector to 1s
• Missing fields that may be defined by the user later: successfully loaded data
• Missing fields required to retune setpoint controller, but without request to do so: successfully loaded data
• Missing field required to design deceleration limiter, but without request to do so: successfully loaded data
• Missing setpoint fields required to design acceleration schedule and for simulation, but without request to do any redesign: forced redesign of setpoints
• Missing setpoint controller gains, without request of redesign: forced tuning of setpoint controller
• Missing LPC limiter design, without request of redesign: forced recalculation of this limiter
• Missing acceleration schedule breakpoints, without request of redesign: forced recalculation of the schedule
• Requested file to load contains no variable that is a structure: failed to load data, forced redesign vector to 1s
• Requested file to load contains multiple variables but one that is a structure containing a controller design: successfully loaded data
• Requested file to load contains multiple variables that are structures, loaded one is not a controller design: failed to load data, forced redesign vector to 1s

outputs=TTECTrA_SPcalc(inputs)

• Missing environmental conditions: set to SLS and setpoints calculated
• Missing altitude only: set to 0 and setpoints calculated
• Missing name of the simulation file: setpoint calculation failed
• Missing all information required to calculate setpoints: setpoint calculation failed
• Missing breakpoint vector/range: setpoint calculation failed

output=TTECTrA_controller(inputs)

• Missing all information required for tuning the controller: gain calculation failed
• Missing model-specific information for tuning the controller: gain calculation failed
• Missing information that can be assigned default values before tuning: gain calculation successful
• No “good” linear models in data loaded from file: gain calculation failed
• One “bad” linear model in data loaded from file: gain calculation successful
• Models organized by increasing thrust in data loaded from file: gain calculation successful, no re-ordering necessary
• Models organized by decreasing thrust in data loaded from file: gain calculation successful, reordered by increasing thrust
• Models organized randomly in data loaded from file: gain calculation successful, reordered by increasing thrust
• Models contain a repeated thrust point in data loaded from file: gain calculation successful, repeated point removed
• Wrong file name provided: gain calculation failed
• Attempt to tune in R201a: gain calculation failed

output=TTECTrA_accel_limiter(inputs)

• Missing all information required to determine schedule: schedule calculation failed
• Missing desired surge margin limit: schedule calculation failed
• Missing desired T40 limit: schedule calculation failed
• Missing setpoint information: schedule calculation failed
• Desired surge margin too high: schedule calculation failed, informed of maximum limit
• Desired surge margin too low: schedule calculation failed

output=TTECTrA_decel_limiter(inputs)

• Missing all information required to calculate limiter: limiter calculation failed
• Missing desired surge margin limit: limiter calculation failed
• Missing setpoint information: limiter calculation failed
• Desired surge margin too high: limiter calculation failed, informed of maximum limit
• Desired surge margin too low: limiter calculation failed, informed of minimum limit
• Desired FAR limit too small: limiter assigned for minimum-possible FAR

[output,inputs]=TTECTrA_integration(inputs)

• Missing information about the linear models: compensator design failed
• Method to use for design not specified: compensator design defaults to LMI-based approach
• Missing required toolboxes, and fields specifying linear models, setpoints, and controller design: compensator design failed
• Missing required toolboxes, and method to use for design not specified:

output=TTECTrA_integration_adhoc(inputs)

• Missing setpoint information: compensator design failed
• Missing controller gain information: compensator design failed
• Missing control variable setpoint list: compensator design failed
• Missing Ki gain schedule: compensator design failed

outputs=TTECTrA_integration_LMI(inputs)

• Missing linear model information and gain schedules: compensator design failed
• Missing gain schedules: compensator design failed
• Dimension of compensator not specified: compensator design defaults to full-order
• Name of file containing linear models not specified: compensator design failed
• Missing Ki gain schedule: compensator design failed
• Name of file containing linear models incorrect or not on path: compensator design failed
• At least one non-feasible LMI was found: compensator designed without considering failed cases
• No feasible LMI was found: compensator design failed

outputs=TTECTrA_tuneAL(inputs)

• Missing altitude specification: acceleration limiter controller design failed
• Missing fain schedules: acceleration limiter controller design failed
• Missing breakpoints for setpoints: default acceleration limiter controller assigned
• Missing specifications for limiter controller: default acceleration limiter controller assigned
• Missing index of core speed in output vector: default acceleration limiter controller assigned
• Name of file containing linear models was not on path or incorrect: default acceleration limiter controller assigned

savefile(inputs)

• Missing all information for saving data: data saved to default file name, with warning
• Name of save file not specified: data saved to default file name, with warning
• Specified save file name already exists: saved to “incremented” file name, with warning

Overall testing of TTECTrA.m

Running from TTECTrA_Inputs.m

• Successfully ran from input file with the following specifications: minimum surge margins for both compressors; design anti-windup compensator using LMI-based approach; design acceleration limiter controller using a tuning approach; save the controller
• Input file configured to break setpoint calculation: design process terminated, simulation not performed
• Input file configured to break gain calculation: design process terminated, simulation not performed
• Input file configured to break acceleration limiter calculation: design process terminated, simulation not performed
• Input file configured to break deceleration limiter calculation: design process terminated, simulation not performed
• Linear models are such that anti-windup compensator design fails: design process terminated, simulation not performed
• Requested ad hoc method for anti-windup compensator and tuning approach for acceleration limiter controller (both require closed-loop searches): changed approach for acceleration limiter controller to default, with warning, then successfully designed and simulated the controller
• Requested LMI-based method for anti-windup compensator and default tuning for acceleration limiter controller: successful design and simulation of controller
• Requested ad hoc method for anti-windup compensator and default tuning for acceleration limiter controller: successful design and simulation of controller

Running from loaded controller data

• Successfully simulated a fully-specified pre-loaded controller
• Successfully simulated a pre-loaded controller missing only design-related fields
• Loaded controller missing only control-related fields: controller successfully redesigned, simulated, and saved
• Loaded controller missing setpoint information, requested for design: setpoints calculated successfully, controller successfully simulated and saved
• Loaded controller missing controller information, setpoints requested for design: setpoints and controller gains successfully calculated, controller successfully simulated and saved
• Successfully simulated a fully-specified pre-loaded controller designed using v1 (GUI)
• File name for loading controller data incorrect/not on path: load unsuccessful, complete design and simulation performed

Testing of TTECTrA in “batch” mode

Running from TTECTrA_Inputs.m

• Successfully designed controllers for “single” specification sets, with various selections of anti-windup and acceleration limiter controller designs, and with both LPC SM and FAR deceleration limiter design (8 tests)
• Successfully designed and saved controllers for varying bandwidths of setpoint controller
• Successfully designed controllers for varying phase margins of setpoint controller
• Successfully designed controllers for varying HPC surge margins
• Successfully designed controllers for varying LPC surge margins
• Successfully designed controllers for varying FAR
• Successfully designed controllers for varying both bandwidths and phase margins of setpoint controller in same call
• Successfully design controllers for varying both HPC and LPC surge margins in same call
• Successfully design controllers varying bandwidths and phase margins of setpoint controller and HPC and LPC surge margins in same call
• Successfully designed controllers varying bandwidths and phase margins of setpoint controller, HPC surge margin, and FAR in same call
• Tested complete failure at each of the six design steps and failure of one or more designs to complete at each step

Running from loaded controller data

• Successfully tested redesign of setpoint controller, for a range of bandwidths, and auto-redesign of anti-windup compensators for each redesign
• Successfully tested redesign of limiters for a range of HPC and LPC surge margins
• Successfully tested redesign of limiters for a range of HPC surge margins and FAR
• Successfully tested redesign of each individual part of the controller (6 tests) to double check logic used to enforce some default settings (e.g. flags when designing for FAR limit only need to be changed when also designing both anti-windup compensator and acceleration limiter controller)