pyjls
Joulescope™ file format
Decision gist · record as of 2026-08-14
Yes, if you are working with Joulescope instruments or need a specialized format for high-frequency multi-source signal storage with fast random access and summaries. The active maintenance, permissive license, and lack of known vulnerabilities support adoption. Medium install friction (compiled wheels, Python 3.12+ requirement) is acceptable for the target use case. Not suitable if you need a general-purpose time-series database or format—this is purpose-built for instrumentation.AI-flagged interpretation of the facts on this page — verify before relying
Before you install
- Requires Python 3.12 or later; Windows users need pywin32 installed and configured.
- Medium install friction due to compiled wheels for multiple platforms and Python versions (3.12–3.14).
- Dependency on numpy and pywin32 adds setup complexity on Windows.
License · maintenance · safety
Apache 2.0 (permissive) — Apache 2.0 permissive license allows commercial and private use with minimal restrictions; attribution required but no copyleft obligations.
last release 2026-08-09 (5 days) · last repo commit 2026-08-09 · 15 stars
0 known vulnerabilities (OSV.dev, 2026-08-14) · 133,559 downloads/mo, #11,505 on PyPI
Alternatives
Verify before relying
pip install pyjls
import pyjls
# Open and read a JLS file
with pyjls.Reader('data.jls') as reader:
signal_data = reader.read_signal(source_id=0, signal_id=0)- Whether the package provides high-level APIs for writing JLS files or only reading.
- Performance characteristics (read/write speed, memory usage) for typical file sizes.
- Availability of comprehensive documentation beyond the README.
- Support for VSR (variable sample rate) signals, marked as 'under development' in the description.
What it is and what it does
pyjls is a Python binding to the C implementation of the JLS (Joulescope file format) specification, designed for efficient storage and retrieval of high-frequency, multi-source time-series signal data. It addresses limitations of earlier formats by supporting flexible signal types (fixed and variable sample rate), multiple simultaneous data sources, annotations, and fast random access via pre-computed signal summaries. The format uses a tag-length-value structure similar to MPEG4 and PNG, with integrated CRC32C integrity checks.
The package is built on numpy and platform-specific dependencies, with pre-compiled wheels for Windows, macOS (Intel and ARM), and Linux (x86_64 and aarch64). It targets developers and researchers working with instrumentation data (power measurement, oscilloscope captures, embedded system logging) where both storage efficiency and rapid waveform visualization matter. Active development indicates ongoing refinement, though some features (compression, corrupted-file recovery) remain in progress.
Use it for
- Store and retrieve power-measurement data from Joulescope instruments with fast zoomed-out summaries for UI rendering.
- Log multi-channel sensor or oscilloscope data with UTC timestamps and sample-rate correlation for post-analysis.
- Annotate captured signals with timestamped markers or text notes without rewriting the entire data file.
- Archive high-frequency embedded-system traces (UART, GPIO, current) with flexible data types and multiple simultaneous sources.
- Perform fast seek and navigation on large multi-day signal captures without loading entire files into memory.
Worth the install?
AI-flagged interpretation of the facts on this page. Verify before relying on it.
Yes, if you are working with Joulescope instruments or need a specialized format for high-frequency multi-source signal storage with fast random access and summaries.
The active maintenance, permissive license, and lack of known vulnerabilities support adoption. Medium install friction (compiled wheels, Python 3.12+ requirement) is acceptable for the target use case. Not suitable if you need a general-purpose time-series database or format—this is purpose-built for instrumentation.
Install
pyjls on PyPI
Before you install
Medium install friction due to compiled wheels for multiple platforms and Python versions (3.12–3.14). Dependency on numpy and pywin32 adds setup complexity on Windows. Active maintenance with recent release (5 days old) and stable repository status.
Requires Python 3.12 or later; Windows users need pywin32 installed and configured.
License in practice
Apache 2.0 permissive license allows commercial and private use with minimal restrictions; attribution required but no copyleft obligations.
Quickstart
pip install pyjls
import pyjls
# Open and read a JLS file
with pyjls.Reader('data.jls') as reader:
signal_data = reader.read_signal(source_id=0, signal_id=0)Verify before relying
- Whether the package provides high-level APIs for writing JLS files or only reading.
- Performance characteristics (read/write speed, memory usage) for typical file sizes.
- Availability of comprehensive documentation beyond the README.
- Support for VSR (variable sample rate) signals, marked as 'under development' in the description.
Package facts
| License | Apache 2.0 permissive |
| Python support | Supports the current Python release ~=3.12 |
| Install friction | Medium. Platform-specific wheel |
| Runtime dependencies | 2 packagesnumpypywin32 |
| Maintenance | Actively maintained 5 days since the last release |
| Last repo commit | |
| First released | |
| Downloads | 133,559 / month, #11,505 on PyPI 30-day window, as of 2026-08-14 |
| Known vulnerabilities | None known OSV.dev, checked 2026-08-14 |
| Classifiers | Development Status :: 5 - Production/StableIntended Audience :: DevelopersIntended Audience :: End Users/DesktopIntended Audience :: Science/ResearchLicense :: OSI Approved :: Apache Software LicenseOperating System :: MacOS :: MacOS XOperating System :: Microsoft :: Windows :: Windows 11Operating System :: POSIX :: LinuxProgramming Language :: PythonProgramming Language :: Python :: 3Programming Language :: Python :: 3.12Programming Language :: Python :: 3.13Programming Language :: Python :: 3.14Programming Language :: Python :: Implementation :: CPythonTopic :: Scientific/EngineeringTopic :: Software Development :: Embedded SystemsTopic :: Software Development :: TestingTopic :: System :: Hardware :: Hardware DriversTopic :: Utilities |
Evidence: pyjls-0.18.0-cp312-cp312-macosx_10_13_universal2.whl; pyjls-0.18.0-cp312-cp312-manylinux_2_27_aarch64.manylinux_2_28_aarch64.whl; pyjls-0.18.0-cp312-cp312-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl; pyjls-0.18.0-cp312-cp312-win_amd64.whl; pyjls-0.18.0-cp312-cp312-win_arm64.whl; pyjls-0.18.0-cp313-cp313-macosx_10_13_universal2.whl; pyjls-0.18.0-cp313-cp313-manylinux_2_27_aarch64.manylinux_2_28_aarch64.whl; pyjls-0.18.0-cp313-cp313-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl; pyjls-0.18.0-cp313-cp313-win_amd64.whl; pyjls-0.18.0-cp313-cp313-win_arm64.whl; pyjls-0.18.0-cp314-cp314-macosx_10_15_universal2.whl; pyjls-0.18.0-cp314-cp314-manylinux_2_27_aarch64.manylinux_2_28_aarch64.whl; pyjls-0.18.0-cp314-cp314-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl; pyjls-0.18.0-cp314-cp314-win_amd64.whl; pyjls-0.18.0-cp314-cp314-win_arm64.whl
Tags
Let your AI agent find packages like this
Example. Real query, live index.
You found this page by searching. An agent finds it by wishing: SkillFed indexes 14,416 PyPI packages by what they can do, searchable in plain language.
wish › “joulescope file format”
- pyjlsReads and writes JLS (Joulescope) files, a specialized format for…
- pyjoulescope-driverPython bindings for the Joulescope DC energy analyzer driver,…
- joulescopeJoulescope is a Python driver for the Joulescope DC energy analyzer…
Give your agent the search over MCP, or paste the wish link into any chat.
More Scientific/Engineering packages
NumPy provides an N-dimensional array object and a comprehensive suite of mathematical, linear algebra, Fourier transform, and random number functions for scientific computing in Python.
pandas provides fast, flexible data structures (Series and DataFrame) for loading, cleaning, transforming, and analyzing labeled or relational data in Python.
scipy provides numerical algorithms for mathematics, science, and engineering—including optimization, integration, linear algebra, Fourier transforms, signal and image processing, and ODE solvers—built on numpy arrays.
scikit-learn provides a comprehensive Python library for supervised and unsupervised machine learning, including classification, regression, clustering, dimensionality reduction, and model evaluation tools built on NumPy and SciPy.
Install it if you need to train, evaluate, or deploy supervised or unsupervised learning models.
dill extends Python's pickle module to serialize and deserialize a much wider range of Python objects, including functions, lambdas, classes, and interpreter sessions, to byte streams for storage or network transmission.
Multiprocess is an enhanced fork of Python's standard multiprocessing library that uses dill for better serialization, allowing you to spawn processes with a threading-like API and share complex objects between them.
Install it if you use multiprocessing and encounter pickle serialization limits with lambdas or complex objects.
See also json-timeseries · pyjoulescope-driver · joulescope · wfdb · pyEDFlib · javaobj-py3 · edfio · broadbean · segyio · ldfparser