Released Executables for tschk2 Version 2.0.1

INTRODUCTION

The tschk2 program is the official parser for the Touchstone 2.0 specification. Standalone executables are provided free of charge by the IBIS Open Forum. Contact tschk@ibis.org for information or to report bugs. You must download these in a manner allowing you to run the executables with required command line arguments. No installer is provided.

Downloading any of the files below indicates your acceptance of the IBIS Binary Code License:

IBIS Binary Code License

Copyright 2021 IBIS Open Forum, SAE ITC

Redistribution and use in unmodified binary form only are permitted provided that
the following conditions are met:

1. Redistributions in binary form must reproduce the above copyright notice, this
   list of conditions and the following disclaimer in the documentation and/or
   other materials provided with the distribution.

2. Reverse engineering is prohibited.

3. Neither the name of the copyright holder nor the names of its contributors
   may be used to endorse or promote products derived from this software without
   specific prior written permission.

THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND
ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR
ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
(INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON
ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

EXECUTABLES

Each link below will download a zip archive containing the selected executable(s) as well as the license agreement file, which must be copied along with the executables in any redistribution. Executables for tschk2 are available for the following platforms:

The full set of executables is available in one ZIP archive tschk201_all.zip.

NOTE 1: Compliant Touchstone files must be ASCII encoded. It has been found that redirecting the output of tschk2 in Windows PowerShell to convert file formats will result in Unicode files, which will fail a subsequent tschk2 check. On Windows, cmd or cygwin shells are recommended for executing tschk2.

NOTE 2: The executable files are not digitally signed. Steps may be required in your operating system to allow them to run.

SHA1 digests are shown below for checking the integrity of each official executables above. Unzip the contents of the ZIP file(s) and save the SHA1 checksum file tschk201_sha1.txt (contents shown below). Then run "sha1sum -c tschk201_sha1.txt". The report for each file should be "ok" (may need Unix, Linux, or Cygwin):

90526c8d1839d8655b2f2fb1a7ed802409c8e57e  tschk201_deb10_64/tschk2
dfc95fe6f8750f6aa7153531c7451828c44e7ec9  tschk201_maca_64/tschk2
c9750f2491a651a180f143f95b7bf08f5063d7f9  tschk201_maci_64/tschk2
0213ea7e861465f96bc1f7d4b27df130b9804db0  tschk201_rhel7_64/tschk2
b09229022a6ec9a4f16e19085f0eb215cd8f809e  tschk201_win_32/tschk2.exe
7a5025bd105e62d2cb641bb01d8e00f2ea9ddce3  tschk201_win_64/tschk2.exe

SOURCE CODE LICENSE

Contact the IBIS Chair if you need the source code. It is priced at $1,000.00. See the license terms below:

TSCHK2 DOCUMENTATION

When “tschk2” is run with the -help argument, TSCHK2 prints this help message:

tschk2, version 2.0.1
verification tool for Touchstone v2 files

Usage modes:

  tschk2 FILE                          Checks the file, sending error and warning
                                       information to stderr.

  tschk2 -canonical     FILE  Shortcut for -canonical-v2.

  tschk2 -canonical-v2  FILE  Checks the file, sending error and warning
                                       information to stderr, and writes a valid file
                                       to stdout in Touchstone v2 format.

  tschk2 -canonical-v1  FILE  Checks the file, sending error and warning
                                       information to stderr, and writes a valid file
                                       to stdout in Touchstone v1 format, if possible.

  tschk2 -describe FILE                Checks the file, sending error and warning
                                       information to stderr, and writes a valid file
                                       to stdout in a long-form description.

  tschk2 -version                      Displays the version number.

  tschk2 -help                         Displays this help message.

Canonical output options:

  -freq-precision freqDigits           Set precision of frequency column in canonical
                                       network parameters output.
                                       Set to 0 to calculate precision based on precision
                                       of inputs.
                                       Default: 15 digits

  -data-precision dataDigits           Set precision of data columns in canonical
                                       network parameters output.
                                       Set to 0 to calculate precision based on precision
                                       of inputs.
                                       Default: calculate precision from inputs

  -spacing aligned|compact             Set spacing to 'aligned' to produce output with
                                       network parameter values arranged in aligned columns.
                                       Set spacing to 'compact' to produce output with
                                       minimal length network parameter values, separated by
                                       single spaces.
                                       Default: aligned

One (and only one) file name argument must be provided to perform checking. Examples of output using different output options are available here.

TSCHK2 BUGS AND ENHANCEMENTS

Version 2.0.1 of tschk2 supports Touchstone 2.0 and Touchstone 1.0.

See the TSCHK BUG page for full details on bug history, or to report a bug or enhancement.

Copyright © 2023
Last edited: February 15, 2023