Konversi XDF menjadi PDF

PDF berguna ketika rekaman XDF harus dibagikan sebagai laporan dengan tata letak tetap, dicetak, atau diarsipkan untuk ditinjau. Karena file XDF biasanya berisi pengukuran, bukan halaman, konversi memerlukan aplikasi atau alur kerja analisis yang memahami varian XDF tertentu.

Apa itu format XDF

XDF adalah ekstensi nama file yang ambigu. Penggunaan ilmiah yang paling umum adalah Extensible Data Format yang digunakan oleh aplikasi Lab Streaming Layer (LSL), seperti LabRecorder. File ini dapat berisi stream EEG, ECG, gerakan, pelacakan mata, audio, dan penanda peristiwa yang tersinkronisasi, lengkap dengan timestamp dan metadata.

File LSL XDF menyimpan data deret waktu, bukan halaman dokumen, font, atau tata letak yang telah ditentukan. Produk lain juga menggunakan .xdf, termasuk sistem terkait Microsoft R seperti RevoScaleR. File XDF dari satu produk mungkin tidak dapat dibaca oleh software yang dirancang untuk produk lain, jadi identifikasi aplikasi pembuatnya sebelum memilih converter.

Apa itu format PDF

PDF adalah format dokumen dengan tata letak tetap yang mempertahankan dimensi halaman, teks, grafis, dan—dalam banyak ekspor—informasi font di berbagai sistem operasi. Format ini cocok untuk pencetakan dan distribusi, tetapi bukan pengganti tanpa kehilangan untuk rekaman sumber: sampel, timestamp, metadata, label channel, dan penanda peristiwa dapat diplot secara selektif, diringkas, atau dihilangkan.

Cara mengonversi file LSL XDF

Tidak ada converter sekali klik universal untuk file LabRecorder XDF karena sumbernya berisi stream, bukan tata letak dokumen. Metode desktop yang andal adalah membaca stream dengan pyxdf, memplotnya dengan Matplotlib, lalu menulis plot tersebut ke PDF.

1. Instal Python 3 dan package yang diperlukan dengan python -m pip install pyxdf matplotlib numpy.
2. Simpan kode berikut sebagai xdf_to_pdf.py dan ganti input.xdf dengan nama file sumber.
3. Jalankan python xdf_to_pdf.py. Script akan membuat xdf_report.pdf, dengan menambahkan satu halaman untuk setiap stream numerik.

import numpy as np
import pyxdf
import matplotlib.pyplot as plt
from matplotlib.backends.backend_pdf import PdfPages

streams, _ = pyxdf.load_xdf('input.xdf')

with PdfPages('xdf_report.pdf') as pdf:
    for stream in streams:
        samples = np.asarray(stream.get('time_series'))
        times = np.asarray(stream.get('time_stamps'))
        info = stream.get('info', {})
        name_values = info.get('name', ['Unnamed stream'])
        name = name_values[0] if name_values else 'Unnamed stream'

        if samples.size == 0 or samples.dtype.kind not in 'iuf':
            continue
        if samples.ndim == 1:
            samples = samples[:, None]
        if times.size != samples.shape[0]:
            continue

        times = times - times[0]
        figure, axes = plt.subplots(
            samples.shape[1], 1, sharex=True, figsize=(11.69, 8.27), squeeze=False
        )
        for channel, axis in enumerate(axes[:, 0]):
            axis.plot(times, samples[:, channel], linewidth=0.6)
            axis.set_ylabel('Ch ' + str(channel + 1))
            axis.grid(True, linewidth=0.3)
        axes[-1, 0].set_xlabel('Seconds from first sample')
        figure.suptitle(name)
        figure.tight_layout()
        pdf.savefig(figure)
        plt.close(figure)

Hasilnya adalah laporan visual, bukan ekspor data yang siap dianalisis. Untuk rekaman panjang, plot rentang waktu atau channel yang representatif; memplot setiap sampel dapat membuat PDF berukuran sangat besar dan lambat. Tambahkan unit, nama channel, penanda peristiwa, dan metadata rekaman secara eksplisit jika diperlukan dalam laporan.

Alur kerja desktop lainnya

Untuk rekaman EEG dan fisiologis lainnya, periksa file dengan scientific tool yang mendukung XDF seperti MNE-Python jika XDF reader-nya tersedia, atau muat dengan pyxdf dan buat figure atau laporan analisis. Gunakan File → Print atau perintah ekspor PDF dari program tersebut setelah memeriksa pemilihan channel, timestamp, unit, dan marker.

Untuk file XDF yang dibuat oleh sistem data R, buka file tersebut dengan package R yang sesuai—seperti package yang digunakan oleh RevoScaleR—lalu ekspor tabel atau plot yang diperlukan dan buat PDF melalui File → Print atau alur kerja File → Knit Document yang telah dikonfigurasi di RStudio. Jangan gunakan XDF reader LSL untuk varian tersebut tanpa mengonfirmasi kompatibilitasnya.

Converter online dan batasan kompatibilitas

Layanan online umum seperti CloudConvert dan Zamzar sebaiknya hanya dipertimbangkan jika halaman upload mereka saat ini secara eksplisit mencantumkan varian XDF yang tepat serta dapat melakukan preview atau memproses file tersebut. Layanan ini umumnya tidak menafsirkan struktur deret waktu LabRecorder sebagai laporan, dan mengunggah data EEG, biometrik, klinis, atau proprietary dapat melanggar persyaratan privasi atau penanganan penelitian. Adobe Acrobat dan printer PDF biasa tidak dapat membuka data LSL XDF mentah secara bermakna; keduanya hanya dapat memproses laporan atau gambar yang dihasilkan oleh aplikasi yang memahami XDF.

Simpan XDF asli bersama PDF. Periksa sampel yang terlewat, marker yang hilang, konversi timestamp, metadata yang tidak lengkap, dan downsampling sebelum menggunakan PDF sebagai catatan analisis; simpan data sumber dan pengaturan pemrosesan untuk menjamin reproduktibilitas.