cape.writell: Collect CAPE line load databooks

This module provides tools to combine the individual-case line load files from a CAPE “databook” (which are extracted using a command like pyfun --ll) into a single .mat file.

Versions:

• 2021-02-10 @ddalle: Version 1.0 (executable)

• 2021-09-30 @ddalle: Version 1.0 (module)

cape.writell.genr8_dbcolnames(dbi, comp=None)

Translate column names from one case line load

Call:

>>> dbcols = genr8_llcolnames(dbi, comp=None)

Inputs:

dbi: DataKit

DataKit read from single-case CAPE line load data file

comp: {None} | str

Optional prefix for combined line load column names (e.g. shift "CN" to "CORE.dCN" instead of just "dCN")

Outputs:

dbcols: dict[str]

List of prefixed line load column names

Versions:

• 2021-02-10 @ddalle: Version 1.0

cape.writell.genr8_ll_datakit(cntl, comp)

Create datakit from run matrix of CAPE line load files

Call:

>>> db = genr8_ll_datakit(cntl, comp)

Inputs:

cntl: cape.Cntl

CAPE control class instance

comp: str

Name of "LineLoad" component to read using cntl

Outputs:

db: None | cape.attdb.dbll.DBLL

Line load database read from pyfun --ll data if possible

Versions:

• 2021-02-10 @ddalle: Version 1.0

cape.writell.genr8_llcolnames(dbi, comp=None)

Generate names of line load columns from one case line load

Call:

>>> llcols = genr8_llcolnames(dbi, comp=None)

Inputs:

dbi: DataKit

DataKit read from single-case CAPE line load data file

comp: {None} | str

Optional prefix for combined line load column names (e.g. shift "CN" to "CORE.dCN" instead of just "dCN")

Outputs:

llcols: list[str]

List of prefixed line load column names

Versions:

• 2021-02-10 @ddalle: Version 1.0

cape.writell.main()

Command-line interface to cape-writell

Call:

>>> main()

Versions:

• 2021-02-10 @ddalle: Version 1.0

cape.writell.write_ll_datakit(cntl, comp)

Write .mat file of combined line loads

The output file is in the "DataBook" folder of cntl with a name like lineload/lineload_%(comp)s.mat.

Call:

>>> db = genr8_ll_datakit(cntl, comp)

Inputs:

cntl: cape.Cntl

CAPE control class instance

comp: str

Name of "LineLoad" component to read using cntl

Outputs:

db: None | cape.attdb.dbll.DBLL

Line load database read from pyfun --ll data if possible

Versions:

• 2021-02-10 @ddalle: Version 1.0