Skip to main content

Electrical Engineering Functions in Python

Project description

logo

ElectricPy

Electrical-Engineering-for-Python

sphinx Documentation Status Tox Import Test

pytest pydocstyle Coverage

Matrix

"Buy Me A Coffee"

Python Libraries with functions and constants related to electrical engineering.

The functions and constants that make up these modules represent a library of material compiled with the intent of being used primarily for research, development, education, and exploration in the realm of electrical engineering.

Check out our full documentation: https://electricpy.readthedocs.io/en/latest/

Antu dialog-warning Documentation has recently been updated to use ReadTheDocs

GitHub Pages are still active, and will continue to be for the forseeable future, but they're intended for developmental updates rather than primary documentation.

Features

  • Extensive set of common functions and formulas for electrical engineering and electronics.
  • Support for LaTeX math generation (use this in conjunction with your Jupyter notebooks!)
  • Generate focussed and simple plots, diagrams, and figures.

Samples Generated with ElectricPy

Phasor Plot Power Triangle Induction Motor Circle

Installing / Getting Started

  1. ElectricPy has a few basic installation options for use with pip. For most common users, use the following command to install ElectricPy with pip
pip install electricpy[full]
  1. Check installation success in Python environment:
import electricpy
electricpy._version_
  1. Start using the electrical engineering formulas
>>> import electricpy as ep
>>> voltage = ep.phasor(67, 120) # 67 volts at angle 120 degrees
>>> voltage
(-33.499999999999986+58.02370205355739j)
>>> ep.cprint(voltage)
67.0  120.0°

Installing from Source

If you're looking to get the "latest and greatest" from electricpy, you'll want to install directly from GitHub, you can do that one of two ways, the easiest of which is to simply issue the following command for pip

pip install git+https://github.com/engineerjoe440/ElectricPy.git

Alternatively, you can do it the "old fashioned way" by cloning the repository and installing locally.

  1. Clone/Download Source Code from GitHub Repository
  2. Open Terminal and Navigate to Folder with cd Commands:
  • cd <path\to\containing\folder>\electricpy
  1. Use Python to Install Module from setup.py:
  • pip install .

Dependencies

Optional Dependencies

For numerical analysis (install with pip install electricpy[numerical]):

For fault analysis (install with pip install electricpy[fault])

Get Involved / Contribute

If you're interested in contributing, we'd love to see your support in a number of ways!

  1. Write Tests - We're really lacking in this area. We've recently added simple GitHub actions to test installation, but that's about it. We hope that someday we can test all functions in this module for verification.
  2. Contribute New Electrical Engineering Functions - If you've got a new function related to electrical engineering that you'd like to see added, we'd love to throw it into this module. Our goal is that this module can become the comprehensive electrical engineering toolkit in Python. Drop us a note, or create a pull request!
  3. Report Issues - We don't want issues to go unnoticed. Please help us track bugs in our issues and resolve them!
  4. Get the Word Out - This project is still in its infancy, so please share it with your friends and colleagues. We want to make sure that everyone has the opportunity to take advantage of this project.

Check out the contribution guide

Come chat about ElectricPy

Special thanks to...

  • Stephen Weeks | Student - U of Idaho
  • Jeremy Perhac | Student - U of Idaho
  • Daniel Allen | Student - Universtiy of Idaho
  • Dr. Dennis Sullivan | Proffessor - U of Idaho
  • Dr. Brian Johnson | Proffessor - U of Idaho
  • Dr. Joe Law | Proffessor - U of Idaho
  • StackOverflow user gg349
  • Shaurya Uppal | Online Code Contributor
  • Paul Ortman | Power Quality Engineer - Idaho Power | Instructor - U of Idaho

and

contributors

Contact

For more information regarding this resource, please contact Joe Stanley

License and Usage

ElectricPy is licensed under the standard MIT license, and as such, you are permitted to use this resource as you see fit. Please feel free to ask questions, suggest edits and report bugs or other issues.

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

electricpy-0.3.0.tar.gz (100.7 kB view details)

Uploaded Source

Built Distribution

electricpy-0.3.0-py3-none-any.whl (105.6 kB view details)

Uploaded Python 3

File details

Details for the file electricpy-0.3.0.tar.gz.

File metadata

  • Download URL: electricpy-0.3.0.tar.gz
  • Upload date:
  • Size: 100.7 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.2 CPython/3.9.16

File hashes

Hashes for electricpy-0.3.0.tar.gz
Algorithm Hash digest
SHA256 85a9a0c222d6122ee14b2cfee47c115f721cbea3c0250794783692fa99e660f9
MD5 86d38392c133e438df6741bf81e56a20
BLAKE2b-256 97b5006245b73c8efdc121c9fe2c004e5c6224e28703aa7939fe75d9dfdcad9a

See more details on using hashes here.

File details

Details for the file electricpy-0.3.0-py3-none-any.whl.

File metadata

  • Download URL: electricpy-0.3.0-py3-none-any.whl
  • Upload date:
  • Size: 105.6 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.2 CPython/3.9.16

File hashes

Hashes for electricpy-0.3.0-py3-none-any.whl
Algorithm Hash digest
SHA256 c6ab3ac59ee41da2e0c6f45e02d4b6fd2e247f18856761f23664178446ad05a1
MD5 2a0ad2ef746772a5ae77dc9845b4301e
BLAKE2b-256 15dbfd0319a1ba68fca5e763995a4268dc2e0ac1057bd966f0fad454312d8cac

See more details on using hashes here.

Supported by

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