touchstone 0.12.1

Touchstone (s2p, etc.) file parser, plotter, and more
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432

<!DOCTYPE html>
<html lang="en">

<head>
    <meta charset="UTF-8">
    <meta name="viewport" content="width=device-width, initial-scale=1.0">
    <title>Touchstone Viewer - 1-Port</title>
    <script src="./js/tailwindcss-3.4.17.js"></script>
    <!-- Plotly.js CDN -->
    <script src="./js/plotly-3.3.0.min.js"></script>
    <style>
        /* Smooth transition for dimensions and transform */
        .grid-item {
            transition: all 0.4s cubic-bezier(0.25, 0.8, 0.25, 1);
            display: flex;
            flex-direction: column;
            height: 500px;
            /* Larger height for single plot */
        }

        /* Expanded State Logic */
        .grid-item.expanded {
            height: 700px;
            /* Expanded height */
            border-color: #3b82f6;
            /* Blue border to highlight active */
            box-shadow: 0 20px 25px -5px rgba(0, 0, 0, 0.1), 0 10px 10px -5px rgba(0, 0, 0, 0.04);
        }

        .toggle-icon {
            transition: transform 0.3s ease;
        }

        .expanded .toggle-icon {
            transform: rotate(180deg);
        }

        /* Ensure chart containers take full height */
        .chart-container {
            width: 100%;
            height: 100%;
            flex-grow: 1;
        }

        .action-btn {
            opacity: 0.8;
            transition: opacity 0.2s, background-color 0.2s, transform 0.1s;
            position: relative;
        }

        .action-btn:hover {
            opacity: 1;
            background-color: #f3f4f6;
            transform: translateY(-1px);
        }

        /* Custom Tooltip Style */
        #custom-tooltip {
            transition: opacity 0.15s ease;
        }
    </style>
</head>

