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.GaussianNoise(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.16.tar.gz (13.9 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.16-py3-none-any.whl (16.0 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: noisy_load_profiles-0.1.16.tar.gz
  • Upload date:
  • Size: 13.9 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.16.tar.gz
Algorithm Hash digest
SHA256 8ff87842a19b9cce5a36ee613a22080d6b47de44144536ad9f46017f70ea8e03
MD5 cb22cfc34e52858d1810dc53807cc2ae
BLAKE2b-256 411ebf8e16238a35eb4832e999d2739138d5d5f5a701534d7813317fa4139a93

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for noisy_load_profiles-0.1.16-py3-none-any.whl
Algorithm Hash digest
SHA256 5c8f969b3a8f3c026ad1d4cd4a2d77f4f2fd3e1b3250a908e4bce35b063289a3
MD5 2056ae0d022b4c04017dc14c41b8d1f0
BLAKE2b-256 0d64677d72c87220bd239aeb7bb80094aa5a7b99396cd84d94d7d9101088872f

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