Skip to main content

A Python package for adding realistic noise to electrical load or current profiles. Useful for studying robustness to noise of algorithms

Project description

Overview

This is a package to ADD realistic sources of noise to electrical load profiles. This is useful for testing the robustness of algorithms to noise, to enhance the realism of synthetic data, or to generate augmented data for machine learning purposes.

The overal approach is as follows:

  • The package contains various Perturbations, such as perturbations to add Gaussian or Ornstein-Uhlenbeck noise, or to simulate measurement deadbands (and many others)
  • You decide which perturbations you want to use, and you add them to a Pipeline object.
  • You can call pipeline.apply(profiles), and the pipeline sequentially applies the various perturbations to the given profiles.

Note, the package expects profiles as a 2D array (timesteps X measurement devices)

Install

pip install noisy_load_profiles

Examples

On our Github We have examples that demonstrate basic usage, advanced usage, and how to construct new Perturbations.

Below we show the most barebones example of a pipeline applying two types of noise.

from noisy_load_profiles import Pipeline, perturbations
import numpy as np


# initialize some profiles
timesteps = 10
n_profiles = 2
profiles = np.ones((timesteps, n_profiles)) # 2 profiles with 10 timesteps each; example


# Initialize some pertubations
gaussian_noise = perturbations.MultiplicativeGaussianNoise(mean=0.0, std=0.01, seed=42)
deadband = perturbations.PercentualDeadBand(seed=42)

# construct the pipeline
pipeline = Pipeline([gaussian_noise, deadband])


# apply the perturbation to the profiles
perturbed_profiles = pipeline.apply(profiles)

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

noisy_load_profiles-0.1.2.tar.gz (12.6 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

noisy_load_profiles-0.1.2-py3-none-any.whl (14.8 kB view details)

Uploaded Python 3

File details

Details for the file noisy_load_profiles-0.1.2.tar.gz.

File metadata

  • Download URL: noisy_load_profiles-0.1.2.tar.gz
  • Upload date:
  • Size: 12.6 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.12.3

File hashes

Hashes for noisy_load_profiles-0.1.2.tar.gz
Algorithm Hash digest
SHA256 da7b4c9793b529e16000fd4a8de8e97175877cc2c7e26213c4d98255c9c5874c
MD5 93ef4a6a70ac13dd04ae418fd2031b84
BLAKE2b-256 44a25d0a73119016822b96840966f2419b6abebfe19a71806dd0d7358d59367d

See more details on using hashes here.

File details

Details for the file noisy_load_profiles-0.1.2-py3-none-any.whl.

File metadata

File hashes

Hashes for noisy_load_profiles-0.1.2-py3-none-any.whl
Algorithm Hash digest
SHA256 80811f87fbf6a80d1823583c42d0d213465835fba0d618c91dcdeca8ce7b0bd5
MD5 ae6eb97f4e114831cb5978568e9f6d35
BLAKE2b-256 ea4885d48d18ca745effe90882b9c2e7361097d1fa8d7d44f85caf6094f9153d

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page