<body class="bg-gray-100 min-h-screen p-4 md:p-8">

    <div class="max-w-4xl mx-auto mb-6">
        <h1 class="text-2xl font-bold text-gray-800">1-Port Network Performance</h1>
        <p class="text-gray-600">Click the hover icon (+) to cycle through nearest point, X-axis lock, Y-axis lock, and
            no hover modes.</p>
    </div>

    <!-- Main Grid Container -->
    <div class="grid grid-cols-1 gap-6 w-full max-w-4xl mx-auto">

        <!-- S11 Plot -->
        <div id="card-s11"
            class="grid-item relative bg-white rounded-2xl shadow-md overflow-hidden border border-gray-200 p-4">
            <div class="flex justify-between items-start mb-2">
                <h2 class="text-lg font-bold text-gray-800 z-10 pointer-events-none truncate mr-2">S11 (Return Loss)</h2>
                <div class="flex items-center space-x-1 z-20 flex-shrink-0">
                    <!-- Reset Zoom -->
                    <button onclick="resetZoom('plot-s11')" class="action-btn p-2 rounded-full"
                        data-tooltip="Reset Zoom">
                        <svg class="w-5 h-5 text-gray-600" fill="none" stroke="currentColor" viewBox="0 0 24 24">
                            <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2"
                                d="M4 4v5h.582m15.356 2A8.001 8.001 0 004.582 9m0 0H9m11 11v-5h-.581m0 0a8.003 8.003 0 01-15.357-2m15.357 2H15">
                            </path>
                        </svg>
                    </button>
                    <!-- Zoom In -->
                    <button onclick="zoomIn('plot-s11')" class="action-btn p-2 rounded-full" data-tooltip="Zoom In">
                        <svg class="w-5 h-5 text-gray-600" fill="none" stroke="currentColor" viewBox="0 0 24 24">
                            <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2"
                                d="M21 21l-6-6m2-5a7 7 0 11-14 0 7 7 0 0114 0zM10 7v6m3-3H7"></path>
                        </svg>
                    </button>
                    <!-- Zoom Out -->
                    <button onclick="zoomOut('plot-s11')" class="action-btn p-2 rounded-full" data-tooltip="Zoom Out">
                        <svg class="w-5 h-5 text-gray-600" fill="none" stroke="currentColor" viewBox="0 0 24 24">
                            <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2"
                                d="M21 21l-6-6m2-5a7 7 0 11-14 0 7 7 0 0114 0zM13 10H7"></path>
                        </svg>
                    </button>
                    <!-- Toggle Hover -->
                    <button id="hover-toggle-plot-s11" onclick="toggleHoverMode('plot-s11')"
                        class="action-btn p-2 rounded-full" data-tooltip="Toggle Hover Mode: Nearest Point">
                        <svg id="hover-icon-plot-s11" class="w-5 h-5 text-gray-700" fill="none" stroke="currentColor"
                            viewBox="0 0 24 24">
                            <!-- Default icon: Crosshair (Nearest) -->
                            <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2"
                                d="M4 12h16M12 4v16" />
                        </svg>
                    </button>
                    <!-- CSV Button -->
                    <button onclick="downloadCSV('plot-s11', 's11_data')" class="action-btn p-2 rounded-full"
                        data-tooltip="Download CSV">
                        <svg class="w-5 h-5 text-gray-600" fill="none" stroke="currentColor" viewBox="0 0 24 24">
                            <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2"
                                d="M12 10v6m0 0l-3-3m3 3l3-3m2 8H7a2 2 0 01-2-2V5a2 2 0 012-2h5.586a1 1 0 01.707.293l5.414 5.414a1 1 0 01.293.707V19a2 2 0 01-2 2z">
                            </path>
                        </svg>
                    </button>
                    <!-- Image Button -->
                    <button onclick="downloadImage('plot-s11', 's11_plot')" class="action-btn p-2 rounded-full"
                        data-tooltip="Download Image (PNG)">
                        <svg class="w-5 h-5 text-gray-600" fill="none" stroke="currentColor" viewBox="0 0 24 24">
                            <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2"
                                d="M3 9a2 2 0 012-2h.93a2 2 0 001.664-.89l.812-1.22A2 2 0 0110.07 4h3.86a2 2 0 011.664.89l.812 1.22A2 2 0 0018.07 7H19a2 2 0 012 2v9a2 2 0 01-2 2H5a2 2 0 01-2-2V9z">
                            </path>
                            <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2"
                                d="M15 13a3 3 0 11-6 0 3 3 0 016 0z"></path>
                        </svg>
                    </button>
                    <!-- Expand Button -->
                    <button onclick="toggleExpand('card-s11')" class="action-btn p-2 rounded-full"
                        data-tooltip="Expand View">
                        <svg class="toggle-icon w-5 h-5 text-gray-700" fill="none" stroke="currentColor"
                            viewBox="0 0 24 24">
                            <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2"
                                d="M4 8V4m0 0h4M4 4l5 5m11-1V4m0 0h-4m4 0l-5 5M4 16v4m0 0h4m-4 0l5-5m11 5l-5-5m5 5v-4m0 4h-4">
                            </path>
                        </svg>
                    </button>
                </div>
            </div>
            <div id="plot-s11" class="chart-container"></div>
        </div>

    </div>

    <script>

        // --- Data Placeholders ---
        const networkNames = {{ network_names }};
        const freqData = {{ frequency_data }}; // Array of arrays
        const s11Data = {{ s11_data }};

        // --- Tooltip Logic (Custom) ---
        const tooltip = document.createElement('div');
        tooltip.id = 'custom-tooltip';
        tooltip.className = 'fixed bg-gray-800 text-white text-xs rounded py-1 px-2 z-50 pointer-events-none hidden shadow-lg whitespace-nowrap';
        document.body.appendChild(tooltip);

        document.addEventListener('mouseover', e => {
            const target = e.target.closest('[data-tooltip]');
            if (target) {
                tooltip.textContent = target.dataset.tooltip;
                tooltip.classList.remove('hidden');

                const rect = target.getBoundingClientRect();

                // Wait for text to render to calculate width
                requestAnimationFrame(() => {
                    let left = rect.left + rect.width / 2 - tooltip.offsetWidth / 2;
                    let top = rect.bottom + 8;

                    // Edge detection
                    if (left + tooltip.offsetWidth > window.innerWidth - 10) {
                        left = window.innerWidth - tooltip.offsetWidth - 10;
                    }
                    if (left < 10) left = 10;

                    tooltip.style.left = `${left}px`;
                    tooltip.style.top = `${top}px`;
                });
            }
        });

        document.addEventListener('mouseout', e => {
            if (e.target.closest('[data-tooltip]')) {
                tooltip.classList.add('hidden');
            }
        });

        // --- Hover Mode Management ---
        const hoverModeMap = {
            'plot-s11': 'closest'
        };

        const HOVER_CYCLES = ['closest', 'x', 'y', false]; // false means disabled hover

        /**
         * Renders the appropriate SVG icon and updates the tooltip text.
         * @param {string} plotId The ID of the plot (e.g., 'plot-s11')
         * @param {string|false} mode The current Plotly hover mode or false
         */
        function updateHoverIcon(plotId, mode) {
            const iconContainer = document.getElementById(`hover-icon-${plotId}`);
            const button = document.getElementById(`hover-toggle-${plotId}`);
            let svgContent = '';
            let tooltipText = '';

            // Note: Setting stroke/fill/viewBox in the SVG tag itself
            switch (mode) {
                case 'closest':
                    tooltipText = 'Toggle Hover Mode: Nearest Point';
                    // Crosshair / Four-way arrow
                    svgContent = '<path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M4 12h16M12 4v16" />';
                    break;
                case 'x':
                    tooltipText = 'Toggle Hover Mode: X-Axis Lock';
                    // Horizontal Arrows (Move along X)
                    svgContent = '<path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M21 12H3M17 8l4 4-4 4M7 8l-4 4 4 4" />';
                    break;
                case 'y':
                    tooltipText = 'Toggle Hover Mode: Y-Axis Lock';
                    // Vertical Arrows (Move along Y)
                    svgContent = '<path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M12 21V3M8 17l4 4 4-4M8 7l4-4 4 4" />';
                    break;
                case false:
                default:
                    tooltipText = 'Toggle Hover Mode: Disabled';
                    // Eye off (Disabled) - Updated path to avoid clipping
                    svgContent = '<path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M3.98 8.223A10.477 10.477 0 001.934 12C3.226 16.338 7.244 19.5 12 19.5c.993 0 1.953-.138 2.863-.395M6.228 6.228A10.45 10.45 0 0112 4.5c4.756 0 8.773 3.162 10.065 7.498a10.523 10.523 0 01-4.293 5.774M6.228 6.228L3 3m3.228 3.228l3.65 3.65m7.894 7.894L21 21m-3.228-3.228l-3.65-3.65m0 0a3 3 0 10-4.243-4.243m4.242 4.242L9.88 9.88" />';
                    break;
            }

            iconContainer.innerHTML = svgContent;
            button.dataset.tooltip = tooltipText;

            // Re-render Plotly with the new mode
            const plotlyMode = mode === false ? false : mode; // Plotly uses 'false' or 'closest', 'x', 'y'
            Plotly.relayout(plotId, { hovermode: plotlyMode });
        }


        function toggleHoverMode(plotId) {
            const currentMode = hoverModeMap[plotId] === false ? 'off' : hoverModeMap[plotId];
            const currentIndex = HOVER_CYCLES.indexOf(currentMode);
            const nextIndex = (currentIndex + 1) % HOVER_CYCLES.length;
            const newMode = HOVER_CYCLES[nextIndex];

            hoverModeMap[plotId] = newMode;
            updateHoverIcon(plotId, newMode);
        }

        // --- Plotly Chart Generation ---
        const commonLayout = {
            margin: { t: 40, r: 10, b: 40, l: 60 },
            paper_bgcolor: 'rgba(0,0,0,0)',
            plot_bgcolor: 'rgba(0,0,0,0)',
            font: { family: 'Inter, sans-serif' },
            showlegend: true,
            legend: {
                x: 1, xanchor: 'right', y: 1, bgcolor: 'rgba(255,255,255,0.5)',
            },
            xaxis: {
                title: {
                    text: 'Frequency (GHz)'
                },
                gridcolor: '#e5e7eb',
                tickformat: 's',      // use SI prefixes (f, p, n, µ, m, k, M, G, T, etc.)
                exponentformat: 'SI', // use SI prefixes for hover text as well
            },
            yaxis: {
                title: {
                    text: 'Magnitude (dB)'
                },
                gridcolor: '#e5e7eb',
                range: [-40, 0]  // Fixed range for S11 return loss
            },
            title: { text: "S11 (dB) vs. Frequency (GHz)" },
            hovermode: 'closest' // Initial mode
        };
        const plotlyConfig = { responsive: true, displayModeBar: false };

        const fileTraceColors = [
            '#3b82f6', // Blue
            '#ef4444', // Red
            '#10b981', // Green
            '#f59e0b', // Amber
            '#6366f1', // Indigo
            '#ec4899', // Pink
            '#84cc16', // Lime
            '#06b6d4', // Cyan
            '#a855f7', // Purple
            '#fdba74', // Orange (Light)
            '#14b8a6', // Teal
            '#eab308', // Yellow
            '#f43f5e', // Rose
            '#8b5cf6', // Violet
            '#d946ef', // Fuchsia
        ];

        function createTraces(xDataArray, yDataArray, names) {
            return names.map((name, i) => {
                return {
                    x: xDataArray[i],
                    y: yDataArray[i],
                    mode: 'lines',
                    name: name,
                    line: { color: fileTraceColors[i % fileTraceColors.length], width: 2 }
                };
            });
        }

        // Create S11 plot
        Plotly.newPlot('plot-s11', createTraces(freqData, s11Data, networkNames), commonLayout, plotlyConfig);

        // --- Action Functions ---

        function resetZoom(divId) {
            Plotly.relayout(divId, {
                'xaxis.autorange': true,
                'yaxis.autorange': true
            });
        }

        function zoomPlot(divId, factor) {
            const gd = document.getElementById(divId);
            if (!gd || !gd._fullLayout) return;

            const xaxis = gd._fullLayout.xaxis;
            const yaxis = gd._fullLayout.yaxis;

            // Helper to zoom a range
            const getNewRange = (range, isLog) => {
                const min = range[0];
                const max = range[1];
                const center = (max + min) / 2;
                const span = max - min;
                const newSpan = span * factor;
                return [center - newSpan / 2, center + newSpan / 2];
            };

            const newX = getNewRange(xaxis.range, xaxis.type === 'log');
            const newY = getNewRange(yaxis.range, yaxis.type === 'log');

            Plotly.relayout(divId, {
                'xaxis.range': newX,
                'yaxis.range': newY,
                'xaxis.autorange': false,
                'yaxis.autorange': false
            });
        }

        function zoomIn(divId) { zoomPlot(divId, 0.7); }
        function zoomOut(divId) { zoomPlot(divId, 1.3); }

        function downloadImage(divId, filename) {
            const plot = document.getElementById(divId);
            Plotly.downloadImage(plot, {
                format: 'png',
                filename: filename,
                height: 800,
                width: 1200,
                scale: 2 // Retina quality
            });
        }

        function downloadCSV(divId, filename) {
            const plot = document.getElementById(divId);
            const data = plot.data;

            let csvContent = "data:text/csv;charset=utf-8,";

            // 1. Create Headers
            let headers = ["Frequency (Hz)"];
            data.forEach(trace => {
                headers.push(`Magnitude (dB) - ${trace.name}`);
            });
            csvContent += headers.join(",") + "\r\n";

            // 2. Add Rows
            const xValues = data[0].x;

            for (let i = 0; i < xValues.length; i++) {
                let row = [xValues[i]];
                data.forEach(trace => {
                    row.push(trace.y[i] !== undefined ? trace.y[i] : "");
                });
                csvContent += row.join(",") + "\r\n";
            }

            // 3. Trigger Download
            const encodedUri = encodeURI(csvContent);
            const link = document.createElement("a");
            link.setAttribute("href", encodedUri);
            link.setAttribute("download", filename + ".csv");
            document.body.appendChild(link);
            link.click();
            document.body.removeChild(link);
        }


        // --- Expansion Logic ---
        function toggleExpand(cardId) {
            const card = document.getElementById(cardId);
            const isExpanded = card.classList.contains('expanded');

            // Toggle expanded class
            if (isExpanded) {
                card.classList.remove('expanded');
            } else {
                card.classList.add('expanded');
            }

            // 3. Resize Chart after CSS transition
            setTimeout(() => {
                const plotDiv = card.querySelector('.chart-container');
                Plotly.Plots.resize(plotDiv);
            }, 450);
        }

        // Handle window resize
        window.addEventListener('resize', () => {
            Plotly.Plots.resize('plot-s11');
        });
    </script>
</body>

</html>