Struct linregress::FormulaRegressionBuilder [−][src]
pub struct FormulaRegressionBuilder<'a> { /* fields omitted */ }
Expand description
A builder to create and fit a linear regression model.
Given a dataset and a regression formula this builder will produce an ordinary least squared linear regression model.
See formula
and data
for details on how to configure this builder.
The pseudo inverse method is used to fit the model.
Usage
use linregress::{FormulaRegressionBuilder, RegressionDataBuilder}; let y = vec![1., 2. ,3., 4.]; let x = vec![4., 3., 2., 1.]; let data = vec![("Y", y), ("X", x)]; let data = RegressionDataBuilder::new().build_from(data)?; let model = FormulaRegressionBuilder::new().data(&data).formula("Y ~ X").fit()?; assert_eq!(model.parameters.intercept_value, 4.999999999999998); assert_eq!(model.parameters.regressor_values[0], -0.9999999999999989); assert_eq!(model.parameters.regressor_names[0], "X");
Implementations
Set the data to be used for the regression.
The data has to be given as a reference to a RegressionData
struct.
See RegressionDataBuilder
for details.
Set the formula to use for the regression.
The expected format is <regressand> ~ <regressor 1> + <regressor 2>
.
E.g. for a regressand named Y and three regressors named A, B and C
the correct format would be Y ~ A + B + C
.
Note that there is currently no special support for categorical variables.
So if you have a categorical variable with more than two distinct values
or values that are not 0
and 1
you will need to perform “dummy coding” yourself.
Fits the model and returns a RegressionModel
if successful.
You need to set the data with data
and a formula with formula
before you can use it.
Like fit
but does not perfom any statistics on the resulting model.
Returns a RegressionParameters
struct containing the model parameters
if successfull.
This is usefull if you do not care about the statistics or the model and data you want to fit result in too few residual degrees of freedom to perform statistics.
Trait Implementations
Auto Trait Implementations
impl<'a> RefUnwindSafe for FormulaRegressionBuilder<'a>
impl<'a> Send for FormulaRegressionBuilder<'a>
impl<'a> Sync for FormulaRegressionBuilder<'a>
impl<'a> Unpin for FormulaRegressionBuilder<'a>
impl<'a> UnwindSafe for FormulaRegressionBuilder<'a>
Blanket Implementations
Mutably borrows from an owned value. Read more
type Output = T
type Output = T
Should always be Self
The inverse inclusion map: attempts to construct self
from the equivalent element of its
superset. Read more
pub fn is_in_subset(&self) -> bool
pub fn is_in_subset(&self) -> bool
Checks if self
is actually part of its subset T
(and can be converted to it).
pub fn to_subset_unchecked(&self) -> SS
pub fn to_subset_unchecked(&self) -> SS
Use with care! Same as self.to_subset
but without any property checks. Always succeeds.
pub fn from_subset(element: &SS) -> SP
pub fn from_subset(element: &SS) -> SP
The inclusion map: converts self
to the equivalent element of its superset.
pub fn vzip(self) -> V