JupyterLite y Pyodide
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.
JupyterLite ejecuta un cuaderno en una pestaña del navegador, sobre Pyodide: CPython compilado a WebAssembly, sin nada que instalar en la máquina. phonometry es Python puro, así que se instala allí con micropip y funciona sobre el NumPy, el SciPy y el matplotlib que Pyodide compila para el navegador. Lo que no puede acompañarlo es lo que necesita un paquete compilado que Pyodide no compila, o un programa propio.
Comprobado el 17 de noviembre de 2026 con phonometry 4.0.0 de PyPI: la instalación y los ejemplos en Pyodide 314.0.8 bajo Node.js, con micropip 0.11.1, NumPy 2.4.6, SciPy 1.18.0 y matplotlib 3.10.8, y la construcción del sitio con jupyterlite-core 0.8.7, jupyterlite-pyodide-kernel 0.8.7 y jupyter-server 2.21.1.
Instalación en un cuaderno
Sección titulada «Instalación en un cuaderno»%pip install "phonometry[plot,report,audio]"La celda no imprime nada cuando todo va bien. numpy, scipy, matplotlib y soundfile llegan de las compilaciones del propio Pyodide, el último con libsndfile compilado para el navegador; reportlab y svglib son Python puro y llegan de PyPI.
Nombra todos los extras en la primera instalación. micropip no toca los
extras de un paquete que ya instaló: con phonometry instalado, un
%pip install "phonometry[report]" posterior no instala nada, y tampoco
imprime nada. Para añadir lo que habría traído un extra posterior, nombra sus
paquetes, que Primeros pasos
enumera extra por extra:
%pip install reportlab svgliby %pip install soundfile para [audio]. Un mensaje por un extra que falta
escribe su orden como pip install "phonometry[...]"; en una celda de
JupyterLite se ejecuta con un % delante.
Qué funciona en el navegador
Sección titulada «Qué funciona en el navegador»Todos los dominios se importan, y las tablas de los resultados, .plot() bajo
la celda y .report() funcionan como en
Jupyter. Los archivos WAV y FLAC
se escriben y se vuelven a leer en la propia carpeta del cuaderno. Las
simulaciones FDTD calculan con NumPy.
import numpy as npfrom phonometry import building, filters, io
fs = 48000x = 0.4 * np.sin(2 * np.pi * 1000.0 * np.arange(fs) / fs)bands = filters.octave_filter(x, fs, fraction=3)io.write("tone.wav", 0.5 * x, fs)tone = io.read("tone.wav")rating = building.weighted_rating( [30, 34, 38, 41, 45, 49, 50, 53, 54, 55, 56, 57, 58, 58, 58, 58])rating.report("rating.pdf")Qué no funciona
Sección titulada «Qué no funciona»-
[perf],[torch]y[full]no se instalan. micropip no encuentra ningún wheel de numba ni de torch que pueda ejecutarse en el navegador, y un solo requisito que no puede cumplir detiene la instalación entera:ValueError: Can't find a pure Python 3 wheel for 'numba>=0.63.0; python_version >= "3.14" and extra == "perf"'.Sin numba, la ponderación temporal
impulsese ejecuta en Python puro y no dice nada. -
Ningún dispositivo de cálculo salvo
"cpu".Compute(device="torch:cpu")lanzaComputeDeviceError: device 'torch:cpu' is not available in Pyodide; only 'cpu' is; confallback=Truela simulación calcula con NumPy y avisa conComputeFallbackWarning. -
No hay vídeo. Un navegador no puede arrancar un programa, así que
io.write_videoy las funciones que escriben animaciones FDTD lanzanFFmpegNotFoundError: Pyodide cannot start programs, so it cannot run ffmpeg; write the video from Python on a desktop, a server or a node.
Para convertir en errores los avisos de la biblioteca en un cuaderno de
JupyterLite, filtra por su propia clase, warnings.simplefilter("error", phonometry.PhonometryWarning). Un warnings.simplefilter("error") general
convierte también en error un aviso de obsolescencia que el matplotlib 3.10.8
de Pyodide emite al dibujar, y entonces .plot() falla bajo la celda.
Pyodide sin JupyterLite
Sección titulada «Pyodide sin JupyterLite»En una página o un script de Node.js que carga Pyodide por su cuenta,
micropip es uno de los paquetes de la distribución de Pyodide, que Pyodide no
carga hasta que se le pide. El script lo carga desde JavaScript, después de
loadPyodide():
const pyodide = await loadPyodide();await pyodide.loadPackage("micropip");y el Python que luego le pasa a pyodide.runPythonAsync() instala
phonometry, con los mismos extras y los mismos límites:
import micropip
await micropip.install("phonometry[plot,report,audio]")Sin el paso de loadPackage, import micropip falla con
ModuleNotFoundError: No module named 'micropip'.
Un sitio de JupyterLite propio
Sección titulada «Un sitio de JupyterLite propio»Un curso o un laboratorio puede publicar sus cuadernos como un sitio de
JupyterLite, que se construye una vez y se sirve como archivos estáticos. La
construcción necesita jupyter-server junto a los dos paquetes de
JupyterLite, o se detiene con “jupyter-server is not installed. You cannot add
custom content to jupyterlite”:
python -m venv .venvsource .venv/bin/activatepython -m pip install --upgrade pippython -m pip install jupyterlite-core jupyterlite-pyodide-kernel jupyter-serverjupyter lite build --contents content --output-dir _outputEn 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.
content contiene los cuadernos y _output es el sitio que hay que servir.
La construcción imprime además dos avisos, sobre libarchive-c y sobre
jupyterlab_server, que no cambian nada del sitio. Un wheel puesto en una
carpeta pypi del directorio donde se construye se publica con el sitio, y
%pip install lo toma de allí antes que de PyPI.