Released Executables for tschk2 Version 2.1.0

INTRODUCTION

The tschk2 program is the official parser for the Touchstone 2.1 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 tschk210_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 tschk210_sha1.txt (contents shown below). Then run "sha1sum -c tschk210_sha1.txt". The report for each file should be "ok" (may need Unix, Linux, or Cygwin):

239eea3f73be2a92f31c3263dbfa2dacf50cb005  tschk210_linux_ubuntu_64/tschk2
194f073416c0621e910522703d5e2cccaa61dd08  tschk210_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.1.0
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.0 or V2.1 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.0 or V1.1 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.

Previous versions of tschk2 executables exist under:

TSCHK2 BUGS AND ENHANCEMENTS

Version 2.1.0 of tschk2 supports Touchstone 2.1, 2.0, 1.1 and 1.0.

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

Copyright © 2024 IBIS Open Forum
Last edited: April 15, 2023