function res=calCTG(SysData,options,caseName,varargin) % % FUNCTION calCTG % % Function for calculating contingencies % Author: Rui Yao % % Copyright (C) 2021, UChicago Argonne, LLC. All rights reserved. % % OPEN SOURCE LICENSE % % Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met: % % 1. Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer. % 2. Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution. % 3. Neither the name of the copyright holder nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission. % % % ****************************************************************************************************** % DISCLAIMER % % THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED % WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A % PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY % DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, % PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER % CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR % OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. % *************************************************************************************************** % res=[]; simSettings=getDefaultSimSettings(); if nargin<2 options=regulateOptions(); else options=regulateOptions(options); end if nargin<3||isempty(caseName) caseName=['d_~',num2str(size(SysData.bus,1))]; end nVarargs=length(varargin); if nVarargs<1 ME=MException('PowerSAS:invalidArgument','CTG should have arguments specifying contingencies.'); throw(ME); else lineSpec=[]; if nVarargs>=1 lineSpec=varargin{1}; end if nVarargs>=2 snapshot=varargin{2}; hotStart=1; else snapshot=[]; hotStart=0; end options.hotStart=hotStart; evtLineSpec=zeros(length(lineSpec),5); evtLineSpec(:,1)=lineSpec; evtLineSpec(:,2)=1; simSettings.evtLineSpec=evtLineSpec; simSettings.evtLine=[1,1,length(lineSpec)]; simSettings.eventList=[simSettings.eventList;[2,0,0,7,1,simSettings.eventList(1,[6,7])]]; res=runDynamicSimulationExec(caseName,SysData,simSettings,options,snapshot); end end function options=regulateOptions(options) if nargin<1 options=[]; end if ~isfield(options,'nlvl');options.nlvl=15;end if ~isfield(options,'taylorN');options.taylorN=4;end if ~isfield(options,'segAlpha');options.segAlpha=1;end if ~isfield(options,'dAlpha');options.dAlpha=1;end if ~isfield(options,'alphaTol');options.alphaTol=0.001;end if ~isfield(options,'diffTol');options.diffTol=1e-6;end if ~isfield(options,'diffTolMax');options.diffTolMax=1e-2;end if ~isfield(options,'method');options.method=0;end if ~isfield(options,'diffTolCtrl');options.diffTolCtrl=1e-5;end if ~isfield(options,'Efstd');options.Efstd=1.2;end end