PowerPlannersInternational

PSS/E Training Course for NG SA

PSAS - To run Stability Simulations in Batch Mode

This method is quite useful in Stability in Dynamic Analysis.

Week 2 Day-1-G EOA Head Office, Dammam Dec. 01 Dec 05, 2013

PSSE PSAS Macro Language

PSAS(PSSEEngineeringBasic)isabuiltinmacrolanguagethatsupports PSSEDynamicSimulationsthroughtheuseofEnglishlikecommandmacros. PSAScommandsarecreatedwithinatextfileusingatexteditor. Eachrecordisintheformofacommandstartingwithaverbfromapreviously definedvocabulary. PSAScommandsdonotinteractwithPSSEdirectly.ThePSASmacro processorisreallyatranslatorfromthePSASlanguagetoaResponseFile, whichmaycontainamixtureofcommandlineandbatchcommands.ThePSAS commandlinecommandnormallyautomaticallyperformsthecommandsin theResponseFileafterthetranslation. Somecommandsprovidefortheoptionalspecificationofkeywords,numeric, and/orcharacterquantities;theseareshowninthecommandsyntaxenclosed inbraces([]). Whereoneofseveralkeywordsmaybespecified,theyareshowninthe commandformatenclosedinverticalbars(||). Oneofthekeywordslistedmustbeenteredinthefield. Eachkeywordordatavaluemustbefollowedbyoneormoreblanks.For clarity,acommaorequalsignmaybeusedinplaceof,orinadditionto,a blankspace.Forexample,thefollowingtwoPSAScommandsareequivalent: STARTOUTPUTSAVNW.PLT START,OUTPUT=SAVNW.PLT

PSSE PSAS Macro Language

Any field labeled bus id designates that a bus identifier is to be entered. When the numbers input option is in effect, the bus number must be specified; using the names input option, the extended bus name enclosed in single quotes is required. Any field labeled dc id designates that a two-terminal dc line name is to be entered. If the name contains any blanks or special characters, it must be enclosed in single quotes. I and R indicate that integer and real (i.e., it may include a decimal point) numeric values respectively are to be specified. Many PSEB commands provide for the insertion of optional descriptive text in designated fields, indicated by [n] in the command syntax. For example, the following two PSEB commands translate into the same PSSE dialog: RECOVER FROM SAVNW.SAV RECOVER saved case FROM SAVNW.SAV A dollar sign ($) at the end of a PSEB command line is used to continue the command on the following line. At least one space must precede the dollar sign. As many physical lines as required may be used to specify a single PSEB command as long as all lines except the last one are terminated with a dollar sign. This multiline capability may be used with all PSEB commands except the USE command In addition, each PSSE activity command and response to an instruction entered in passthru mode must be entered on a single line.

Common PSAS Commands

RetrievingConvertedLoadFlowandSnapshotfiles RECOVERFROMSAVNW.SNPANDSAVNW.SAV RECOVERsnapshotandsavedcaseFROMSAVNW.SNPANDSAVNW.SAV

TheRECOVERcommandisusedtoaccessthedesignatedSnapshotandSaved CaseFiles. TheRECOVERcommandoverwritesdynamicsworkingmemoryandthepower flowworkingcase Initializingthecaseforstabilitysimulation |INITIALIZE|OUTPUT|(filename)|[SNAPSHOT|(filename)|] |START||NONE|[|NONE|] ThisformoftheSTARTcommandisusedtoinitializethedynamicmodelin preparationforstatespacesimulations.TheSTRTactivitycommandisgeneratedwith userspecifiedchanneloutputandSnapshotfilenameresponses.Thereservedtoken NONEmaybeusedtoindicatethatthecorrespondingfilenameisnottobespecified

Common PSAS Commands

Runstabilitysimulation
|TO| |CYCLE[S] |RUN[n]|FOR|(R)|SECOND[S]|[PRINT(I)][PLOT(I)][CRTPLT(I)]
TheRUNcommandisusedtoperformdynamicsimulationcalculationswithactivityRUNorMRUN. IftheRUNcommandisprecededbytheSTARTcommand,theformoftheSTARTcommand determineswhetheractivitiesRUNorMRUNistobeused. Otherwise,statespacesimulationsareassumedandactivityRUNisused.Therealvalueindicates thedurationofthesimulationcalculationandmaybespecifiedineithersecondsorcycles.Itisthe valueofsimulationtime(i.e.,TPAUSE)whenthetokenTOprecedesitandanincrementalvalueof timewhenthetokenFORprecedesit. Theoptionalintegertokensandtheircorrespondingkeywordsallowtheusertospecifychannel printingandplottingintervals

Convergencemonitorinstabilitysimulationrun

|OFF| CONVERGENCEMONITOR|ON| TheCONVERGENCEMONITORcommandisusedtoenableordisabletheprintingofthenetwork solutionconvergencemonitorduringtheexecutionofthePSSEactivitycallsgeneratedby subsequentSTARTandRUNcommands.Bydefault,theconvergencemonitorissuppressed.

Common PSAS Commands

Applying3PhaseFault

APPLYFAULT[n]BUS(busid)[n] ThisformoftheAPPLYFAULTcommandisusedtoapplyasolidlygroundedthreephasefaultatthe designatedbus.TheResponseFilebeingconstructedbyactivityPSASincludesresponsestouse activityALTRtochangethefixedshuntatthebustoj(2x109);

