columna API reference - v0.3.0
    Preparing search index...

    Class DataFrame<S>

    Type Parameters

    Index
    acf adfTest altRegression ancova anova anovaTwoWay antiJoin arima assign autoArima autoModel bestSubsets between bfill boxplotStats capability capabilitySixpack cart chi2test clusterVariables col collect collectWithReport controlChart corr corrTest cov coxPH crossJoin crossValidate cusum decompose describe descriptiveStats drop dropNull dunnett engine equalVariances equivalence ets ewma exclude expanding explain explode ffill fillNull filter fineGray fisher fittedLine friedman fromArrow fromArrowIpc fromArrowLike fromColumns fromCSV fromCSVRows fromCSVUrl fromJSON fromRows fullJoin gageRR gamesHowell gChart getColumn getRuntime glm glmm graphicalSummary groupBy head hsu individualDistributionID innerJoin interactionPlot interpolate intervalPlot isNull itemAnalysis join joinAsof kaplanMeier kmeans kpssTest kruskal ksTwoSample lasso lazy leftJoin lifeRegression limit linearModel logistic logRank mainEffectsPlot mannWhitney manova manovaModel melt mewma mixedModel mlogit mood multipleCorrespondence nestedAnova nls normalityTest notNull nunique ologit orthogonalRegression outerJoin outlierTest pareto partialCorr pca periodogram persist pipe pivot pls poissonGof powerLawNHPP print probitAnalysis profile propTest randomForest readArrowIpc readCsv readCsvRows readDatabase readExcel readFile readJson readKafka readParquet readSql regress reliabilityFit rename ridge rightJoin rolling runChart runsTest sample select selectDtypes selectNumeric semiJoin show signTest slice sort stabilityStudy stepwise stl t2Chart tail take tChart toArray toArrow toArrowIpc toArrowLike toBlob toCsv toHTML toleranceInterval toMarkdown transpose trendAnalysis ttest tukey unique unnest unpersist valueCounts varTest where wilcoxon withColumn withColumns withRuntime withWindow writeArrowIpc writeCsv writeParquet writeParquetLike ztest
    table: TableView
    • get columns(): string[]

      Returns string[]

    • get dtypes(): Record<string, DType>

      Returns Record<string, DType>

    • get shape(): [number, number]

      Returns [number, number]

    • Sample ACF.

      Parameters

      • column: string
      • Optionaloptions: { confidence?: number; maxLag?: number }

      Returns AcfResult

    • Augmented Dickey–Fuller unit-root test on a series column.

      Parameters

      • column: string
      • Optionaloptions: { lags?: number; regression?: "c" | "ct" | "n" }

      Returns UnitRootResult

    • Accelerated life testing on a stress column.

      Parameters

      • time: string
      • stress: string
      • Optionaloptions: {
            censor?: string;
            confidence?: number;
            distribution?: LifeDistribution;
            percentiles?: number[];
            relation?: AccelerationRelation;
            useStress?: number;
        }

      Returns AltResult

    • One-way ANCOVA: y by group adjusting for covariate.

      Parameters

      • y: string
      • group: string
      • covariate: string

      Returns AncovaResult

    • One-way ANOVA of column across the levels of by (Minitab One-Way ANOVA).

      Parameters

      • column: string
      • by: string

      Returns AnovaResult

    • Two-way ANOVA Type III via anovaTwoWay.

      Parameters

      • y: string
      • row: string
      • col: string
      • Optionaloptions: { interaction?: boolean }

      Returns AnovaTwoWayResult

    • ARIMA / SARIMA / ARIMAX via CSS-ML.

      Parameters

      • column: string
      • Optionaloptions: {
            d?: number;
            horizon?: number;
            includeMean?: boolean;
            method?: "CSS" | "CSS-ML" | "ML";
            p?: number;
            q?: number;
            seasonal?: { D?: number; P?: number; period: number; Q?: number };
            xreg?: string[];
        }

      Returns ArimaResult

    • Auto-ARIMA (stepwise AIC/BIC).

      Parameters

      • column: string
      • Optionaloptions: {
            horizon?: number;
            information?: "aic" | "bic";
            maxD?: number;
            maxP?: number;
            maxQ?: number;
            seasonalPeriod?: number;
        }

      Returns ArimaResult

    • Automated model selection over the tree learners (+ OLS / logistic).

      Parameters

      • y: string
      • predictors: string[]
      • Optionaloptions: {
            folds?: number;
            models?: ModelKind[];
            nTrees?: number;
            seed?: number;
            task?: "regression" | "classification";
        }

      Returns AutoModelResult

    • Best Subsets over the predictor columns.

      Parameters

      • y: string
      • predictors: string[]
      • Optionaloptions: { include?: string[]; maxK?: number; nBest?: number }

      Returns BestSubsetsResult

    • Parameters

      • column: keyof S & string
      • low: string | number
      • high: string | number

      Returns LazyFrame<S>

    • Parameters

      • Optionalcolumns: string[]

      Returns LazyFrame<S>

    • Boxplot statistics, optionally per level of by.

      Parameters

      • column: string
      • Optionalby: string

      Returns BoxplotStats | BoxplotStats[]

    • Process capability (normal) of a column.

      Parameters

      • column: string
      • options: {
            confidence?: number;
            lsl?: number;
            method?: "r" | "s";
            subgroup?: number;
            target?: number;
            usl?: number;
        }

      Returns CapabilityResult

    • Capability Sixpack plot-ready panels.

      Parameters

      • column: string
      • options: {
            confidence?: number;
            lsl?: number;
            method?: "r" | "s";
            subgroup?: number;
            target?: number;
            usl?: number;
        }

      Returns CapabilitySixpackResult

    • CART on predictors → response.

      Parameters

      • y: string
      • predictors: string[]
      • Optionaloptions: CartOptions

      Returns CartResult

    • Chi-square test of independence between two categorical columns.

      Parameters

      • a: string
      • b: string
      • Optionaloptions: { correction?: boolean }

      Returns Chi2Result

    • Cluster Variables (correlation-distance hierarchical clustering).

      Parameters

      • columns: string[]
      • Optionaloptions: {
            distance?: "correlation" | "absolute correlation";
            method?: "average" | "single" | "complete" | "ward";
            nClusters?: number;
        }

      Returns ClusterVariablesResult

    • Alias of getColumn.

      Type Parameters

      • K extends string

      Parameters

      • name: K

      Returns Series<Cell<S[K]>>

    • Correlation between two columns with p-value and CI.

      Parameters

      • a: string
      • b: string
      • Optionaloptions: {
            alternative?: Alternative;
            confidence?: number;
            method?: "pearson" | "spearman" | "kendall";
        }

      Returns CorrTestResult

    • Parameters

      • Optionaloptions: { columns?: string[] }

      Returns LazyFrame<Row>

    • Cox PH regression; predictors are numeric columns.

      Parameters

      • time: string
      • predictors: string[]
      • Optionaloptions: {
            cause?: string | number;
            censor?: string;
            cluster?: string;
            confidence?: number;
            eventType?: string;
            frailtyBands?: string;
            frailtyGroup?: string;
            frailtyProcess?: "piecewise" | "ar1";
            start?: string;
            strata?: string;
        }

      Returns CoxPHResult

    • k-fold cross-validation of a learner on predictor columns → response.

      Parameters

      • y: string
      • predictors: string[]
      • options: {
            folds?: number;
            model: ModelKind;
            nTrees?: number;
            seed?: number;
            task?: "regression" | "classification";
        }

      Returns CvResult

    • Tabular CUSUM chart.

      Parameters

      • column: string
      • Optionaloptions: { h?: number; k?: number; mu?: number; sigma?: number; vMask?: boolean }

      Returns CusumResult

    • Classical seasonal decomposition.

      Parameters

      • column: string
      • options: { method?: "additive" | "multiplicative"; seasonLength: number }

      Returns DecompositionResult

    • Sync describe on a materialized frame (LazyFrame.describe stays lazy).

      Parameters

      • Optionaloptions: { quantileMethod?: QuantileMethod }

      Returns DataFrame<Row>

    • Display Descriptive Statistics for one or more columns, optionally by a grouping column.

      Parameters

      • columns: string | string[]
      • Optionaloptions: { by?: string }

      Returns DescriptiveStats[]

    • Type Parameters

      • K extends string

      Parameters

      • ...columns: K[]

      Returns LazyFrame<{ [K in string | number | symbol]: Omit<S, K>[K] }>

    • Parameters

      • Optionalcolumns: string[]

      Returns LazyFrame<S>

    • Dunnett comparisons of every level of by against control.

      Parameters

      • column: string
      • by: string
      • options: { alpha?: number; alternative?: Alternative; control: string }

      Returns DunnettResult

    • Test for equal variances: Levene / Brown–Forsythe (default, as Minitab), Bartlett, or Bonett.

      Parameters

      • column: string
      • by: string
      • Optionalmethod: "levene" | "bartlett" | "bonett"

      Returns VarianceTestResult

    • Equivalence test (TOST): one-sample by default, two-sample with by (test level − reference level, pass reference to name it), paired with paired.

      Parameters

      • column: string
      • options: {
            alpha?: number;
            by?: string;
            equalVar?: boolean;
            limits: [number, number];
            paired?: string;
            reference?: string;
        }

      Returns TostResult

    • Exponential smoothing (SES / DES / Winters).

      Parameters

      • column: string
      • Optionaloptions: {
            horizon?: number;
            method?: "ses" | "des" | "winters-add" | "winters-mul";
            seasonLength?: number;
        }

      Returns EtsResult

    • EWMA chart.

      Parameters

      • column: string
      • Optionaloptions: { L?: number; lambda?: number; mu?: number; sigma?: number }

      Returns EwmaResult

    • Type Parameters

      • K extends string

      Parameters

      • ...columns: K[]

      Returns LazyFrame<{ [K in string | number | symbol]: Omit<S, K>[K] }>

    • Type Parameters

      • N extends string

      Parameters

      • name: N
      • column: keyof S & string
      • Optionalagg: AggKind

      Returns LazyFrame<
          { [K in string
          | number
          | symbol]: (Omit<S, N> & Record<N, number>)[K] },
      >

    • Returns string

    • Parameters

      • column: string

      Returns LazyFrame<Row>

    • Parameters

      • Optionalcolumns: string[]

      Returns LazyFrame<S>

    • Parameters

      • value: string | number | boolean
      • Optionalcolumns: string[]

      Returns LazyFrame<S>

    • Parameters

      • map: Record<string, number | string | boolean>

      Returns LazyFrame<S>

    • Parameters

      • predicate: ExprOrFn<S, Expr<boolean, any>>

      Returns LazyFrame<S>

    • Fine–Gray competing risks.

      Parameters

      • time: string
      • predictors: string[]
      • options: {
            cause: string | number;
            censor?: string;
            confidence?: number;
            eventType: string;
        }

      Returns FineGrayResult

    • Fisher LSD pairwise comparisons (individual error rate).

      Parameters

      • column: string
      • by: string
      • Optionaloptions: { alpha?: number }

      Returns FisherResult & { familyAlpha: number }

    • Fitted Line Plot: polynomial (degree 1–3) regression of y on x with the fitted curve.

      Parameters

      • x: string
      • y: string
      • Optionaloptions: { confidence?: number; degree?: 2 | 1 | 3; logX?: boolean; logY?: boolean }

      Returns OlsResult & { degree: number; equation: string; curve(x: number): number }

    • Friedman test: column by treatment within block (one observation per cell).

      Parameters

      • column: string
      • treatment: string
      • block: string

      Returns FriedmanResult

    • Type Parameters

      Parameters

      Returns DataFrame<S>

      Takes columna's ArrowLike JSON, not Apache Arrow. Use fromArrowIpc() for real Arrow bytes or fromArrowLike().

    • Parse Apache Arrow IPC bytes (stream or file format) — e.g. tableToIPC(table) from apache-arrow, a DuckDB arrow() result, pyarrow / Polars output. Int8…Int64, UInt8…UInt64, Float16/32/64, Bool, Utf8, LargeUtf8, Timestamp (any unit), Date32/64, Null and dictionary-encoded strings are accepted; nested, decimal, binary and compressed batches throw with the column name. S is an assertion, not verified.

      Type Parameters

      Parameters

      • bytes: ArrayBuffer | Uint8Array<ArrayBufferLike>

      Returns DataFrame<S>

    • Type Parameters

      • C extends Record<
            string,
            | readonly (string | number | boolean | Date | null)[]
            | Float64Array<ArrayBufferLike>
            | Float32Array<ArrayBufferLike>
            | Int32Array<ArrayBufferLike>
            | Uint32Array<ArrayBufferLike>
            | Uint8Array<ArrayBufferLike>
            | { codes: Uint32Array; dictionary: string[] },
        >

      Parameters

      • cols: C
      • Optionaloptions: { copy?: boolean }

      Returns DataFrame<
          {
              [K in string
              | number
              | symbol]: { [K in string | number | symbol]: ColumnValue<C[K]> }[K]
          },
      >

    • Parse CSV text. S is an assertion about the file, not something the compiler can verify.

      Type Parameters

      Parameters

      Returns DataFrame<S>

    • Parameters

      Returns DataFrame

      internal: previous row-object implementation of fromCSV, kept for parity tests.

    • Build a frame from row objects. The schema is the union of the keys of every row, in order of first appearance (a key missing from a row reads as null); dtypes are inferred over the whole column, so a late fractional / out-of-Int32 / string value widens the column instead of being coerced.

      Type Parameters

      Parameters

      • rows: readonly T[]

      Returns DataFrame<T>

    • Type Parameters

      Parameters

      Returns LazyFrame<{ [K in string | number | symbol]: (Nullable<S> & Nullable<R>)[K] }>

    • Gage R&R (ANOVA) with part / operator / measurement columns.

      Parameters

      • options: {
            design?: "crossed" | "nested";
            measurement: string;
            operator?: string;
            part: string;
        }

      Returns GageRRResult

    • Games–Howell pairwise comparisons.

      Parameters

      • column: string
      • by: string
      • Optionaloptions: { alpha?: number }

      Returns GamesHowellResult

    • G chart (opportunities between events) on a count column.

      Parameters

      • column: string
      • Optionaloptions: { alpha?: number; estimator?: "mle" | "mvue"; limits?: "probability" | "sigma" }

      Returns RareEventChartResult

    • Type Parameters

      • K extends string

      Parameters

      • name: K

      Returns Series<Cell<S[K]>>

    • The runtime plans derived from this frame execute on.

      Returns Runtime

    • Generalized linear model; family: 'binomial' is Binary Logistic, 'poisson' Poisson Regression. trials / offset / weights name columns.

      Parameters

      • y: string
      • predictors: string[]
      • options: Omit<GlmOptions, "names" | "weights" | "trials" | "offset"> & {
            offset?: string;
            trials?: string;
            weights?: string;
        }

      Returns GlmResult

    • GLMM (binomial/Poisson/negbin) with random intercept (+ optional slope).

      Parameters

      • y: string
      • options: {
            confidence?: number;
            family: "binomial" | "poisson" | "negbin";
            fixed: string[];
            group: string;
            method?: "pql" | "laplace" | "agq";
            nAGQ?: number;
            slope?: string;
            trials?: string;
        }

      Returns GlmmResult

    • Graphical Summary: descriptives, Anderson–Darling, CIs, histogram and boxplot data.

      Parameters

      • column: string
      • Optionaloptions: { bins?: number; confidence?: number }

      Returns GraphicalSummary

    • Type Parameters

      • K extends string

      Parameters

      • ...keys: K[]

      Returns GroupBy<S, K>

    • Sync peek — returns a materialized frame (LazyFrame.head stays lazy).

      Parameters

      • Optionaln: number

      Returns DataFrame<S>

    • Hsu's multiple comparisons with the best.

      Parameters

      • column: string
      • by: string
      • Optionaloptions: { alpha?: number; best?: "largest" | "smallest" }

      Returns HsuResult

    • Individual Distribution Identification on a column.

      Parameters

      • column: string

      Returns IdResult

    • Type Parameters

      Parameters

      Returns LazyFrame<{ [K in string | number | symbol]: (S & R)[K] }>

    • Interaction plot data (cell means) for two factor columns.

      Parameters

      • y: string
      • a: string
      • b: string

      Returns InteractionPlot

    • Parameters

      • Optionalcolumns: string[]

      Returns LazyFrame<S>

    • Interval plot data: group means with confidence intervals.

      Parameters

      • column: string
      • by: string
      • Optionaloptions: { confidence?: number; pooled?: boolean }

      Returns IntervalPlotRow[]

    • Parameters

      • column: keyof S & string

      Returns LazyFrame<S>

    • Item Analysis (Cronbach's α) over item columns.

      Parameters

      • columns: string[]

      Returns ItemAnalysisResult

    • Type Parameters

      Parameters

      • other: LazyFrame<R> | DataFrame<R>
      • Optionaloptions: {
            how?: How;
            leftOn?: string | string[];
            lSuffix?: string;
            on?: string | string[];
            rightOn?: string | string[];
            rSuffix?: string;
            suffix?: string;
            validate?: "1:1" | "1:m" | "m:1";
        }

      Returns LazyFrame<JoinResult<S, R, How>>

    • Type Parameters

      Parameters

      • other: LazyFrame<R> | DataFrame<R>
      • options: {
            leftOn: string;
            rightOn?: string;
            strategy?: "backward" | "forward" | "nearest";
        }

      Returns LazyFrame<{ [K in string | number | symbol]: (S & Nullable<R>)[K] }>

    • Kaplan–Meier estimate.

      Parameters

      • time: string
      • Optionaloptions: { censor?: string; confidence?: number }

      Returns KaplanMeierResult

    • k-means on the named numeric columns.

      Parameters

      • columns: string[]
      • options: { k: number; maxIter?: number; seed?: number }

      Returns KMeansResult

    • KPSS stationarity test on a series column.

      Parameters

      • column: string
      • Optionaloptions: { lags?: number; regression?: "c" | "ct" }

      Returns UnitRootResult

    • Kruskal–Wallis test across the levels of by.

      Parameters

      • column: string
      • by: string

      Returns KruskalResult

    • Two-sample Kolmogorov–Smirnov between the two levels of by.

      Parameters

      • column: string
      • by: string

      Returns KsTwoSampleResult

    • Lasso regression of y on predictor columns.

      Parameters

      • y: string
      • predictors: string[]
      • Optionaloptions: { alpha?: number; maxIter?: number; tol?: number }

      Returns PenalizedResult

    • Type Parameters

      Parameters

      Returns LazyFrame<{ [K in string | number | symbol]: (S & Nullable<R>)[K] }>

    • Regression with life data (AFT) with optional censor column (0 exact, 1 right, 2 left, 3 interval + time2).

      Parameters

      • time: string
      • predictors: string[]
      • Optionaloptions: {
            censor?: string;
            confidence?: number;
            distribution?: LifeDistribution;
            time2?: string;
        }

      Returns LifeRegressionResult

    • Parameters

      • n: number
      • Optionaloffset: number

      Returns LazyFrame<S>

    • General Linear Model from a formula over the columns: df.linearModel('y ~ a*b + x').

      Parameters

      • formula: string
      • Optionaloptions: { confidence?: number; factors?: string[] }

      Returns LinearModelResult

    • Binary Logistic Regression (glm with the binomial family).

      Parameters

      • y: string
      • predictors: string[]
      • Optionaloptions: Omit<GlmOptions, "names" | "weights" | "trials" | "offset" | "family"> & {
            offset?: string;
            trials?: string;
            weights?: string;
        }

      Returns GlmResult

    • Mantel–Haenszel / Wilcoxon / Tarone–Ware log-rank across levels of group.

      Parameters

      • time: string
      • group: string
      • Optionaloptions: {
            censor?: string;
            strata?: string;
            weight?: "logrank" | "wilcoxon" | "tarone-ware";
        }

      Returns LogRankResult

    • Main effects plot data for several factor columns.

      Parameters

      • y: string
      • factors: string[]

      Returns MainEffectsPlot

    • One-way MANOVA on response columns by group.

      Parameters

      • responses: string[]
      • by: string

      Returns ManovaResult

    • General MANOVA: responses on a model formula right-hand side, e.g. 'a*b + x'.

      Parameters

      • responses: string[]
      • rhs: string
      • Optionaloptions: { factors?: string[] }

      Returns ManovaModelResult

    • Parameters

      • options: { idVars: string[]; valueName?: string; valueVars: string[]; varName?: string }

      Returns LazyFrame<Row>

    • MEWMA chart on several columns.

      Parameters

      • columns: string[]
      • Optionaloptions: { arl0?: number; h?: number; lambda?: number }

      Returns MewmaResult

    • Random-intercept (+ optional slope / nested) linear mixed model.

      Parameters

      • y: string
      • options: {
            confidence?: number;
            fixed: string[];
            group: string;
            group2?: string;
            groupNested?: string;
            reml?: boolean;
            slope?: string;
        }

      Returns MixedModelResult

    • Nominal Logistic Regression (multinomial).

      Parameters

      • y: string
      • predictors: string[]
      • Optionaloptions: { confidence?: number; maxIter?: number; reference?: string | number }

      Returns NominalResult

    • Mood's median test across the levels of by.

      Parameters

      • column: string
      • by: string

      Returns MoodResult

    • Multiple Correspondence Analysis of categorical columns.

      Parameters

      • columns: string[]
      • Optionaloptions: { method?: "indicator" | "burt"; nComponents?: number }

      Returns McaResult

    • Fully nested ANOVA.

      Parameters

      • y: string
      • factors: string[]

      Returns NestedAnovaResult

    • Nonlinear regression of column y on column(s) x with a model function and start values.

      Parameters

      Returns NlsResult

    • Normality test: Anderson–Darling (default, as Minitab), Ryan–Joiner, Kolmogorov–Smirnov or Shapiro–Wilk.

      Parameters

      Returns NormalityResult

    • Parameters

      • column: keyof S & string

      Returns LazyFrame<S>

    • Per-column unique counts (sync peek).

      Returns DataFrame<{ column: string; nunique: number }>

    • Ordinal Logistic Regression (proportional odds) of a categorical / integer response.

      Parameters

      • y: string
      • predictors: string[]
      • Optionaloptions: { confidence?: number; maxIter?: number }

      Returns OrdinalResult

    • Orthogonal (Deming) regression of y on x.

      Parameters

      • x: string
      • y: string
      • Optionaloptions: { confidence?: number; errorVarianceRatio?: number }

      Returns OrthogonalResult

    • Type Parameters

      Parameters

      Returns LazyFrame<{ [K in string | number | symbol]: (Nullable<S> & Nullable<R>)[K] }>

    • Outlier test: Grubbs (default) or Dixon.

      Parameters

      • column: string
      • Optionaloptions: {
            alpha?: number;
            alternative?: "min" | "max" | "two-sided";
            method?: "grubbs" | "dixon";
        }

      Returns OutlierResult

    • Pareto of a categorical column.

      Parameters

      • column: string
      • Optionaloptions: { weights?: string }

      Returns ParetoResult

    • Partial correlation controlling for one or more columns.

      Parameters

      • a: string
      • b: string
      • controls: string | string[]
      • Optionaloptions: { alternative?: Alternative; method?: "pearson" | "spearman" }

      Returns PartialCorrResult

    • PCA on the named numeric columns.

      Parameters

      • columns: string[]
      • Optionaloptions: { nComponents?: number; scale?: boolean }

      Returns PcaResult

    • Periodogram / spectral analysis of a series column.

      Parameters

      • column: string
      • Optionaloptions: { detrend?: "mean" | "none" | "linear"; spans?: number[]; taper?: number }

      Returns PeriodogramResult

    • Type Parameters

      • T

      Parameters

      Returns T

    • Parameters

      • options: { agg?: AggKind; columns: string; index: string | string[]; values: string }

      Returns LazyFrame<Row>

    • Partial least squares of one or more response columns on the predictor columns.

      Parameters

      • y: string | string[]
      • predictors: string[]
      • Optionaloptions: Omit<PlsOptions, "names" | "responseNames">

      Returns PlsResult

    • Goodness-of-fit test for Poisson on a column of counts.

      Parameters

      • column: string
      • Optionaloptions: { minExpected?: number }

      Returns PoissonGofResult

    • Power-law NHPP (Crow–AMSAA) on a column of failure times, optionally per system.

      Parameters

      • time: string
      • options: { confidence?: number; endTime: number | number[]; system?: string }

      Returns NhppResult

    • Alias for show.

      Parameters

      • Optionaln: number

      Returns this

    • Probit analysis from events / trials / stress columns.

      Parameters

      • events: string
      • trials: string
      • stress: string
      • Optionaloptions: {
            confidence?: number;
            distribution?: "normal" | "logistic";
            logStress?: boolean;
            naturalResponse?: number;
            percentiles?: number[];
        }

      Returns ProbitResult

    • Returns ProfileReport

    • Random Forest on predictors → response.

      Parameters

      • y: string
      • predictors: string[]
      • Optionaloptions: CartOptions & { nTrees?: number }

      Returns RandomForestResult

    • Read Apache Arrow IPC (stream or file / Feather v2) from a path, URL or bytes under the IO policy.

      Type Parameters

      Parameters

      Returns Promise<DataFrame<S>>

    • Read CSV from a path / URL / bytes / text. S is an assertion about the file, not something the compiler can verify.

      Type Parameters

      Parameters

      Returns Promise<DataFrame<S>>

    • Read from a browser File / Blob (CSV/JSON inferred by name or format).

      Parameters

      • file: Blob & { name?: string }
      • Optionaloptions: { format?: "csv" | "json" | "parquet" | "excel" } & IoPolicy & {
            content?: boolean;
            encoding?: string;
            floors?: IoPolicy[];
            mode?: IoSourceMode;
        } & {
            comment?: string;
            decimal?: string;
            delimiter?: string;
            dtypes?: Record<string, DType>;
            falseValues?: string | string[];
            hasHeader?: boolean;
            header?: number | boolean;
            names?: string[];
            nRows?: number;
            nullValues?: string | string[];
            quoteChar?: string;
            separator?: string;
            skipBlankLines?: boolean;
            skipInitialSpace?: boolean;
            skipRows?: number;
            thousands?: string;
            trueValues?: string | string[];
            usecols?: (string | number)[];
        } & {
            lines?: boolean;
            nRows?: number;
            orient?: "records"
            | "columns"
            | "values"
            | "lines";
            skipRows?: number;
        }
        • Optionalformat?: "csv" | "json" | "parquet" | "excel"
        • Optionalcontent?: boolean

          Treat a string source as raw content, never as a path (alias of mode: 'text').

        • Optionalencoding?: string

          Text encoding when reading bytes/files (default utf-8).

        • Optionalfloors?: IoPolicy[]

          Additional policy floors — a Session's policy, for instance. Every floor is enforced like the process-wide one (each must pass; byte caps and timeouts take the minimum), and per-call fields cannot widen any of them.

        • Optionalmode?: IoSourceMode

          Interpret a bare string as content / path / URL instead of guessing (default 'auto').

        • Optionalcomment?: string

          Lines starting with this prefix are ignored.

        • Optionaldecimal?: string

          Decimal mark (default .).

        • Optionaldelimiter?: string

          Alias of separator (pandas-style).

        • Optionaldtypes?: Record<string, DType>

          Force column dtypes after parse.

        • OptionalfalseValues?: string | string[]

          Values treated as boolean false.

        • OptionalhasHeader?: boolean

          Polars alias for header !== false.

        • Optionalheader?: number | boolean

          First row is header (default true). Number = header row index after skipRows.

        • Optionalnames?: string[]

          Explicit column names (used when header is false, or to override).

        • OptionalnRows?: number

          Max data rows to read (after header).

        • OptionalnullValues?: string | string[]

          Values treated as null.

        • OptionalquoteChar?: string

          Quote character (default ").

        • Optionalseparator?: string

          Column separator (default ,). Alias of delimiter.

        • OptionalskipBlankLines?: boolean

          Skip empty lines (default true).

        • OptionalskipInitialSpace?: boolean

          Trim whitespace after delimiter (default false).

        • OptionalskipRows?: number

          Rows to skip at the start of the file (before header).

        • Optionalthousands?: string

          Thousands separator to strip before parsing numbers.

        • OptionaltrueValues?: string | string[]

          Values treated as boolean true.

        • Optionalusecols?: (string | number)[]

          Keep only these columns (names or 0-based indices).

        • Optionallines?: boolean

          Read newline-delimited JSON (NDJSON). Alias of orient:'lines'.

        • OptionalnRows?: number

          Max records to read.

        • Optionalorient?: "records" | "columns" | "values" | "lines"

          records = array of objects (default); columns = {col: values[]}; lines = NDJSON.

        • OptionalskipRows?: number

          Skip first N lines (NDJSON) or N array elements.

      Returns Promise<DataFrame<Row>>

    • Consume a bounded batch from Kafka into a DataFrame.

      Nested JSON values are flattened to dotted columns by default (user.address.city). Driver: optional peer kafkajs.

      Parameters

      Returns Promise<DataFrame<Row>>

      await DataFrame.readKafka({
      brokers: ['localhost:9092'],
      topic: 'events',
      fromBeginning: true,
      nMessages: 1000,
      })
    • Load a query result from a database (pandas read_sql / polars read_database).

      Built-in dialects: postgres, mssql, clickhouse, mysql, sqlite. Drivers are optional peer packages (pg, mssql, @clickhouse/client, mysql2, better-sqlite3).

      Parameters

      Returns Promise<DataFrame<Row>>

    • Regression (OLS) of y on the predictor columns: coefficient table, ANOVA, R², diagnostics, predict().

      Parameters

      • y: string
      • predictors: string[]
      • Optionaloptions: Omit<OlsOptions, "names" | "weights"> & { weights?: string }

      Returns OlsResult

    • Parametric reliability fit (Weibull / lognormal / exponential).

      Parameters

      • time: string
      • Optionaloptions: {
            censor?: string;
            distribution?: "exponential" | "weibull" | "lognormal";
            method?: "MLE" | "LSXY";
        }

      Returns ParametricSurvival

    • Type Parameters

      • const M extends { [K in string]?: string }

      Parameters

      • mapping: M

      Returns LazyFrame<{ [K in string | number | symbol]: Renamed<S, M>[K] }>

    • Parameters

      • fn: (name: string) => string

      Returns LazyFrame<Row>

    • Ridge regression of y on predictor columns.

      Parameters

      • y: string
      • predictors: string[]
      • Optionaloptions: { alpha?: number }

      Returns PenalizedResult

    • Type Parameters

      Parameters

      Returns LazyFrame<{ [K in string | number | symbol]: (Nullable<S> & R)[K] }>

    • Type Parameters

      • N extends string

      Parameters

      • name: N
      • column: keyof S & string
      • window: number
      • Optionalagg: AggKind

      Returns LazyFrame<
          { [K in string
          | number
          | symbol]: (Omit<S, N> & Record<N, number>)[K] },
      >

    • Run chart tests on a column.

      Parameters

      • column: string
      • Optionaloptions: { alpha?: number }

      Returns RunChartResult

    • Runs test for randomness about the mean (or k).

      Parameters

      • column: string
      • Optionaloptions: { correction?: boolean; k?: number }

      Returns RunsTestResult

    • Parameters

      • Optionaloptions: { fraction?: number; n?: number; seed?: number }

      Returns LazyFrame<S>

    • Type Parameters

      • K extends string

      Parameters

      • ...columns: K[]

      Returns LazyFrame<{ [K in string]: Pick<S, K>[K] }>

    • Type Parameters

      Parameters

      • ...exprs: E

      Returns LazyFrame<
          {
              [K in string
              | number
              | symbol]: UnionToIntersection<
                  {
                      [I in string
                      | number
                      | symbol]: string extends NameOf<E[I]>
                          ? Record<never, never>
                          : Record<NameOf<E[I]>, TypeOf<E[I]>>
                  }[number],
              >[K]
          },
      >

    • Type Parameters

      • const E extends readonly AnyExpr[]

      Parameters

      Returns LazyFrame<
          {
              [K in string
              | number
              | symbol]: UnionToIntersection<
                  {
                      [I in string
                      | number
                      | symbol]: string extends NameOf<E[I]>
                          ? Record<never, never>
                          : Record<NameOf<E[I]>, TypeOf<E[I]>>
                  }[number],
              >[K]
          },
      >

    • Parameters

      • ...columns: (keyof S & string | AnyExpr)[]

      Returns LazyFrame<Row>

    • Print head(n) as markdown to the console; returns this for chaining.

      Parameters

      • Optionaln: number

      Returns this

    • 1-Sample Sign test.

      Parameters

      • column: string
      • Optionaloptions: { alternative?: Alternative; confidence?: number; median?: number }

      Returns SignTestResult

    • Parameters

      • start: number
      • Optionalend: number

      Returns LazyFrame<S>

    • Parameters

      • ...by: (
            | keyof S & string
            | AnyExpr
            | { descending: boolean; expr: AnyExpr; nullsLast?: boolean }
            | ((c: ColRefs<S>) => SortKey | SortKey[])
        )[]

      Returns LazyFrame<S>

    • Stability Study: response vs time with a batch factor; shelf life against spec limits.

      Parameters

      Returns StabilityResult

    • Stepwise / forward / backward selection among the predictor columns.

      Parameters

      • y: string
      • predictors: string[]
      • Optionaloptions: Omit<StepwiseOptions, "names">

      Returns StepwiseResult

    • STL (LOESS) seasonal-trend decomposition.

      Parameters

      • column: string
      • options: {
            robust?: boolean;
            seasonalSpan?: number;
            seasonLength: number;
            trendSpan?: number;
        }

      Returns StlResult

    • Hotelling T² chart on several columns (optionally subgrouped).

      Parameters

      • columns: string[]
      • Optionaloptions: { alpha?: number; phase?: 2 | 1; subgroup?: string }

      Returns T2ChartResult

    • Sync peek from the end — returns a materialized frame.

      Parameters

      • Optionaln: number

      Returns DataFrame<S>

    • Parameters

      • indices: number[]

      Returns LazyFrame<S>

    • T chart (time between events).

      Parameters

      • column: string
      • Optionaloptions: { alpha?: number; distribution?: "exponential" | "weibull" }

      Returns RareEventChartResult

    • Rows as objects, typed by the schema.

      Returns S[]

    • Returns ArrowLike

      Returns columna's ArrowLike JSON, not Apache Arrow. Use toArrowIpc() for real Arrow bytes or toArrowLike().

    • Apache Arrow IPC bytes — the streaming format by default ({ format: 'file' } for Feather v2). Zero-copy consumers: tableFromIPC() of apache-arrow, DuckDB(-Wasm) insertArrowFromIPCStream, pyarrow.ipc, polars.read_ipc_stream, pandas.read_feather (file format). f64/f32/i32/u32/bool/utf8 map 1:1, category → Dictionary<Int32, Utf8>, datetime → Timestamp(ms). Round-trips with DataFrame.fromArrowIpc.

      Parameters

      Returns Uint8Array

    • columna's own JSON columnar form (schema + plain arrays). Not Apache Arrow — see toArrowIpc().

      Returns ArrowLike

    • Parameters

      Returns Blob

    • CSV text. { escapeFormulas: true } neutralises text cells a spreadsheet would run as formulas (leading = + - @ tab CR → "'"-prefixed, quoted) — use it for exports of untrusted text that will be opened in Excel-like applications; the default writes the data unchanged.

      Parameters

      Returns string

    • Parameters

      • OptionalmaxRows: number

      Returns string

    • Tolerance interval for a column.

      Parameters

      • column: string
      • Optionaloptions: { confidence?: number; coverage?: number; method?: "normal" | "nonparametric" }

      Returns ToleranceIntervalResult

    • Parameters

      • OptionalmaxRows: number

      Returns string

    • Parameters

      • OptionalheaderColumn: string

      Returns LazyFrame<Row>

    • Trend Analysis on a time-series column.

      Parameters

      • column: string
      • Optionaloptions: { horizon?: number; model?: "linear" | "quadratic" | "exponential" | "s-curve" }

      Returns TrendResult

    • t-test on a column (Minitab 1-Sample t / 2-Sample t / Paired t): df.ttest('x', { mu: 50 }) // one-sample, H0: mean = 50 df.ttest('x', { by: 'group' }) // two-sample (Welch) between the two levels of group df.ttest('after', { paired: 'before' }) // paired, after − before

      Parameters

      Returns TTestResult

    • Tukey HSD pairwise comparisons across the levels of by.

      Parameters

      • column: string
      • by: string
      • Optionaloptions: { alpha?: number }

      Returns TukeyResult

    • Parameters

      • Optionalcolumns: string[]
      • Optionalkeep: "first" | "last" | "none"

      Returns LazyFrame<S>

    • Parameters

      • column: string
      • Optionalseparator: string

      Returns LazyFrame<Row>

    • Parameters

      • column: string
      • Optionalnormalize: boolean

      Returns LazyFrame<Row>

    • 1 Variance: χ² (default) or Bonett.

      Parameters

      • column: string
      • options: {
            alternative?: Alternative;
            confidence?: number;
            method?: "bonett" | "chi-square";
            sigma0: number;
        }

      Returns VarTest1Result

    • Parameters

      • predicate: ExprOrFn<S, Expr<boolean, any>>

      Returns LazyFrame<S>

    • 1-Sample Wilcoxon signed-rank test.

      Parameters

      • column: string
      • Optionaloptions: {
            alternative?: Alternative;
            confidence?: number;
            median?: number;
            method?: "auto" | "exact" | "asymptotic";
        }

      Returns WilcoxonResult

    • Type Parameters

      • N extends string
      • T

      Parameters

      • name: N
      • expr: ExprOrFn<S, Expr<T, any>>

      Returns LazyFrame<{ [K in string | number | symbol]: (Omit<S, N> & Record<N, T>)[K] }>

    • Type Parameters

      Parameters

      • ...exprs: E

      Returns LazyFrame<
          {
              [K in string
              | number
              | symbol]: (
                  Omit<
                      S,
                      keyof UnionToIntersection<
                          {
                              [I in string
                              | number
                              | symbol]: string extends NameOf<(...)>
                                  ? Record<(...), (...)>
                                  : Record<(...), (...)>
                          }[number],
                      >,
                  > & UnionToIntersection<
                      {
                          [I in string
                          | number
                          | symbol]: string extends NameOf<E[I]>
                              ? Record<never, never>
                              : Record<NameOf<(...)[(...)]>, TypeOf<(...)[(...)]>>
                      }[number],
                  >
              )[K]
          },
      >

    • Type Parameters

      • const E extends readonly AnyExpr[]

      Parameters

      Returns LazyFrame<
          {
              [K in string
              | number
              | symbol]: (
                  Omit<
                      S,
                      keyof UnionToIntersection<
                          {
                              [I in string
                              | number
                              | symbol]: string extends NameOf<(...)>
                                  ? Record<(...), (...)>
                                  : Record<(...), (...)>
                          }[number],
                      >,
                  > & UnionToIntersection<
                      {
                          [I in string
                          | number
                          | symbol]: string extends NameOf<E[I]>
                              ? Record<never, never>
                              : Record<NameOf<(...)[(...)]>, TypeOf<(...)[(...)]>>
                      }[number],
                  >
              )[K]
          },
      >

    • Parameters

      Returns LazyFrame<Row>

    • The same table bound to another runtime (its engine, memory policy and persist() cache) — see Session.

      Parameters

      Returns DataFrame<S>

    • Type Parameters

      • N extends string

      Parameters

      • name: N
      • fn: "rank" | "lag" | "lead" | "cumsum" | "rowNumber"
      • Optionaloptions: {
            expr?: AnyExpr;
            method?: RankMethod;
            offset?: number;
            orderBy?: (string | AnyExpr | { descending: boolean; expr: AnyExpr })[];
            partitionBy?: string[];
        }
        • Optionalexpr?: AnyExpr
        • Optionalmethod?: RankMethod

          rank only: tie handling, default 'average' (pandas / Minitab)

        • Optionaloffset?: number
        • OptionalorderBy?: (string | AnyExpr | { descending: boolean; expr: AnyExpr })[]
        • OptionalpartitionBy?: string[]

      Returns LazyFrame<
          { [K in string
          | number
          | symbol]: (Omit<S, N> & Record<N, number>)[K] },
      >

    • Write Apache Arrow IPC to a Node path (.arrow / .feather with { format: 'file' }) or return the bytes.

      Parameters

      Returns Promise<Uint8Array<ArrayBufferLike>>

    • Write CSV to a path (streamed, memory bounded by one chunk; resolves to '') or return the text when no path is given.

      Parameters

      Returns Promise<string>

    • Write Apache Parquet (hyparquet-writer; round-trips with readParquet).

      Parameters

      • Optionalpath: string

      Returns Promise<Uint8Array<ArrayBufferLike>>

    • Write columna's JSON "parquet-like" format (round-trips with readParquetLike, not Apache Parquet).

      Parameters

      • Optionalpath: string

      Returns Promise<Uint8Array<ArrayBufferLike>>

    • 1-Sample Z with known sigma.

      Parameters

      • column: string
      • options: { alternative?: Alternative; confidence?: number; mu?: number; sigma: number }

      Returns ZTestResult