Skip to main content

A python module implementing power analysis to estimate sample size

Project description


This python project is a helper package that uses power analysis to calculate required sample size for any experiment.

Script Usage Guide

Sample size script lets you get the sample size estimation easily by providing metric inputs.


Please make sure you have Python 3 installed before using the script.

Verify Python was installed

python -V # python version should >=3.7.1, <3.11

Verify pip was installed

pip -V 

Install the package

pip install sample-size
pip show sample-size # verify package was installed

Start using the script

run-sample-size will prompt required questions for you to enter the input it needs


Script Constraints

  • This package supports

    • Single and multiple metrics per calculation
    • Multiple cohorts, i.e. more than one treatment variant, per calculation
    • Metric types: Boolean, Numeric, and Ratio
  • Default statistical power (80%) is used in run-sample-size all the time

  • Input constraints

    • alpha: (0, 0.4]
    • probability (Boolean Metric): (0, 1)
    • variance (Numeric and Ratio Metrics): [0, )
    • registered metrics: [1, ]
    • variants: [2, ]

    Please be aware that we are running simulations many times when calculating sample size for multiple metrics or variants. Therefore, too many cohorts or metrics will have extremely long runtime.


All contributors and contributions are welcome! Please see the contributing docs for more information.

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

sample-size-2.0.3.tar.gz (10.3 kB view hashes)

Uploaded source

Built Distribution

sample_size-2.0.3-py3-none-any.whl (12.2 kB view hashes)

Uploaded py3

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page