mod training 2021 - cdn.misoenergy.org

MOD Training 2021

1

✓ MOD overview

✓ Data input

✓ MOD File Builder

✓ Case building

✓ Case solving

2

Topic(s): MOD File

Builder

MOD File Builder

MOD File Builder

• Used to compare/analyse 2 PSS/E models

• Creates PRJ file from differences

• Good for listing differences

• Converts file formats (PRJ, PY, IDV)

• Creates BLG and DEV profiles

• Creates ratings set

• Can use criteria to limit comparison to subsystems

• Parameters to compare specific PSSE fields

4

Installation Files

5

MODConfig.xml

6

Copy it to

the installation

directory

7

MOD File Builder

drop downs have

project

types, statuses

8

MFB Parameter Files

• Some fields are not set for v34

• SCALE, INTRPT, WMOD, WPF

• Archived cases section has updated files

9

MFB Parameter files

• Replace busloadgen.txt and devicecontrol.txt

• C:\Program Files

(x86)\PTI\PSSMODFileBuilder\PSSE34\

10

MFB

• Create PRJ by comparing cases

• Create BLG and DEV

• Convert between PRJ, IDV, and PY

11

Create PRJ

• Create Project File

• Project Header - type name, select project types

• Open Base Case - MOD base case

• Open New Case - Case with changes you want in PRJ

• Criteria

• Create subsystem for comparison.

• Differences not in subsystem are ignored

• Parameters

• Change which fields you want to include in PRJ

• Compare (by Criteria) - click if subsystem defined

• Compare (All) - Compares everything

12

Convert IDV, PRJ, PY

• Function → Convert

• If converting to PRJ, need MOD base case

• File Builder applies IDV or PY to base case

• Compares base case to modified case

• Creates PRJ

• Can convert multiple files at once

13

CMD window shows messages

14

MOD FB Document

• With installation files named MOD File Builder 11.1

User's Manual.pdf

15

User Defined Fields

• Can set user defined fields in File Builder

• Need to update MODConfig.xml

• Can set user defined fields within PRJ

16

MOD FB ProjectHeader

17

User Defined

Fields

18

User Defined Fields in PRJ

<PROJECT>,34

UDF Example,Base Case Change,As Built,project comment

<PROJECTUSERDEFINEDFIELDS>

<PrjID> <U_A000=1234>

<Owner PrjID> <U_A005=myPRJID>

<Project short name> <U_A010=My Project>

<Region> <U_A025=2>

<State> <U_A030=7>

</PROJECTUSERDEFINEDFIELDS>

<PHASE>,UDF Example,2019-08-01,2019-08-01,phase comment

<PHASEUSERDEFINEDFIELDS>

</PHASEUSERDEFINEDFIELDS>

19

MOD File Builder 11

• Can convert MOD Base Ratings to py or idv

• Selectable MOD Config and User Defined Parameters

files

• Can convert v34 prj to v33 idv and py

20

MOD Overview

MOD Access Request

• Submit CEII NDA to MISO Client Relations -

https://www.misoenergy.org/stakeholder-engagement/client-relations/

• Company needs to update its Universal NDA Appendix A to list all MOD users.

• Request MOD from the extranet access request form at

https://www.misoenergy.org/access-request/access-request-form/

• MOD Security Officer (LSA signature needed only to the change the MOD Security

Officer) fills out the MOD request form and sends to me.

• When requesting for MOD users who are submitting data (T/R or N/A on UNDA Appendix A)

use this form: https://cdn.misoenergy.org/Model-On-

Demand%20Access%20Request102831.docx

• When requesting for MOD users who are not submitting data (Market/Merchant on UNDA

Appendix A) use this form: https://cdn.misoenergy.org/Market%20Participant%20Model-On-

Demand%20Access%20Request102829.docx

22

https://www.misoenergy.org/access-request/access-request-form/

https://cdn.misoenergy.org/Model-On-Demand%20Access%20Request102831.docx

https://cdn.misoenergy.org/Market%20Participant%20Model-On-Demand%20Access%20Request102829.docx

MOD Webpage

23

MOD Home Screen

24

Network Data

• MOD Base case

• Can be downloaded from home screen

• Starting model for MOD case builds

• Currently everything is PSS/E version 34

25

Alternate Base Case

• Can be used in place of MOD base case in case definitions

• Local Process Managers can upload alternate base case

• Case should be similar to MOD base case

26

External Case

• Use MMWG case for external portion of model

• May need to modify areas and zones to line up with MOD base case

• Need to review tie line anomalies

• MOD takes the internal ties and gives errors for ties in external that aren’t in

internal

27

Projects

28

Project Filtering

• Project name should start with company acronym

• Dates

• One date, then list projects before and including date

• Date ranges

• Filters Project effective date, not phase effective date

• Can create spreadsheet with details of all filtered projects (click Report button)

