Ultrasonic Pulse Transmission Tests: Datasets - Test Series 6, Reference Tests on Water

Technical description Ultrasonic Pulse Transmission Tests: Datasets — Test Series 6, Reference Tests on Water Jakob Harden† †Graz University of Technology, Graz, Austria Corresponding author email: [email protected] 2023-07-14 Abstract The test series was created in order to validate the stability and functionality of the test device and to create a data reference for liquid materials (water). The approach for the test series was to vary the parameters number-of-samples-recorded, pulse-voltage and distance-between-actuator-and-sensor. This results in a three-dimensional test parameter grid. Tests were performed several times for each grid point (numberof-samples-recorded versus pulse-voltage versus distance-between-actuator-and-sensor) in order to receive statistical information about the stability of the test results. The material tested was water from the tap of the laboratory water supply system. The test method used was the ultrasonic pulse transmission method with combined compressionand shear wave measurements. All test data and metadata are summarized into datasets using GNU Octave’s open binary file format. 1 Introduction This document provides a technical description of the datasets of a series of ultrasonic pulse transmission tests (UPTT) performed in the course of the PhD thesis of the author of this document (see title page). This test series was performed to create a data reference for liquid materials (water). The test series design is based on the variation of three different parameters. The number-of-samples-recorded N= [16k, 24k, 33k, 50k], the pulsevoltage V= [400,600,800] Volts and the distance-between-actuator-and-sensor D= [25,50,70,90] millimetres. This results in a three-dimensional parameter grid. For each grid point (N, V, D), tests were carried out several times to gain information about the stability of the tests. The result is a collection of 60 datasets containing the measurement data of the UPTT’s. The test device used for the UPTT’s is the FreshCon[1] device (developed at the University of Stuttgart, Germany). An elaborate description of test devices, the material and the test operation procedures is stored in the data set structure along with the measurement results. This record is published to allow other researchers to make use of it. In particular, those who have no access to the required laboratory facilities and test equipment. To allow others to make use of these datasets freely, an open license was chosen by the author (Creative Commons 4.0 Attribution, CC-BY-4.0). 2 Record content The repository record consists of the following three files: •ts6_techdescr.pdf contains the technical description (this file). •ts6_rawdata.tar.xz contains the raw measurement data. This compressed TAR archive consists of a set of ZIP archives enlisted in table 8 in section Appendix - Tables. The content of the ZIP archives is described in section 3. •ts6_datasets.tar.xz contains the datasets compiled from the raw measurement data. This compressed TAR archive consists of a set of binary files (*.oct, open GNU octave binary format) enlisted in table 9 in section Appendix - Tables. The structure of the content of each data set is described in section 4 in detail. Extracting data set files from compressed TAR archives: Under Linux the content of the compressed TAR archives can easily be extracted with the command line tool “tar”[2] on the “bash”[3] command prompt. On Microsoft Windows one may use “7zip”[4] instead. $ tar -xf <filename>.tar.xz CC-BY-4.0 Jakob Harden 1 Technical description Data integrity: To ensure the integrity of the files contained in the compressed TAR archives, the SHA256 checksum is also provided along with the files. See second column in tables 8 and 9 in section Tables. Check the integrity of a file with “sha256sum”[5] at the “bash” command prompt. $ echo "<sha256_checksum> <filename>" > checkfile.txt $ sha256sum --check checkfile.txt File name convention, data set code: The variation of the test series parameters is also reflected in the file names. The file names are a concatenation of the test-series-id <T>, the distance-between-actuator-andsensor <D> in millimetres, the number-of-samples-recorded (recording block size) <N> in kilo-samples and the pulse voltage <V> in Volts. Filename structure: <T>_d<D>_b<N>_v<V>.oct. As example, a test performed with D= 50 mm, N= 16ksamples and V= 800 Volts is stored in ts6_d50_b16_v800.oct. The name of the corresponding raw data archive is ts6_d50_b16_v800.zip. Here it is to mention, that the tests with D= 90 mm were carried out twice. That is denoted in the file names with the suffix _1 and _2. Licensing: The contents of the repository entry published under the DOI 10.3217/hn7we-q7z09 are made available under the open Creative Commons 4.0 Attribution license (CC-BY-4.0). This applies to the files ts6_rawdata.tar.xz,ts6_datasets.tar.xz,ts6_techdescr.pdf and their contents. A full description of the license terms is available at the following URL: https://creativecommons.org/licenses/by/4.0/. 3 Raw data archive structure Each data set in the raw data archive ts6_rawdata.tar.xz is represented by a ZIP archive. The directories and files contained in the archive files are enlisted in table 1. L C Path Type Description 0 1 <datasetcode> directory data set directory 1 1 projinfo.txt plain text file metadata and information about additional tests 1 1 Channel 1 directory compression wave measurement data 2 1 ../measurements.txt plain text file list of signal filenames and recording timestamp 2 1 ../settings.txt plain text file device and measurement settings 2 N ../tst<num>.dat plain text files signal data of compression wave measurements 1 1 Channel 2 directory shear wave measurement data 2 1 ../measurements.txt plain text file list of signal filenames and recording timestamp 2 1 ../settings.txt plain text file device and measurement settings 2 N ../tst<num>.dat plain text files signal data of shear wave measurements Table 1: Raw data directoryand file structure (ZIP archives). L . . . directory level; C . . . cardinality. 4 Data set binary file structure Each data set in the data set archive ts6_datasets.tar.xz is represented by a OCT file (<filename>.oct). They were generated from raw data consisting of plain text files (see also 3). Therefore, GNU Octave 6.2.0[6] command scripts were used. The result of the conversion process are datasets available in GNU Octave’s open binary file format. The data in the datasets is organized in a C-like hierarchical data structure. That structure consists of several structural levels. The top structural level serves to classify the data according to individual thematic areas. The metadata and data of the measurement results are stored in the lower structure levels. To be able to display the data and metadata as simply as possible, sub-structures are used, which are referred to here as “atomic elements” and represent the lowest structural level of the data. There are three defined types of atomic elements: the atomic reference element (ARE), the atomic attribute element (AAE) and the atomic data element (ADE). All atomic elements consist of simple structure fields that hold the data. 4.1 Atomic elements Atomic reference element (ARE): Atomic reference elements are used to link objects to each other. This is to avoid copies of recurring content (e.g. for a specimen used in several subsidiary tests). They consist of a set of fields enlisted in table 2. CC-BY-4.0 Jakob Harden 2 Technical description Field Description Data type obj object type (always "ARE") string ver version number [major, minor] uint16 t tag, a descriptive name string i referenced id uint, [uint] r referenced object name {string} d description string Table 2: Field list of atomic reference elements (ARE) Atomic attribute element (AAE): Atomic attribute elements are used to store text only (e.g. additional description of the parent data structure). They consist of a set of fields enlisted in table 3. Field Description Data type obj object type (always "AAE") string ver version number [Major, Minor] [uint16] t tag, a descriptive name string v value, text string, {string} d description string Table 3: Field list of atomic attribute elements (AAE) Atomic data element (AAE): Atomic data elements are used to store values in combination with value type and physical unit (e.g. measurement data). They consist of a set of fields enlisted in table 4. The value type enumerators stored in field “vt” are enlisted in table 6 in section Appendix - Tables. Field Description Data type obj object type (always "ADE") string ver version number [Major, Minor] [uint16] t tag, a descriptive name string vt value type enumerator string v value of given value type depends on value type u unit string d description string Table 4: Field list of atomic data elements (ADE) 4.2 Data set structure hierarchy The hierarchy of the data structure consists of top-level substructures containing various atomic elements or other lower-level substructures (e.g. ds.tst, test collection). A list of main substructures is shown in table 5. A more detailed description of the structure hierarchy is shown in table 7 in section Appendix - Tables. CC-BY-4.0 Jakob Harden 3 Technical description L C Path Description 0 1 ds structure root 1 1 ds.meta_ser test series metadata 1 1 ds.meta_set data set metadata 1 N ds.loc geo-location information, GPS coordinates 1 1 ds.lic license information 1 N ds.aut author information 1 N ds.dev test device information 1 N ds.mat test material information 1 N ds.spm test specimen information, specimen I and II 1 1 ds.tst test collection 2 1 ds.tst.s04 ultrasonic measurement distance, specimen I 2 1 ds.tst.s05 ultrasonic measurement distance, specimen II 2 1 ds.tst.s06 ultrasonic pulse transmission test (compression wave), specimen I 2 1 ds.tst.s07 ultrasonic pulse transmission test (shear wave), specimen II 2 1 ds.tst.s09 environment temperature Table 5: Main substructures. L . . . hierarchy level; C . . . cardinality. 4.3 Accessing items of the hierarchical data structure To access the data and metadata in the hierarchical data structure, the file need to be loaded into memory first. Then, the structure handling commands of GNU Octave can be used to access single items. To illustrate the process, some typical application examples using the GNU Octave command line interface are given below. Load data set: Load data set and store the result in variable ds. octave: >>> ds = load(’/path/to/dataset/file.oct’, ’dataset’).dataset; Accessing items: The following commands store the signal data of all compression wave signals in variable s1 and all shear wave signals in variable s2. All other elements can be accessed in the same way. A detailed list of available structure elements is shown in table 7 in section Appendix - Tables. octave: >>> s1 = ds.tst.s06.d13.v; octave: >>> s2 = ds.tst.s07.d13.v; References [1] Smartmote. Smartmote - FreshCon. July 14, 2023. url:http : / / www . smartmote . de / joomla / de / produkte/~ultraschall/9-produkte/19-neptun-webservices-5. [2] die.net. tar(1) - Linux man page. July 14, 2023. url:https://linux.die.net/man/1/tar. [3] die.net. bash(1) - Linux man page. July 14, 2023. url:https://linux.die.net/man/1/bash. [4] www.7 zip.org. 7zip download. July 14, 2023. url:https://www.7-zip.org/download.html. [5] die.net. sha256sum(1) - Linux man page. July 14, 2023. url:https://linux.die.net/man/1/sha256sum. [6] John W. Eaton et.al. GNU Octave - Scientific Programming Language. July 14, 2023. url:https:// octave.org/. CC-BY-4.0 Jakob Harden 4 Technical description Appendix - Tables Data type Description string character array, character = 8 bit string_arr 1D cell array (vector) of strings string_mat 2D cell array (matrix) of string boolean unsigned integer, 8 bit boolean_arr 1D array (vector) of type boolean boolean_mat 2D array (matrix) of type boolean uint unsigned integer uint_arr 1D array (vector) of type uint uint_mat 2D array (matrix) of type uint int signed integer int_arr 1D array (vector) of type int int_mat 2D array (matrix) of type int single single precision floating point number, 32 bit single_arr 1D array (vector) of type single single_mat 2D array (matrix) of type single double double precision floating point value, 64 bit double_arr 1D array (vector) of type double double_mat 2D array (matrix) of type double Table 6: Value types for atomic data elements (ADE) CC-BY-4.0 Jakob Harden 5 Technical description Table 7: Detailed overview of the hierarchical structure of the datasets (*.oct files). Path Type Tag Description ds struct_dataset — structure root ds.meta_ser struct_metaser — substructure ds.meta_ser.r01 ARE author author reference ds.meta_ser.r02 ARE license license reference ds.meta_ser.d01 ADE series_id test series id ds.meta_ser.a01 AAE series_code test series code ds.meta_ser.a02 AAE series_name test series name ds.meta_ser.a03 AAE description test series description ds.meta_ser.a04 AAE abstract test series abstract ds.meta_ser.a05 AAE context test series context ds.meta_ser.a06 AAE date_start test series start date ds.meta_ser.a07 AAE date_end test series end date ds.meta_set struct_metaset — substructure ds.meta_set.r01 ARE author author reference ds.meta_set.r02 ARE series test series reference ds.meta_set.r03 ARE location location reference ds.meta_set.r04 ARE license license reference ds.meta_set.d01 ADE dataset_id data set id ds.meta_set.a01 AAE dataset_code data set code ds.meta_set.a02 AAE dataset_name data set name ds.meta_set.a03 AAE description description, general ds.meta_set.a04 AAE description_abstract description, abstract ds.meta_set.a05 AAE description_methods description, methods ds.meta_set.a06 AAE description_tableofcontents description, tableofcontents ds.meta_set.a07 AAE created_by data set creator name ds.meta_set.a08 AAE collected_by data set collector name ds.meta_set.a09 AAE copyrighted_by data set copyrighter name ds.meta_set.a10 AAE date_created date created Continued on next page CC-BY-4.0 Jakob Harden 6 Technical description Table7 – continued from previous page Path Type Tag Description ds.meta_set.a11 AAE date_collected date collected ds.meta_set.a12 AAE date_copyrighted date copyrighted ds.meta_set.a13 AAE size data set size, number of files ds.meta_set.a14 AAE format data set file format ds.meta_set.a15 AAE version data set version ds.meta_set.a16 AAE context data set context ds.meta_set.a17 AAE rawdata_directory data set rawdata directory ds.meta_set.a18 AAE rawdata_archive data set rawdata archive ds.loc struct_loc — substructure array ds.loc.d01 ADE location_id location id ds.loc.d02 ADE geolocation geo location, latitude, longitude ds.loc.a01 AAE country country ds.loc.a02 AAE state_province state or province ds.loc.a03 AAE city city ds.loc.a04 AAE zipcode zip code, postal code ds.loc.a05 AAE street street name ds.loc.a06 AAE housenumber house number ds.loc.a07 AAE description location description ds.lic struct_lic — substructure ds.lic.r01 ARE author author reference ds.lic.d01 ADE license_id license id ds.lic.a01 AAE license_code license code ds.lic.a02 AAE rightsholder rights holder ds.lic.a03 AAE rights rights description, e.g. Creative Commons Attribution 4.0 International ds.lic.a04 AAE rights_uri rights URI, e.g. https://spdx.org/licenses/CC-BY-4.0.html ds.lic.a05 AAE rights_identifier_scheme rights identifier scheme, e.g. SPDX ds.lic.a06 AAE rights_identifier_scheme_uri rights identifier scheme URI, e.g. https://spdx.org/licenses/ ds.lic.a07 AAE license_description license description ds.lic.a08 AAE spdx_icon license icon (spdx) ds.lic.a09 AAE spdx_id license id (spdx) Continued on next page CC-BY-4.0 Jakob Harden 7 Technical description Table7 – continued from previous page Path Type Tag Description ds.aut struct_aut — substructure ds.aut.d01 ADE author_id author id ds.aut.a01 AAE name full name ds.aut.a02 AAE givenname given name, first name ds.aut.a03 AAE familyname family name, surname ds.aut.a04 AAE initials initials ds.aut.a05 AAE title_pfx title before the name (prefix) ds.aut.a06 AAE title_sfx title behind the name (suffix) ds.aut.a07 AAE organization organization name ds.aut.a08 AAE department department name ds.aut.a09 AAE role role in organization/department ds.aut.a10 AAE country country ds.aut.a11 AAE state_province state or province ds.aut.a12 AAE city city name ds.aut.a13 AAE zipcode zip code, postal code ds.aut.a14 AAE street street name ds.aut.a15 AAE email email address ds.aut.a16 AAE name_identifier_type name identifier type, e.g. ORCID ds.aut.a17 AAE name_identifier_type_uri name identifier type uri, e.g. https://orcid.org/ ds.aut.a18 AAE name_identifier name identifier, e.g. ORCID id ds.aut.a19 AAE description author description ds.dev struct_dev — substructure array ds.dev.d01 ADE device_id device id ds.dev.a01 AAE name device name ds.dev.a02 AAE vendor vendor name ds.dev.a03 AAE product product name ds.dev.a04 AAE category device category ds.dev.a05 AAE usage device usage ds.dev.a06 AAE description device description ds.dev.s01 ADE data_array array contains 7 elements Continued on next page CC-BY-4.0 Jakob Harden 8 Technical description Table7 – continued from previous page Path Type Tag Description ds.mat struct_mat — substructure array ds.mat.d01 ADE material_id material id ds.mat.a01 AAE name material name ds.mat.a02 AAE vendor vendor name ds.mat.a03 AAE product product name ds.mat.a04 AAE category material category ds.mat.a05 AAE description material description ds.mat.a06 AAE storage_place material storage place ds.mat.a07 AAE storage_condition material storage condition ds.spm struct_spm_ref — substructure array ds.spm.r01 ARE author author reference ds.spm.r02 ARE material material reference ds.spm.r03 ARE device device reference ds.spm.r04 ARE location location reference ds.spm.d01 ADE specimen_id specimen id ds.spm.d02 ADE datetime date and time, seconds since epoch (UTC) ds.spm.a01 AAE specimen_code specimen code ds.spm.a02 AAE operator operator name ds.spm.a03 AAE procedure procedure description ds.spm.a04 AAE description general description ds.tst struct_test — substructure ds.tst.s04 struct_test_umd2 — substructure ds.tst.s04.r01 ARE author author reference ds.tst.s04.r02 ARE specimen specimen reference ds.tst.s04.r03 ARE device device reference ds.tst.s04.r04 ARE location location reference ds.tst.s04.d01 ADE datetime date and time, seconds since epoch (UTC) ds.tst.s04.d04 ADE specimen_thickness distance between actuator and sensor ds.tst.s04.a01 AAE testname test name ds.tst.s04.a02 AAE operator operator name Continued on next page CC-BY-4.0 Jakob Harden 9 Technical description Table9 – continued from previous page File name SHA256 checksum ts6_d70_b24_v800.oct 0dc3798dc2b67723bd20a0b51496c0e2652df02a1be22907fb3c0148f0e6719d ts6_d70_b33_v400.oct d545970c93c245e6e49673c3ed8cf3541dc88770c33f8526b00c986f3da3dc0a ts6_d70_b33_v600.oct 6552bacd5a20e009da73ad10d3211d5b6fb057a1ba096f1d9e7881470c910ccc ts6_d70_b33_v800.oct 55f53bd879195119acad78f96af5755202d6abad673dcd16ccbd82889b2c3328 ts6_d70_b50_v400.oct e62523dfe621300fab6fa1efbeb1eca93ae1b6a028c020aec1429788b020274f ts6_d70_b50_v600.oct 5de119bcd8e407eac8d132ef8e6faf4bdda0e03bcf454fb35d7bcbbba7bbd308 ts6_d70_b50_v800.oct 4a57eacd48f5883358361c3791ac1f8f185442aedca941805c08361c2bd62067 ts6_d90_b16_v400_1.oct 54877eef13d2d98dba64650ea9e0ea50e7225cb8eee58486f9deea5643a9cfd4 ts6_d90_b16_v400_2.oct 56e120d4168c2e16411f5b7bb009a4c6a394b28e821fbb50327265015d7d1870 ts6_d90_b16_v600_1.oct 40774d80cca7e8abca3a55437da92f45add513b9654c52288973cf5961fb6209 ts6_d90_b16_v600_2.oct b7416374866025d9585c1cd7dd4801ac7916e99ef79eabee8b05199b883539f7 ts6_d90_b16_v800_1.oct d9b30dbd698866983db2bf81907efc5d8437388366a89a7a546e0eb69b6f8318 ts6_d90_b16_v800_2.oct f19e393ae8ab5530e9a8eb7e0a7d33556cf7e9df267ca1326ecc73b607098f66 ts6_d90_b24_v400_1.oct f4659914855240a41706ca158b5ae6fedfcfac27b4b728fa8407b85d1a32b9b8 ts6_d90_b24_v400_2.oct c9ba682e4aeeeff929f2a518019c307c25eace71b10cfa51049d5e869baeab0c ts6_d90_b24_v600_1.oct 94373a37507c556f8493f99798aaf2ecacbd0a3b4754f2da6176823a2ebd1611 ts6_d90_b24_v600_2.oct 9896eccb461e6c9399388f70f428975bb6c8a2f3aaffe6786fb9e46129275033 ts6_d90_b24_v800_1.oct e93a12be2f8d425d51f6e2bb61a7206f91461254d7d4a40afd5e90d35eb5e5ae ts6_d90_b24_v800_2.oct c8a03c3b64ab27e16c028d417a58edddcba491326dcff1484116596716883078 ts6_d90_b33_v400_1.oct cab7dc002404b8e773b5e16a74ddee3081247698ed843d05a35f33f0e82bbb32 ts6_d90_b33_v400_2.oct 701b40b1777f8ebf7272de3f5b39b6bd6ed18c9687c7ec2aec3c80d80c1eeaa6 ts6_d90_b33_v600_1.oct 3869f70afe540ff3790c1337d008f982a01faa4b26f832fd22d7a7db47c634ca ts6_d90_b33_v600_2.oct 38859740c616cc50a848536fb53be106c30fbb6bf0fdb696e2935198796fb02c ts6_d90_b33_v800_1.oct fe41028ce78c53dd7397eda18b232bdb67de1ad1d1f5134992fd26d5f850ce8f ts6_d90_b33_v800_2.oct 008b5098316d9ea8cab5df05ccc1885ca7a4ddaea0362d4bf3e1cd487b8feeca ts6_d90_b50_v400_1.oct 4a6e6b4445f048bb1b7fa12e93bbea8808b7a85c50421a983ffacfb0b56779a0 ts6_d90_b50_v400_2.oct 8d8b93b4563436601af9be092cb2c789b7d84164798951fc2dec6c41675d7877 ts6_d90_b50_v600_1.oct 2e0bb4b84e5ddeb75cbfca362df2eec4ad443262ca5a8d0c7dc8a1239afd1b8d ts6_d90_b50_v600_2.oct 8e2d8cc85fa45d17c679e2fee5bf79e4c5f3b01a0edeeaa35e589b05b4a2d49c ts6_d90_b50_v800_1.oct 77f60f4e2aaefd16f3dc591bb78b1e143a8799e9215b0b21b11a71dc1f82a9ce ts6_d90_b50_v800_2.oct c16ca86eef355822f6a1da6fbb8255f7442b5432f0c879052333a4f96431a41b CC-BY-4.0 Jakob Harden 16