AddNoise

class chemotools.augmentation.AddNoise(distribution: Literal['gaussian', 'poisson', 'exponential'] = 'gaussian', scale: float = 0.0, random_state: int | None = None)

ベースクラス: TransformerMixin, OneToOneFeatureMixin, BaseEstimator

Add noise to input data from various probability distributions.

This transformer adds random noise from specified probability distributions to the input data. Supported distributions include Gaussian, Poisson, and exponential.

パラメータ:

• distribution ({'gaussian', 'poisson', 'exponential'}, default='gaussian') -- The probability distribution to sample noise from.

• scale (float, default=0.0) -- Scale parameter for the noise distribution: - For gaussian: standard deviation - For poisson: multiplication factor for sampled values - For exponential: scale parameter (1/λ) Must be non-negative.

• random_state (int, optional) -- Random seed for reproducibility.

変数:

n_features_in (int) -- Number of features in the training data.

サンプル

>>> from chemotools.augmentation import AddNoise
>>> from chemotools.datasets import load_fermentation_train
>>> # Load sample data
>>> X, _ = load_fermentation_train()
>>> # Instantiate the transformer
>>> transformer = AddNoise(distribution="gaussian", scale=0.1)
AddNoise()
>>> transformer.fit(X)
>>> # Generate noisy data
>>> X_noisy = transformer.transform(X)

fit(X: ndarray, y=None) → AddNoise

Fit the transformer to the input data.

パラメータ:

• X (np.ndarray of shape (n_samples, n_features)) -- Training data.

• y (None) -- Ignored. Present for API consistency.

戻り値:

self -- Fitted transformer.

戻り値の型:

AddNoise

例外:

ValueError -- If X is not a 2D array or contains non-finite values.

transform(X: ndarray, y=None) → ndarray

Transform the input data by adding random noise.

パラメータ:

• X (np.ndarray of shape (n_samples, n_features)) -- Input data to transform.

• y (None) -- Ignored. Present for API consistency.

戻り値:

X_transformed -- Transformed data with added noise.

戻り値の型:

np.ndarray of shape (n_samples, n_features)

例外:

ValueError -- If X has different number of features than the training data, or if an invalid noise distribution is specified.