Jupyter y JupyterLab
Esta página cambió después de phonometry 4.0.0, la última versión publicada en PyPI, así que puede describir código que esa versión aún no tiene. Lo nuevo desde entonces figura en la sección Unreleased del registro de cambios.
Un cuaderno ejecuta phonometry en un kernel de IPython corriente, así que se instala igual que en cualquier otro sitio; lo que añade el cuaderno es cómo se muestra un resultado bajo una celda. En un cuaderno, en Primeros pasos, recorre una primera celda y la tabla que muestra; esta página es el resto de lo que encuentra quien trabaja en un cuaderno.
Comprobado el 17 de noviembre de 2026 con phonometry 4.0.0 de PyPI, en la
imagen python:3.13-slim con Python 3.13.18: JupyterLab 4.6.6, ipykernel
7.4.0, matplotlib 3.11.2 y el ffmpeg 7.1.5 de Debian, con cada celda de esta
página ejecutada en el kernel.
Instalación
Sección titulada «Instalación»python -m venv .venvsource .venv/bin/activatepython -m pip install --upgrade pippython -m pip install jupyterlab "phonometry[full]"jupyter labEn Windows, el entorno se activa con .venv\Scripts\activate.bat en cmd o
con .venv\Scripts\Activate.ps1 en PowerShell en lugar de
source .venv/bin/activate.
En un equipo cliente de Windows, PowerShell rechaza los scripts con la
directiva de ejecución predeterminada, así que Activate.ps1 se ejecuta allí
cuando Set-ExecutionPolicy -Scope CurrentUser RemoteSigned ha permitido los
locales; cmd no necesita ese paso.
Ese único entorno contiene
JupyterLab, el kernel de
IPython que arranca y phonometry con todos los extras salvo [torch].
En Windows y Linux de 32 bits numba no tiene soporte, ni lo tiene [full],
que lo incluye:
python -m pip install jupyterlab "phonometry[plot,report,audio]" instala
JupyterLab con los otros tres extras. PyPI no tiene wheel para Windows de 32
bits de SciPy, matplotlib ni kiwisolver, ni de psutil y pywinpty, que
JupyterLab necesita allí, ni de PyYAML en Python 3.14, así que pip los compila
allí desde el código fuente, lo que pide un compilador de C y otro de C++, un
compilador de Fortran con BLAS y LAPACK para SciPy, y para pywinpty Rust y la
herramienta de línea de órdenes de NuGet, nuget.exe, en el PATH. En
Linux de 32 bits, medido en las imágenes de 32 bits de python:3.13-slim,
PyPI no tiene wheel de NumPy, SciPy, matplotlib, Pillow, contourpy,
kiwisolver, psutil, PyYAML, tornado ni argon2-cffi-bindings, ni de
cffi y pyzmq en ARM, de MarkupSafe en linux/386 y linux/arm/v5, o de lxml
y rpds-py en linux/arm/v5, así que pip los compila allí, con los mismos
compiladores, los archivos de desarrollo de las bibliotecas que enlazan y Rust
para rpds-py. En linux/arm/v5, cuya ABI de coma flotante por software no
cubre ningún wheel manylinux, las compilaciones de NumPy, SciPy, matplotlib y
pyzmq piden además ninja, patchelf y cmake, y pip también los compilaría desde
el código fuente, lo que ejecuta make y autoreconf, salvo que
apt-get install ninja-build patchelf cmake haya puesto los de la imagen en
el PATH.
Un resultado se muestra como tabla
Sección titulada «Un resultado se muestra como tabla»El valor de la última línea de una celda se muestra como una tabla de sus campos, con sus unidades, y la línea de debajo dice qué puede dibujar el resultado:
import numpy as npfrom phonometry import building, filters, io
fs = 48000t = np.arange(fs) / fsx = 0.4 * np.sin(2 * np.pi * 1000.0 * t)bands = filters.octave_filter(x, fs, fraction=3)bands # la última línea de la celda: el cuaderno muestra su tablaFiguras
Sección titulada «Figuras».plot() dibuja bajo la celda con el backend en línea, sin plt.show(). La
celda imprime además los ejes que devuelve, como
<Axes: title={'center': 'Band levels'}, ...>; un punto y coma tras la
llamada deja solo la figura. Las figuras salen en PNG, y una línea en una
celda pasa la sesión a SVG:
%config InlineBackend.figure_formats = ["svg"]bands.plot();Un .plot() que lanza un error, por ejemplo por una palabra clave mal escrita
como colour=, no deja bajo la celda ninguna figura a medio dibujar, solo el
error.
rating = building.weighted_rating( [30, 34, 38, 41, 45, 49, 50, 53, 54, 55, 56, 57, 58, 58, 58, 58])rating.report("rating.pdf")El PDF se escribe en la ruta que le das, relativa al directorio de trabajo
del cuaderno; [report] lo escribe y [plot] dibuja su gráfica.
io.write_video y las funciones que escriben animaciones FDTD ejecutan
ffmpeg, un programa que pip no instala. En Debian llega con los paquetes del
sistema, con apt install ffmpeg, y Escribir
vídeos da la orden para conda, macOS y Windows.
Las clases de visualización del propio IPython muestran después el archivo
bajo la celda:
from matplotlib.animation import FuncAnimationfrom matplotlib.figure import Figure
fig = Figure(figsize=(3.2, 2.4), dpi=100)ax = fig.add_subplot()phase = np.linspace(0.0, 2.0 * np.pi, 200)(line,) = ax.plot(phase, np.sin(phase))
def update(k): line.set_ydata(np.sin(phase - 0.2 * k)) return (line,)
animation = FuncAnimation(fig, update, frames=30, interval=50)io.write_video("wave.mp4", animation)io.write_video("wave.gif", animation, video=io.VideoOptions(quality="small"))from IPython.display import Image, Video, display
display(Video("wave.mp4", embed=True)) # un MP4 o un WebM, incrustado en el cuadernodisplay(Image(filename="wave.gif")) # un GIFUna celda muestra solo el valor de su última línea, así que los dos pasan por
display: como dos líneas sueltas, la celda mostraría el GIF y no el vídeo.
Avisos en una celda
Sección titulada «Avisos en una celda»Un aviso de la biblioteca nombra la línea de la celda que hizo la llamada, y aparece bajo cada celda que la hace, no solo bajo la primera:
/tmp/ipykernel_2485/1280619122.py:1: FilterBankWarning: Low sampling rate: fs = 48000 Hz cannot hold the 25 kHz band, whose upper edge 28184 Hz is above fs/2 = 24000 Hz; it was left out of the bank. wide = filters.octave_filter(x, fs, fraction=3, limits=[12.0, 25000.0])Para que los avisos lancen un error, pon el filtro en una celda. Todos:
import warnings
warnings.simplefilter("error")o solo los de la biblioteca, con warnings.simplefilter("error", phonometry.PhonometryWarning). No arranques el kernel con
PYTHONWARNINGS=error: el propio kernel se detiene entonces en un
DeprecationWarning de su bucle de eventos antes de responder al cuaderno, y el
cuaderno informa de un kernel que ha muerto.
VS Code y Colab
Sección titulada «VS Code y Colab»Los dos ejecutan los cuadernos sobre un kernel de IPython, así que lo que muestra esta página debería valer también allí. No se ha probado en ninguno de los dos.