Applying1PhaseFaultorotherunbalancedfaults

|Y||MVA| APPLYFAULT[n]BUS(busid)[n]|ADMITTANCE|(R1)(R2)|MHO[S]|[BASEKV(R)] ThisformoftheAPPLYFAULTcommandisusedtoapplyafaultwithaspecifiedfaultadmittance, (R1)+j(R2),atadesignatedbus.TheResponseFilebeingconstructedbyactivityPSASincludes responsestouseactivityALTRtochangethefixedshuntatthebus.(R2)shouldbeenteredasa negativenumber. IftheMVAtokenisspecified,theactiveandreactivecomponentsoffixedshuntatthebusaresetto thevaluesspecifiedas(R1)and(R2)respectively;i.e.,thefaultadmittanceisspecifiedinthesame MVAunitsasisbusshunt. IftheMHOorMHOStokenisspecified,(R1)and(R2)areenteredinmhosandactivityPSASconverts themtotheMVAunitsusedforspecifyingbusshunts.Iftheoptionalbasevoltagetokensare specified,thebasevoltagespecifiedonthePSAScommandisusedintheconversioncalculation; otherwise,thebasevoltagecontainedintheworkingcaseforthedesignatedbusisused.Ineither case,apositivebasevoltagevalueisrequired.

Common PSAS Commands

ClearingtheFault
CLEARFAULT[n][BUS(busid)] CLEARBUS[FAULT][n][BUS(busid)]

TheseformsoftheCLEARcommandareusedtoclearbusfaultswhichwerepreviouslyapplied withtheAPPLYFAULTcommand(seeabove).TheResponseFilebeingconstructedbyactivity PSASincludesresponsestouseactivityALTRtochangethefixedbusshuntatthebusbacktoits originalvalue. ActivityPSASremembersthefaultedbusandthefixedbusshuntwhichwasreplacedwiththe faultadmittanceforuptotenbusfaults.Iftheoptionalbusidentificationtokensareomitted, activityPSASclearsthelastbusfaultwhichwasappliedandwhichhasnotalreadybeencleared.

Applying1PhaseFaultorotherunbalancedfaultsonline

|LINE| [|CKT|] APPLYFAULT[n]|TIE|[n]FROM[n]BUS(busid)TO[n]BUS(busid)[n][|CIRCUIT|(id)][n] |BRANCH| ThisformoftheAPPLYFAULTcommandisusedtoapplyasolidlygroundedthreephasefaultat thefrombusendofadesignatednontransformerbranch.TheResponseFilebeingconstructed byactivityPSASincludesresponsestouseactivityALTRtochangethelineshuntatthefrombus endofthebranchtoj(2x107).

Common PSAS Commands

Applying1PhaseFaultorotherunbalancedfaultsonline

|LINE|[|CKT|] APPLYFAULT[n]|TIE|[n]FROM[n]BUS(busid)TO[n]BUS(busid)[n][|CIRCUIT|(id)][n] |BRANCH| |Y||MVA| |ADMITTANCE|(R1)(R2)|MHO[S]|[BASEKV(R)] ThisformoftheAPPLYFAULTcommandisusedtoapplyafaultwithaspecifiedfaultadmittance, (R1)+j(R2),atthefrombusendofadesignatednontransformerbranch.TheResponseFilebeing constructedbyactivityPSASincludesresponsestouseactivityALTRtochangethelineshuntatthe frombusendofthebranch.(R2)shouldbeenteredasanegativenumber.Iftheoptionalcircuit identifiertokensareomitted,acircuitidentifierof1isassumed. Clearingfaultsonline |LINE| CLEAR|TIE| FAULT[n] |BRANCH| ThisformoftheCLEARcommandisusedtoclearthelastlinefaultwhichwaspreviouslyappliedwith theAPPLYFAULTcommand(seeabove).TheResponseFilebeingconstructedbyactivityPSASincludes responsestouseactivityALTRtochangetheappropriatelineshuntonthefaultedbranchbacktoits originalvalue.ActivityPSASremembersthefaultedbranchandthefromandtobusorientation specifiedonthelastAPPLYFAULTcommand.Notethatonlythelastlinefaultcommandisremem beredbyactivityPSAS.

Common PSAS Commands

PassthroughforresponsefileiteminPSAS
|PSS| |PASS| |PASSTHRU| ThePASSTHRUcommandisusedtoinformactivityPSASthatsubsequentcommandinputisinthe formofBAT_recordsand/orPSSEactivitycommandsandresponsestoquestionsratherthaninthe formofPSAScommands.Whilepassthrumodeisineffect,eachinputtoactivityPSASissimply appendedtotheResponseFilebeingbuiltwithoutmodification.IfinputtoactivityPSASisbeing takenfromtheusersterminal,thepromptPASSTHRU:isissuedwhilethismodeisineffect.

TerminatingPassthrough
IfinputtoactivityPSASisbeingtakenfromtheusersterminal,thepromptPASSTHRU:isissued whilethismodeisineffect.PassthrumodeisterminatedandPSAScommandmodereinstatedby enteringthecommandFIN. FIN TerminatepassthrumodeandreinstatePSAScommandmode.

TerminatingPSAS
END TheENDcommandterminatesPSAScommandinput.Unlessitisotherwisesuppressed,the ResponseFileconstructedbyactivityPSASisautomaticallyexecuted.

ForallcommandsofPSASuseReadyReferenceinProgramOperationManual (POM)