Case I/O¶

AMS supprots multiple case formats.

Still, first import the ams library and configure the logger level.

In [1]:

import os

import ams

In [2]:

ams.config_logger(stream_level=20)

Input¶

AMS Execel¶

In [ ]:

sp_xlsx = ams.load(ams.get_case('ieee14/ieee14_uced.xlsx'),
                   setup=True,
                   no_output=True,)

sp_xlsx.summary()

Parsing input file "/Users/jinningwang/work/miniconda3/envs/amsre/lib/python3.12/site-packages/ams/cases/ieee14/ieee14_uced.xlsx"...
Input file parsed in 0.0670 seconds.
System set up in 0.0012 seconds.
-> Systen size:
Base: 100 MVA; Frequency: 60 Hz
14 Buses; 20 Lines; 5 Static Generators
Active load: 2.24 p.u.; Reactive load: 0.95 p.u.
-> Data check results:
ACED: ACOPF
DCED: DCOPF, ED, RTED
DCUC: UC
DED: DOPF
PF: DCPF, PFlow, CPF, PFlow0, DCPF0

AMS JSON¶

In [ ]:

sp_json = ams.load(ams.get_case('ieee14/ieee14.json'),
                   setup=True,
                   no_output=True,)

sp_json.summary()

Parsing input file "/Users/jinningwang/work/miniconda3/envs/amsre/lib/python3.12/site-packages/ams/cases/ieee14/ieee14.json"...
Input file parsed in 0.0015 seconds.
Zero line rates detacted in rate_c, adjusted to 999.
System set up in 0.0014 seconds.
-> Systen size:
Base: 100 MVA; Frequency: 60 Hz
14 Buses; 20 Lines; 5 Static Generators
Active load: 2.24 p.u.; Reactive load: 0.95 p.u.
-> Data check results:
PF: DCPF, PFlow, CPF, PFlow0, DCPF0

MATPOWER¶

In [5]:

sp_mp = ams.load(ams.get_case('matpower/case14.m'),
                 setup=True,
                 no_output=True,)

sp_mp.summary()

Parsing input file "/Users/jinningwang/work/miniconda3/envs/amsre/lib/python3.12/site-packages/ams/cases/matpower/case14.m"...
Input file parsed in 0.0029 seconds.
Zero line rates detacted in rate_a, rate_b, rate_c, adjusted to 999.
System set up in 0.0014 seconds.
-> Systen size:
Base: 100.0 MVA; Frequency: 60 Hz
14 Buses; 20 Lines; 5 Static Generators
Active load: 2.59 p.u.; Reactive load: 0.74 p.u.
-> Data check results:
ACED: ACOPF
DCED: DCOPF
DED: DOPF
PF: DCPF, PFlow, CPF, PFlow0, DCPF0

Note that AMS also supports PYPOWER format py-file.

PSS/E RAW¶

AMS also supports PSS/E RAW format for power flow analysis.

In [6]:

sp_raw = ams.load(ams.get_case('ieee14/ieee14.raw'),
                  setup=True,
                  no_output=True,)

sp_raw.summary()

Parsing input file "/Users/jinningwang/work/miniconda3/envs/amsre/lib/python3.12/site-packages/ams/cases/ieee14/ieee14.raw"...
Input file parsed in 0.0046 seconds.
Zero line rates detacted in rate_c, adjusted to 999.
System set up in 0.0016 seconds.
-> Systen size:
Base: 100.0 MVA; Frequency: 60.0 Hz
14 Buses; 20 Lines; 5 Static Generators
Active load: 2.24 p.u.; Reactive load: 0.95 p.u.
-> Data check results:
PF: DCPF, PFlow, CPF, PFlow0, DCPF0

Output¶

Vice versa, AMS supports multiple output formats.

In [7]:

ams.io.xlsx.write(system=sp_xlsx,
                  outfile='out.xlsx',)

xlsx file written to "out.xlsx"

Out[7]:

True

In [8]:

os.remove('out.xlsx')

Similarly, JSON output formats can be achieved by using ams.io.json.write.