labkit.dta.getZCurve

Description

First selects a table named ZCURVE. If that name is absent, selects the first table whose headers include Freq, Zreal, and Zimag, using case-insensitive comparisons.

Inputs

tables

Structure array of parsed DTA tables. Each element is expected to contain name, headers, and data fields.

Outputs

curve

Selected impedance table structure, or an empty structure on failure.

ok

Logical scalar indicating whether a table was selected.

msg

Character vector naming the selected table or stating that a ZCURVE table was not found.

Failure Behavior

Empty input or no impedance table returns curve=struct(), ok=false, and a diagnostic message. Nonempty elements must expose name and headers fields; malformed table structures raise the originating MATLAB field-access error.

Typical Call

[curve, ok, msg] = labkit.dta.getZCurve(item.tables);
if ok
frequencyHz = labkit.dta.getColumn(curve, "Freq");
end