Malvern Zetasizer .dts
The Malvern Zetasizer software (Nano, Pro and Ultra) saves dynamic light scattering and zeta potential measurements as .dts files. OpenReadout returns one table row per size or zeta record: sample, time, temperature and the results the software computed (Z-average, PdI, intensity peaks, zeta potential, mobility, conductivity). No prior art exists for this binary format. It was derived from public files of several depositors, four of whom also published the Zetasizer software’s own table of the records. Provenance: docs/provenance/malvern-zetasizer.md. Crate: openreadout-biophys.
| format id | files | reads | confidence |
|---|---|---|---|
malvern-zetasizer-dts |
.dts measurement files of the Zetasizer software (Nano, Pro, Ultra; versions 7.02-8.01) |
size and zeta records: header, sample, results | evidence rubric (docs/assurance.md) |
Not read: ZS Xplorer .zmes files; the size distributions, correlation functions, zeta
distributions and phase plots stored in each record; molecular-weight and other record kinds
(listed only). Read but withheld: the widths of the size peaks and the peaks of the number and
volume distributions (no export in the corpus holds them, see “Validation”).
Layout
A compound file ([MS-CFB]):
Header:u161, a 16-byte identifier (c0 fe e4 a2 b2 26 d6 11 99 1b 00 90 27 9b 77 0c),u161,u32the next record number.Deleted: the deleted records.REC<n>: one stream per record,nits record number.
A record is a sequence of fields without tags. Strings are u32 byte length, 0x01, UTF-16LE
ending in NUL.
| offset | field |
|---|---|
| 0 | u16 record schema (10 in software 7.02; 13 in 7.12-8.01) |
| 2 | u16 kind: 1 size, 2 zeta |
| 12 | u32 record number |
| 16 | string: software version (7.13, 8.00.4813) |
| then | f64 measurement date: OLE Automation days, local time |
| then | string: instrument serial (MAL…) |
| then | u32, f32, f32 measured temperature (°C) |
Further on: the operator, the SOP path, the dispersant (one or more strings with their
properties), the material and a 46-byte block that begins with u32 1 or 2 and the bytes
01 00, and ends 02 00 00 00 01 00 00 02 00 00 00 01 00 00 (two empty strings), then the
sample name. The reader takes the string after the first material block of that shape. The
first u32 is 2 in six records of one depositor and 1 everywhere else; what it means is not
known.
Size results are located by their structure: f32 Z-average (d.nm), f32 PdI, u32 n and
n f32 (a fit of the correlation function; n was 24-50 in the corpus), then for the intensity,
number and volume distributions in turn: u32 k + k peak means (d.nm), u32 k + k areas (%),
u32 k + k widths (d.nm); a distribution’s areas sum to 100. The block sits about 2 KB before
the end of the record, after an f64 10.0, an f32 0.02, an f32, eight zero bytes, an f64
date and 12 (software 7.10) or 16 (7.12) zero bytes; the reader does not rely on those.
Zeta results: u32 5 + 5 f32 zeta peak areas (%, largest first), u32 5 + 5 zeta peak
means (mV), f64 conductivity (mS/cm), then ten f32: applied voltage (V), zeta potential
(mV), zeta deviation (mV), mobility (µm·cm/V·s), mobility deviation, five not identified; then
u32 5 + 5 zeta peak widths and the mobility peak areas, means and widths (u32 5 + 5 each).
A result block is returned only when exactly one block of that structure is in the record; a record with none (an aborted measurement) or several is listed without results and with a finding.
What the reader returns
Table records, one row per record in record-number order:
| column | unit | |
|---|---|---|
record |
— | record number |
kind |
— | size, zeta or other |
sample_name, measured_at |
— | ISO local time |
temperature |
°C | measured |
z_average, pdi |
nm, — | size records |
peak1_mean … peak3_width |
nm, %, nm | intensity peaks (mean, area, width); widths are NaN (withheld) |
zeta_potential, zeta_deviation |
mV | zeta records |
mobility, mobility_deviation |
µm·cm/(V·s) | |
conductivity |
mS/cm | |
voltage |
V | applied voltage (inferred) |
zeta_peak1_mean … zeta_peak3_width |
mV, %, mV | zeta peaks |
Table peaks: the intensity peaks of size records (width NaN) and every zeta and mobility peak
(record, distribution intensity/zeta/mobility, peak, mean, area, width, unit).
A file with size results has the finding size_values_withheld.
Experiment: vendor Malvern Panalytical, model Zetasizer, serial and software version (first record), start and end (earliest and latest record), the sample name when every record has the same one, technique dynamic light scattering (all records size) or zeta-potential measurement (all zeta).
The export’s number mean, volume mean and diffusion coefficient are computed by the software from the distributions and the Z-average; they are not stored and not returned.
Validation
tests/corpus/series_oracle/mod.rs compares the records table with the depositors’ copies of
the Zetasizer software’s records table (oracle/zetasizer_oracle.py; an export that lists only
some of a file’s records is matched by record number, "key": "record"). Sixteen files of five
depositors:
| depositor | software | records compared | what |
|---|---|---|---|
| da Silva (Zenodo 19193123) | 7.12 | 36 zeta | sample, date, temperature, zeta potential, mobility, conductivity |
| Samineni (Texas Data Repository) | 7.13 | 15 zeta | sample, zeta potential |
| Holden (UNC Dataverse), 3 files | 7.12 | 654 size | sample, date, temperature, Z-average, PdI, intensity peak means and areas |
| Bird (Manchester figshare), 6 items | 7.10 | 153 size, 15 zeta (sample, date, temperature) | sample, date, temperature (where exported), Z-average, PdI, intensity peak means and areas |
| Müller et al. (figshare 26496859), 5 files | 7.13 | 256 size and zeta | sample, date, Z-average, PdI, zeta potential |
Every cell agrees within the export’s rounding. The files without an export (7.02, 7.13 size records, 8.00, 8.01) are read for structure: every record’s header walks and every size record with results has exactly one block of the size structure.
Size results are confirmed on software 7.10, 7.12 and 7.13, by three depositors. The exports hold no
peak widths and no number or volume peaks, so those are withheld: the peak*_width columns are
NaN and the peaks table lists only intensity peaks, without widths.
Vocabulary (public API of openreadout-biophys, Zetasizer)
| identifier | meaning |
|---|---|
ZetasizerReader |
reader of Zetasizer .dts files |
ZETASIZER_FORMAT_ID |
malvern-zetasizer-dts |
FORMAT_ID |
malvern-zetasizer-dts (module constant) |
Peaks |
one distribution’s peaks: mean, area, width |
Size |
size results: z_average, pdi, peaks |
Zeta |
zeta results: zeta, zeta_deviation, mobility, mobility_deviation, conductivity, voltage, zeta_peaks, mobility_peaks |
Record |
one record: stream, schema, kind, number, version, measured_at, serial, temperature, sample, size, zeta, matches |
size result block, zeta result block |
assurance features (record kind): a record whose result block was found |
How this reader was derived, file by file: provenance log.