This is the first Zenodo-registered packaging of the NQX v1.0 hybrid format. The underlying specification and reference implementation are identical to v1.0.0.

NQX v1.0.0 – Hybrid File Format Release

This release introduces NQX v1.0, a compact and fully lossless hybrid container format for storing FASTQ sequencing data.
NQX combines a lightweight JSON metadata header with a structured binary payload designed for accuracy, extensibility, and efficient compression.

Key Features

1. Hybrid Metadata + Binary Layout

• JSON header for human-readable metadata
• Binary global header for fast parsing
• Block-based payload for scalable processing

2. Four-Stream Architecture

Each block stores:

• ID
• PLUS
• SEQ
• QUAL

as four independently compressed Zstandard streams, enabling strong compression without losing round-trip fidelity.

3. Fully Lossless

FASTQ → NQX → FASTQ
returns byte-identical output, including:

• All ID lines
• PLUS lines
• Sequence content
• Quality scores

4. Versioned and Extensible

This release formalizes:

• Hybrid variant
• Version 1.0 of the binary layout
• JSON-based version control
• Support for future NQX 1.x and 2.x revisions

Included in This Release

• SPEC_NQX_v1.0.md
  Full byte-level format specification
• encoder.py
  Reference encoder implementation
• decoder.py
  Reference decoder implementation
• nqx-info.py
  Metadata inspector
• examples/
  Test vectors (FASTQ → NQX → FASTQ round-trip)

All reference tools are released under the MIT License.

Validation (Recommended)

python encoder.py test.fastq test.nqx
python decoder.py test.nqx test_roundtrip.fastq

Diff or FC should report no differences.

Optional compression comparison:

gzip -9 test.fastq
gzip -9 test.nqx

Citation (Will update with DOI)

A DOI for this release will be assigned automatically by Zenodo.
Please cite NQX using the DOI that appears in this release page once Zenodo finishes indexing.

---

Bu metni aynen kullanabilirsin.  
Şimdi son adım:

# **1. Tag: `v1.0.0`**  
# **2. Title: `NQX v1.0 Hybrid Format`**  
# **3. Description → yukarıdaki metni yapıştır**  
# **4. Publish Release**

Release'i yayınladıktan sonra:

→ Zenodo otomatik DOI oluşturacak  
→ DOI'yi bana gönderirsin  
→ Ben de sana README için **professional citation block** yazacağım  
→ İstersen CV / portföy için kısa, orta, uzun atıf formatlarını da ekleyebilirim.

Hazırsan release'ini oluştur ve bana DOI'yi gönder.