Struct DataRow 

pub struct DataRow {

    pub id: String,
    pub time: f64,
    pub evid: i32,
    pub dose: Option<f64>,
    pub dur: Option<f64>,
    pub addl: Option<i64>,
    pub ii: Option<f64>,
    pub input: Option<InputLabel>,
    pub out: Option<f64>,
    pub outeq: Option<OutputLabel>,
    pub cens: Option<Censor>,
    pub c0: Option<f64>,
    pub c1: Option<f64>,
    pub c2: Option<f64>,
    pub c3: Option<f64>,
    pub covariates: HashMap<String, f64>,
}

A format-agnostic representation of one input row.

DataRow collects the canonical fields needed to turn one external row into one or more Event values.

Build this type from your own column mapping or external schema, then call DataRow::into_events or [build_data] to assemble subjects and datasets.

A single row can expand into several events when ADDL and II are both present.

Fields

All fields use the public labeling conventions:

• input and outeq preserve the route and output labels from the source data
• evid: 0=observation, 1=dose, 4=reset/new occasion
• addl: positive=forward in time, negative=backward in time

Example

use pharmsol::data::parser::DataRow;

let obs = DataRow::builder("pt1", 1.0)
    .evid(0)
    .out(25.5)
    .outeq("cp")
    .build();

let dose = DataRow::builder("pt1", 0.0)
    .evid(1)
    .dose(100.0)
    .input("iv")
    .addl(-10)
    .ii(12.0)
    .build();

let events = dose.into_events().unwrap();
assert_eq!(obs.outeq.as_ref().map(|label| label.as_str()), Some("cp"));
assert_eq!(events.len(), 11);

Fields

id: String

Subject identifier (required)

time: f64

Event time (required)

evid: i32

Event type: 0=observation, 1=dose, 4=reset/new occasion

dose: Option<f64>

Dose amount (for EVID=1)

dur: Option<f64>

Infusion duration (if > 0, dose is infusion; otherwise bolus)

addl: Option<i64>

Additional doses count (positive=forward, negative=backward in time)

ii: Option<f64>

Interdose interval for ADDL

input: Option<InputLabel>

Input route label

out: Option<f64>

Observed value (for EVID=0)

outeq: Option<OutputLabel>

Output label

cens: Option<Censor>

Censoring indicator

c0: Option<f64>

Error polynomial coefficients

c1: Option<f64>

Error polynomial coefficients

c2: Option<f64>

Error polynomial coefficients

c3: Option<f64>

Error polynomial coefficients

covariates: HashMap<String, f64>

Covariate values at this time point

Implementations

impl DataRow

pub fn builder(id: impl Into<String>, time: f64) -> DataRowBuilder

Create a builder for constructing one DataRow.

Arguments

• id - Subject identifier
• time - Event time

Example

use pharmsol::data::parser::DataRow;

let row = DataRow::builder("patient_001", 0.0)
    .evid(1)
    .dose(100.0)
    .input("depot")
    .build();

pub fn into_events(self) -> Result<Vec<Event>, DataError>

Convert this row into one or more Event values.

This method performs the row-level translation logic:

• EVID interpretation (0=observation, 1=dose, 4=reset)
• ADDL/II expansion (both positive and negative directions)
• Infusion vs bolus detection based on DUR
• Censoring and error polynomial handling
• Preservation of public input and output labels

ADDL Expansion

When addl and ii are both specified:

• Positive ADDL: Additional doses are placed after the base time
  • Example: time=0, addl=3, ii=12 → doses at 12, 24, 36, then 0
• Negative ADDL: Additional doses are placed before the base time
  • Example: time=0, addl=-3, ii=12 → doses at -36, -24, -12, then 0

Returns

A vector of Events. A single row may produce multiple events when ADDL is used.

Errors

Returns [DataError] if required fields are missing for the given EVID:

• EVID=0: Requires outeq
• EVID=1: Requires dose and input; if dur > 0, it’s an infusion

Example

use pharmsol::data::parser::DataRow;

let row = DataRow::builder("pt1", 0.0)
    .evid(1)
    .dose(100.0)
    .input("iv")
    .addl(2)
    .ii(24.0)
    .build();

let events = row.into_events().unwrap();
assert_eq!(events.len(), 3);

let times: Vec<f64> = events.iter().map(|e| e.time()).collect();
assert_eq!(times, vec![24.0, 48.0, 0.0]);

pub fn covariates(&self) -> &HashMap<String, f64>

Get the covariate values for this row

Returns a reference to the HashMap of covariate name → value pairs.

pub fn is_occasion_reset(&self) -> bool

Check if this row represents a new occasion (EVID=4)

pub fn id(&self) -> &str

Get the subject ID

pub fn time(&self) -> f64

Get the event time

Trait Implementations

impl Clone for DataRow

fn clone(&self) -> DataRow

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for DataRow

fn fmt(&self, f: &mut Formatter<'_>) -> Result<(), Error>

Formats the value using the given formatter.

impl Default for DataRow

fn default() -> DataRow

Returns the “default value” for a type.