Touchstone.Parser 1.0.1

Touchstone.Parser

A .NET library for Touchstone .sNp parsing and S‑parameter analysis in RF/microwave engineering.

Touchstone.Parser is a clean, modular, enterprise-ready .NET library for parsing Touchstone (.sNp) files — the industry-standard format for RF and microwave S‑parameter data. It provides strongly typed classes, LINQ-friendly APIs, and seamless integration into simulation and analysis workflows.

✨ Features

• Parse .sNp files into strongly typed C# classes (TouchstoneData, FrequencyPoint, NetworkParameter)
• Multi-port support — 1‑port through N‑port networks
• All data formats — Real/Imaginary (RI), Magnitude/Angle (MA), Decibel/Angle (DB)
• All frequency units — Hz, kHz, MHz, GHz with automatic normalization
• All parameter types — S, Y, Z, H, G
• LINQ-friendly APIs — query S‑parameters with GetS11(), GetS21(), GetParameter(i, j)
• RF calculations — insertion loss, return loss, VSWR out of the box
• Export utilities — CSV export and Touchstone writer for round-trip fidelity
• Async support — ParseAsync() with cancellation token
• Cross-platform — targets net6.0 and netstandard2.1
• Zero dependencies — pure .NET, no external packages

📦 Installation

dotnet add package Touchstone.Parser

Or via the NuGet Package Manager:

Install-Package Touchstone.Parser

🚀 Quick Start

using Touchstone.Parser.Parsing;
using Touchstone.Parser.Utilities;
using Touchstone.Parser.Models;

// Parse a Touchstone file
var data = TouchstoneParser.Parse("filter.s2p");

Console.WriteLine($"Ports: {data.NumberOfPorts}");
Console.WriteLine($"Frequency points: {data.Count}");

// Query S21 insertion loss with LINQ
foreach (var (freqHz, param) in data.GetS21())
{
    double freqGhz = FrequencyConverter.FromHz(freqHz, FrequencyUnit.GHz);
    Console.WriteLine($"{freqGhz:F3} GHz → S21 = {param.MagnitudeDb:F2} dB");
}

// Filter to a frequency range
var passband = data.InFrequencyRange(2.0e9, 3.0e9);

// Compute VSWR
foreach (var (freqHz, vswr) in data.ToVswr())
{
    Console.WriteLine($"VSWR = {vswr:F3}");
}

// Export to CSV
using var writer = new StreamWriter("output.csv");
data.ToCsv(writer, FrequencyUnit.GHz, DataFormat.DecibelAngle);

📖 API Overview

Parsing

Data Access (LINQ-friendly)

RF Calculations

Filtering & Export

Utilities

🏗️ Project Structure

touchstone-dotnet/
├── src/
│   └── Touchstone.Parser/          # Core library
│       ├── Models/                  # Domain models (enums, data classes)
│       ├── Parsing/                 # Parser engine
│       └── Utilities/               # Converters, extensions, writer
├── tests/
│   └── Touchstone.Parser.Tests/    # xUnit test suite
├── examples/
│   └── Touchstone.Parser.Examples/ # Demo console app
├── Directory.Build.props            # Centralized build settings
├── Touchstone.Parser.sln            # Solution file
└── global.json                      # .NET SDK version

🔧 Supported Formats

🧪 Running Tests

dotnet test --verbosity normal

🤝 Contributing

Contributions are welcome! Please see CONTRIBUTING.md for guidelines.

📄 License

This project is licensed under the MIT License.

📚 Resources

• Touchstone File Format Specification (IBIS)
• S-parameter — Wikipedia
• NuGet Package

<p align="center"> <em>Built for the RF/microwave engineering community</em> 📡 </p>