Install & Compatibility
Where this runs
tested against v0.14.0 · pip install
no network on importno background threads
Install × environment matrix
Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux
muslpy 3.10–3.95 runs
installs and imports cleanly · install 0.0s · import 0.276s · 178.3MB
glibcpy 3.10–3.95 runs
installs and imports cleanly · install 7.7s · import 0.304s · 171MB
181MB installed
● package 181MB
Code
Verified usage
Verified import paths — ran on the pinned version, not inferred.
BluePrint
✓ from broadbean import BluePrint
✗ from broadbean.blueprint import BluePrint
BluePrint moved to top-level in recent versions.
Element
✓ from broadbean import Element
✗ from broadbean.element import Element
Element is available at top-level.
Sequence
✓ from broadbean import Sequence
✗ from broadbean.sequence import Sequence
Sequence is exported at top-level.
Demonstrates creating a Gaussian pulse blueprint, adding it to an element, building a sequence, and retrieving the waveform.
import numpy as np
from broadbean import BluePrint, Element, Sequence
# Create a simple Gaussian pulse
bp = BluePrint()
pulse = bp.setSRAmp('gaussian', amp=1, mu=0, sigma=1)
# Add to element
elem = Element()
elem.addBluePrint(0, bp)
# Build sequence
seq = Sequence()
seq.addElement(0, elem)
# Get waveform
waveform = seq.build()
print(waveform)
Errors
Common errors & fixes
ModuleNotFoundError: No module named 'broadbean'
Library not installed.
fixRun 'pip install broadbean'
ImportError: cannot import name 'BluePrint' from 'broadbean'
BluePrint was not a top-level import in older versions (pre-0.10).
fixUpgrade to broadbean >=0.10.0 and use 'from broadbean import BluePrint'
AttributeError: 'BluePrint' object has no attribute 'plot'
BluePrint.plot was removed in broadbean 0.11.0.
fixUse external plotting libraries such as matplotlib to visualize the signal.
Upgrade
Version history
0.15.0latest on PyPI · released May 11, 2026
Audit
Dependencies
numpyrequiredCore dependency for array operations and signal generation.