29

Project Filtering

30

Batch download projects

31

Batch download to zip file

32

Project Report

• By Clicking “Report”, MOD creates an excel spreadsheet listing detail about

the filtered projects

• Tab for Projects_Phases lists all project and phase information

• Each device type has a tab

• Project and phase information listed for each device

• Includes seasonal ratings

33

Project Types

• Defined by MOD Admin

• User group determines what types are visible

• Types used in most models

• Base Case Change - To submit base case corrections

• Generator - Generators

• MTEP A - MISO Documented Need and BOD Approved

• MTEP B - MISO documented need not yet reviewed by MISO Staff

• MTEP C – Do not use

• Non-MISO Network - Not under MISO functional control

• Non-MTEP MISO - Non-transferred facilities

34

PRJ format

• Each record has device type and action

• First field is record type• BUS, LOAD, FIXEDBUSSHUNT, GENERATOR, BRANCH, TRANSFORMER, TRANSFORMER, AREA, TWOTERMDCLINE, VSC,

TXFMIMPEDCORRECTION, MULTITERMINALDCLINE, MULTISECTLNGRPDATA, ZONE, IATRANSFER, OWNER, FACTS,

SWITCHEDSHUNT, GNE, INDUCTIONMACHINE

• Only actions permissible are ADD, DELETE, and MODIFY

• After action field, rest of record matches PSS/E raw format

• For multi-line records, only first line has type and action

35

BLG Profiles

• For building seasonal profiles with different load and generation profiles

• Bus-IDE,VMAG, VA

• Load-STAT, PL, QL, IP, IQ, YP, YQ, SCALE, INTRPT

• Fixed bus shunt-STAT, GL, BL

• Generator-PG, QG, QT, QB, STAT, PT, PB, WMOD, WPF

• 3 winding XF-VMSTAR, ANSTAR

• Induction Machine-STAT, PSET

36

DEV Profiles

• Mostly voltage settings

• Generator-VS, IREG, GTAP, RMPCT

• Transformer-CW, WINDV, ANG,COD, VMA, VMI

• 2 Terminal DC line-MDC, SETVL, VSCHD, VCMOD, RCOMP, DELTI, DCVMIN, TRR,

TAPR, TRI, TAPI

• VSC-MDC,MODE, DCSET, ACSET

• Switched shunt-MODSW, STAT, VSWHI, VSWLO, SWREM, RMPCT, RMIDNT, BINIT

• FACTS-FMOD, PDES, QDES, VSET

37

Ratings

• Seasonal ratings

• Any combination to PSSE rate a, b, c

• NORM, STE, LTE

• Ratings types are defined by MOD admin

• Planning

• SPRG, SUM, FALL, WIN

• RT ratings match webtool

• RTSPRG, RTSUM, RTFALL, RTWIN

• COND ratings no longer used

• CONDSPRG, CONDSUM, CONDFALL, CONDWIN

38

Seasonal Ratings

• Branches- K and Winding are blank

• Two-winding XF- K=0, Winding blank

• Three-winding XF, K>0, winding=1,2, or 3

• Three ratings records, one for each winding

• Windings must be in ascending order

• All windings must be listed, even if ratings are blank

39

<I> <J> <K> <CKT> <Winding> <EquipmentName> <SEASON~NORM> <SEASON~LTE> <SEASON~STE> <SEASON~LD>

1 2 1 Branch 200 250 250 0

2 3 0 1 2 winding xf 100 120 120 0

4 5 6 1 1 3 winding xf, winding 1 150 160 160 0



Base Ratings

• All seasonal ratings are listed

• Updated when base ratings updates are accepted and when projects are committed

40

Ratings

• Base Ratings-set of ratings containing all seasonal ratings

• Ratings in projects overwrite base ratings in case build

• Rate 1=Normal, 2=STE, 3=LTE

41

Case Definitions

• Select projects, profiles, rating seasons, alternate, and external base cases

for model build

• MOD applies in order: external model, projects, profiles, then ratings.

• Projects are sorted so that MOD will apply them in chronological order by

effective date

• Choose “Detailed Logging” so that MOD will create a file listing all changes

to your model

42

Case Definition Export Versions

• Case definition has selector for version of PSSE raw file

• Problem for system switching devices when v33 is selected

• Do not select v33, export as v34 then use PSSE 34 to convert to v33 if

needed

43

Case Definitions

44

Selected Projects & Phases

45

Choose Profiles and Ratings

46

Choose External Model

47

Case Definitions, Batch Build

48

Batch Build

• Will say 10% complete until finished

49

Note: This window & its contents may

look different depending on what

version of MOD is in operation. The

one illustrated here was from MOD

version 10.3

Download Cases

50





version 10.3

Detailed Log File

• Lists all projects included in case build

• Shows order

• Details of each project

• Lists profiles, ratings, external model used

