# DriveResult

Soil characterization and capacities from one drive-model run.

Usage

[Source](https://github.com/lornearnold/driven-pile/blob/main/src/driven_pile/results.py#L13-L154)

``` python
DriveResult(
    elevation,
    depth,
    sigma_v0,
    bpf,
    fines,
    phi,
    n160,
    csr,
    crr15,
    cycles_to_liq,
    felt_arrival,
    felt,
    ru,
    ru_toe,
    liquefied,
    liq_when,
    reason,
    fs_eod,
    fs_ltc,
    target,
    raw_capacity,
    predicted,
    top_phi,
    n_top,
    eod_capacity,
    ltc,
    ltc_shaft,
    toe_eod,
    rms_kips,
    pile,
    options,
    pile_id=None,
)
```

Per-foot arrays run over the analysis grid, top down, including the unlogged top segment.

## Attributes

`elevation: ndarray`  
Elevation of each foot, ft.

`depth: ndarray`  
Depth of each foot below the ground surface, ft.

`sigma_v0: ndarray`  
Static vertical effective stress, ksf.

`bpf: ndarray`  
Blows per foot.

`fines: ndarray`  
Fines content, percent.

`phi: ndarray`  
Friction angle, deg; NaN where the foot was not characterized.

`n160: ndarray`  
Equivalent corrected blow count.

`csr: ndarray`  
Cyclic stress ratio of a hammer blow.

`crr15: ndarray`  
Cyclic resistance ratio at 15 cycles.

`cycles_to_liq: ndarray`  
Blows to liquefaction.

`felt_arrival: ndarray`  
Blows felt before the toe reached the foot.

`felt: ndarray`  
Blows felt by the end of the drive.

`ru: ndarray`  
Pore-pressure ratio of each foot at the end of the drive.

`ru_toe: ndarray`  
Pore-pressure ratio applied to the toe stress when the foot was characterized.

`liquefied: ndarray`  
True where the foot liquefied.

`liq_when: ndarray`  
"before", "during" or "after" the toe's arrival, or "" if never.

`reason: ndarray`  
Outcome code of each foot's characterization.

`fs_eod: ndarray`  
Unit shaft resistance at the end of the drive, ksf.

`fs_ltc: ndarray`  
Unit shaft resistance after pore-pressure dissipation, ksf.

`target: ndarray`  
Capacity target, kips.

`raw_capacity: ndarray`  
Per-foot capacity from the dynamic formula before smoothing, kips; NaN on the top segment.

`predicted: ndarray`  
Modeled capacity at the time of driving, kips.

`top_phi: float`  
Friction angle assigned to the top segment, deg; NaN if there is no top segment.

`n_top: int`  
Number of feet in the top segment.

`eod_capacity: float`  
Modeled capacity at the final foot, kips.

`ltc: float`  
Long-term capacity, kips.

`ltc_shaft: float`  
Long-term shaft resistance, kips.

`toe_eod: float`  
Toe resistance at the end of the drive, kips.

`rms_kips: float`  
Root-mean-square of `predicted - target` over the logged feet.

`pile: Pile`  
Pile used for the run.

`options: ModelOptions`  
Options used for the run.

`pile_id: (str, optional)`  
Identifier of the pile.