reference
API Reference › Gamry DTA Files
labkit.dta.getCurveXY
Extract paired X and Y data from a parsed CV/CT curve.
Syntax
[x, y, xname, yname] = labkit.dta.getCurveXY(curve, xsel, ysel)Description
Looks up two headers using case-sensitive, exact-name matching. Rows where either selected column is NaN are removed from both outputs so x and y remain paired. Use getColumn when case-insensitive lookup or unfiltered data is required.
Inputs
curve- Scalar parsed curve structure with headers and data fields.
xsel- Character vector or string scalar matching one header exactly.
ysel- Character vector or string scalar matching one header exactly.
Outputs
x- Numeric column vector for xsel, with paired NaN rows removed.
y- Numeric column vector for ysel, with paired NaN rows removed.
xname- Matched header character vector, or '' when lookup fails.
yname- Matched header character vector, or '' when lookup fails.
Failure Behavior
If either exact header is absent, all numeric outputs remain empty and unmatched names are ''. curve must expose corresponding headers and data fields; malformed structures raise the originating MATLAB error.
Typical Call
[voltageV, currentA, xname, yname] = ...
labkit.dta.getCurveXY(curve, "Vf", "Im");Related APIs
labkit.dta.getColumn— Extract a named column from a parsed DTA table.labkit.dta.loadFile— Read one supported Gamry DTA file.labkit.dta.detectPulses— Locate cathodic and anodic pulse windows in chrono data.labkit.dta.detectType— Identify the supported Gamry DTA data family in a file.labkit.dta.findFiles— Find DTA files in a folder and its subfolders.labkit.dta.getMainCurve— Select the transient table containing T, Vf, and Im data.labkit.dta.getZCurve— Select the impedance table from parsed EIS data.labkit.dta.loadFiles— Read a list of Gamry DTA files.
Source
This page is generated from the MATLAB help text in +labkit/+dta/getCurveXY.m.