ANL-CEEESA/powersas.m
1
0
Fork 0
mirror of https://github.com/ANL-CEEESA/powersas.m.git synced 2025-12-09 03:18:52 -06:00
Code Issues Packages Projects Releases Wiki Activity

First release of PowerSAS.m

Browse Source
This commit is contained in:
Rui Yao
2021-12-22 23:37:28 -06:00
commit 985517593c
168 changed files with 1023584 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files

123
internal/simulationChangeFault.m Normal file
View File

@@ -0,0 +1,123 @@
function [stateUpd,finalAlpha,alphaList,diff,SysDataUpd,faultPrev,fault,maps]=...
simulationChangeFault(busTag,SysData,SysDataBase,SysPara,SimData,maps,...
x0,faultPrev,fault)
% Simulate adding or removing faults
%
% FUNCTION simulationChangeFault
%
% Author: Rui Yao <ruiyao@ieee.org>
%
% 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.
% ***************************************************************************************************
%
% INPUT
% busTag - Tags for determining the partial system that will be kept
% SysData - System data for simulation
% SysDataBase - Base system data for simulation
% SysPara - Parameters representing the events happening in the system
% SimData - Simulation parameters
% *Map - The mapping of current data to base data
% inv*Map - Inverse mapping, base data to current data
% x0 - Initial system state
% faultPrev - Previous fault information
% fault - New fault information
%
% OUTPUT
% stateNew - Solved new state
% finalAlpha - The ending alpha
% alphaList - A list of alphas
% diff - Equation mismatches
% SysDataUpd - Updated system data
% *Map - The mapping of current data to base data (updated)
% inv*Map - Inverse mapping, base data to current data (updated)
%
[bus,sw,pv,pq,shunt,line,ind,zip,syn,exc,tg,agc,cac,cluster]=unfoldSysData(SysData);
busMap=maps.busMap;invBusMap=maps.invBusMap;
indMap=maps.indMap;invIndMap=maps.invIndMap;
synMap=maps.synMap;invSynMap=maps.invSynMap;
lineMap=maps.lineMap;invLineMap=maps.invLineMap;
[~,~,~,~,~,~,~,~,method]=unfoldSimData(SimData);
AEmethod=round(10*mod(method,1));
pqIncrS=zeros(size(pq,1),2);pvIncrS=zeros(size(pv,1),1);
nbus=size(bus,1);
nZip=size(zip,1);
nInd=size(ind,1);
Rzip0S=ones(nZip,1);Rzip1S=zeros(nZip,1);
Rind0S=ones(nInd,1);Rind1S=zeros(nInd,1);
[~,Ytr0,Ysh0,~,~,~,~]=getYMatrix(nbus,line,faultPrev);
[~,YtrNew,YshNew,~,~,~,~]=getYMatrix(nbus,line,fault);
SysParaSim=foldSysPara(pqIncrS,pvIncrS,Rind0S,Rind1S,[],[],Rzip0S,Rzip1S,Ytr0,YtrNew-Ytr0,Ysh0,YshNew-Ysh0,[],[],[],[],[]);
if ~isempty(busTag)&&~isempty(find(busTag==0,1))
% Purge system with busTag
[SysDataUpdFtr,busFtr,swFtr,pvFtr,pqFtr,shuntFtr,lineFtr,indFtr,zipFtr,synFtr,excFtr,tgFtr,...
busMap,indMap,synMap,lineMap,invBusMap,invIndMap,invSynMap,invLineMap]=...
filterSysData(busTag,SysData,busMap,indMap,synMap,lineMap,invBusMap,invIndMap,invSynMap,invLineMap);
SysParaSim=filterSysPara(SysParaSim,busFtr,swFtr,pvFtr,pqFtr,shuntFtr,lineFtr,indFtr,zipFtr,synFtr,excFtr,tgFtr);
fault=updateFault(lineFtr,fault);
faultPrev=updateFault(lineFtr,faultPrev);
x0=filterX(SysData,SysDataUpdFtr,x0,busFtr,swFtr,pvFtr,pqFtr,shuntFtr,lineFtr,indFtr,zipFtr,synFtr,excFtr,tgFtr);
SysData=SysDataUpdFtr;
end
xNew=x0;
if AEmethod==0
[stateUpd,finalAlpha,alphaList,diff]=solveAlgebraicHem(SimData,SysData,SysParaSim,x0,xNew);
else
[stateUpd,flag,diff,loop]=solveAlgebraicNR(SimData,SysData,SysParaSim,x0,xNew);
if flag==0
finalAlpha=1;
else
finalAlpha=0;
end
alphaList=linspace(0,finalAlpha,loop);
end
SysDataUpd=SysData;
maps.busMap=busMap;maps.invBusMap=invBusMap;
maps.indMap=indMap;maps.invIndMap=invIndMap;
maps.synMap=synMap;maps.invSynMap=invSynMap;
maps.lineMap=lineMap;maps.invLineMap=invLineMap;
end
function faultUpd=updateFault(lineFtr,fault)
faultUpd=fault;
if ~isempty(faultUpd)
nLineFtr=max([lineFtr;faultUpd(:,1)]);
lineTag=zeros(nLineFtr,1);
lineTag(lineFtr)=1:length(lineFtr);
faultTag=lineTag(faultUpd(:,1));
faultUpd=faultUpd(faultTag~=0);
faultUpd(:,1)=faultTag(faultTag~=0);
end
end