• Can search it to find projects that add, modify or delete a specific device

• Can be used to troubleshoot case build

• Can test project dependencies

51

Anomalies File

• Lists projects with errors

• Modify a device not in base case or added by earlier project

• Delete non-existent device

• Add device that already exists

• When using external model, check for tie lines that don’t match between

MOD base case and external model

• Good for checking projects that have dependencies on other projects

52

MOD Base Case

• Effective date is first of month

• Review case on 25th of previous month

• Final case on last day of previous month or first of month

• 3/25 and 3/31 for April base case which has projects effective on 4/1

• Ratings, profiles, and external change seasonally

• 3/1 SPRG

• 6/1 SUM

• 9/1 FALL

• 12/1 WIN

• Upload seasonal profile on 15th of month before quarterly seasonal updates

53

MOD Base Case Projects

Review Statuses: Accepted

Project Types, Statuses:

Base Case Change: All statuses

Generator: Planned, In Service

MTEP A: Planned

MTEP B: Planned, Target MTEP A

Non-MISO Network: Planned

Non-MTEP MISO: Planned

54

MOD Base Case

• Build model in MOD

• Solve model in PSSE

• Blank fields in MOD set to PSSE default values

• Copy Long Bus Names from exported to solved case

• Commit projects in MOD

• Changes are made to base case in MOD

• Project seasonal ratings copied to Base Ratings

• Projects no longer available in case builds

• Upload solved model to MOD

• Overwrites previous base case

55

MOD committed projects

• Projects (phases) with effective dates on or before the first of the month are

committed to the MOD base case

• Once committed, the project (phase) is no longer used in case builds

• Important to review effective dates before final base case is built each month.

• If project (phase) is committed, it cannot be changed.

• If committed project was delayed

• Submit a new PRJ to remove changes

• Resubmit PRJ with future changes

56

MOD User Manual

• Download from MOD→Help

57





version 10.3

Data Input

MOD file types

• Project (.prj)

• Ratings (.csv)

• BLG (.raw)

• DEV (.raw)

• IDEV (.idv) – download only

• Python (.py) – download only

Data Input

• All input files need to be in PSS/E 34 format

60

Projects

• Add, Modify, and Delete equipment

• User defined fields can be set from PRJ

• SEQ, DYR can be in PRJ

• Seasonal ratings in PRJ

61

Projects

• Click the Import button or link

• Select the PRJ file

• Click Send

• Once imported into MOD, check Validation logs

• Click Submit and Approve buttons

• “Users” set to “Pending Approval”

• “Local Process Managers” set to “Pending Acceptance”

62

Validation logs

• Data submitters should check the validation logs after submitting a project

• MOD checks project changes against base case

• MOD checks project changes against other projects with earlier effective

dates

• MOD checks against projects that are preliminary and in other groups

• MOD lists warning projects in validation log

• Log has project and phase ID numbers

63

Editing Projects

• Can Click Edit anytime to make project “Preliminary”

• Can edit project name, type, status, and comments while not Preliminary

• To change phase names and effective dates, click Edit phase, update date,

then click Update

64

Project Change Log

65

Phase view

66





version 10.3

Phases

• Can append and delete phases

• See document under Archived Cases called MOD 10 appending and

deleting phases.zip

67

BLG profiles

• Click “Import”

• Select file, click “Send”

• Select Base Profile

• Click OK

• Click Submit/Approve until review status is Pending Acceptance

68

BLG profiles

69

DEV profiles

• Same process as BLG

70

Batch import profiles

• Can select multiple profiles for import

• Don’t delete any otherwise MOD may shift data to wrong profiles

71





version 10.3

Ratings

• Two file formats to update seasonal ratings

• If effective date is now, then upload csv and apply to Base Ratings

• If effective date is future, then upload prj that includes seasonal ratings

72

Ratings

<I> <J> <K>

<CKT

> <Winding> <EquipmentName>

<FALL~NORM

>

<FALL~LTE

>

<FALL~STE

>

<FALL~LD

> <SPRG~NORM>

<SPRG~LTE

>

<SPRG~STE

>

<SPRG~LD

> <SUM~NORM>

<SUM~LTE

>

<SUM~STE

>

<SUM~LD

> <WIN~NORM>

<WIN~LTE

> <WIN~STE> <WIN~LD>

1 2 B1 Branch 100 0 125 0 100 0 125 0 100 0 125 0 100 0 125 0

1 3 0 T1 2 winding XF 50 0 50 0 50 0 50 0 50 0 50 0 50 0 50 0

1 3 4 T3 13 winding XF 25 0 30 0 25 0 30 0 25 0 30 0 25 0 30 0

1 3 4 T3 23 winding XF 25 0 30 0 25 0 30 0 25 0 30 0 25 0 30 0

1 3 4 T3 33 winding XF 10 0 12 0 10 0 12 0 10 0 12 0 10 0 12 0

73





version 10.3

Ratings

• Apply to base case if effective immediately

• Base Ratings updated when MISO Accepted

74





version 10.3

Ratings

75





version 10.3

PRJ with ratings

• Include ratings in PRJ

• Project with BRANCH, TRANSFORMER should have ratings updates too in case MISO user applies

PRJ to model without seasonal ratings

76

Project Types

Type Comments

Base Case Change To submit base case corrections

Generator Generators

MTEP A MISO Documented Need and BOD Approved

MTEP B MISO documented need not yet reviewed by MISO Staff

MTEP C Not yet reviewed by MISO staff. Can be alternatives to appendix B projects

NERC External For migrating external data

Non-MISO Network Not under MISO functional control

Non-MTEP MISO Non-transferred facilities

Series Profiles For Master Profiles and Company appended profiles

77

Project statuses

Project Types Project Statuses

Base Case Change Error Correction

Base Case Change Field Change

Base Case Change As Built

Base Case Change Emergency Upgrade

Base Case Change Facility Addition

Base Case Change Correction

Generator Planned

Generator In Service

MTEP A Planned

MTEP B Planned

MTEP B Proposed

MTEP B Alternative

MTEP B Target MTEP A

MTEP C Planned

MTEP C Proposed

MTEP C Conceptual

MTEP C Target MTEP A

NERC External Planned

Non-MISO Network Planned

Non-MTEP MISO Planned

Series Profiles Planned

78

Case Building

Case Building

• Can build cases using Case Definitions

• Specify criteria for case

• Project effective date, types, statuses, review statuses

• Profiles, ratings, alternate, and external cases

• Good for testing your projects

• Anomalies log file shows problems

80

Case definition

• Project Tree

• Select effective date

• Select Project types

• Select Project statuses

• Select Review statuses

• Load projects so list shows in “Filtered Projects & Phases”

• Click “>” button to select projects that will be applied to case

81

Case Definition

82

Case definition

• Always select “Detailed Logging”

• Case build log file has all details about building case

• Project list in order applied

• All details of projects applied

83

BLG, DEV, Ratings

• Select profiles, ratings

• Seasonal ratings overwrite ratings from base case and PRJ

• Fixed bus shunt is same as bus data BLG

84

Alternate base case

• If alternate base case selected, then it is starting case for your build

• Existing projects may not align with case

• Must be similar to MOD base case

• Bus numbers

• Areas

• Can change “internal” areas for your case build, limit to your area only when

also using external case

85

External case

• Select external case

• Can select internal areas

86

External case

• Areas not internal replaced by MOD

• Internal tie representation kept

• Tie line must be changed by project

• New ties in external case not created

• Listed in anomaly log file

• New ties must be added by project

87

Build Case

• When your case definition complete, then click “Build Case”

• Build continues even if you log off or webpage times out

• Files available in *Output from Last Build* or in *Last Batch Case Build*

• Can download zip containing all files

88

Downloading Cases

• Last Build • Last batch case build

89

Note: This window(s) & their contents may look different depending on what

version of MOD is in operation. The ones illustrated here are from MOD version

10.3

Case Solving

Solving a MOD Case

• Typical problems

• Transformer winding kVs on wrong sides

• Generator MVAR

• Swing machines outside of limits

• Conflicting regulated voltages

• If case blows up, reload before trying again. Don’t try to solve a case that

has blown up.

91

Solution Techniques

• Swap winding settings

• Winding 1 and 2 swapped by project but profile not swapped

• Set generator regulated bus to zero

• Change back after MVAR limiting enabled

• Lock switched shunts

• Unlock one at time and solve

• Scale generation so swing machines within limits

• Adjust NSI for area swings, keep total MISO interchange constant

• Turn off generators

• Turn back on after getting stable solution

• Change SS BINIT for those with control mode = discrete

92

Solving

• Change BLOWUP to 1e9

• Iteration limit = 20

• If delta V/V bus has generator, restore

case then change regbus to 0

• Check next delta V/V bus

• Can switch between methods and rerun

• Start with these settings

93

Solving

• Before turning on generator MVAR limiting, check if any QGen way outside

limits.

• Change nearby switched shunt BINIT

• Turn off generator

• Before turning on area ties and loads, update NSI

94

Solving

• Gradually turn on solution options,

solving between

• When the case doesn’t blow up, save a

copy

• When converges with new settings, save

a copy

• Reset changes to original for regbus,

disconnected, locked shunts

• Final settings

95

Disconnecting Buses

• Avoid disconnecting buses, but sometimes necessary

• When reconnecting, set bus voltage and angle to those from newly connected bus

before solving

96

[email protected]

[email protected]

[email protected]

[email protected]

mailto:[email protected]




mod training 2021 - cdn.misoenergy.org

Documents