Geopsy: Custom ASCII formats - Revision history

Marc: /* Editing an existing format */

2022-11-21T14:16:21Z

Editing an existing format

Marc: /* Editing an existing format */

2022-11-21T14:15:56Z

Editing an existing format

Marc: /* Time format */

2022-11-21T13:33:19Z

Time format

Marc: /* Component table */

2022-11-21T13:32:52Z

Component table

Marc: /* Component table */

2022-11-21T13:31:54Z

Component table

Marc: /* Rules */

2022-11-21T13:31:23Z

Rules

Marc: /* Rules */

2022-11-21T13:29:30Z

Rules

Marc: /* Rules */

2022-11-21T13:28:35Z

Rules

Marc: /* Creating a new format */

2022-11-21T13:18:34Z

Creating a new format

Marc: /* Introduction */

2022-11-21T13:10:34Z

Introduction

@@ Line 80: / Line 80: @@
 == Editing an existing format ==
-It works the same way as for the creation of a new format. Select it in the list, click on ''Edit'', edit the attributes and click on ''Ok'' from the editor dialog box. Changes are committed to the main internal list only after clicking on ''Ok'' from the list dialog box.
+It works the same way as for the creation of a new format. Select it in the list, click on ''Edit'', edit the attributes and click on ''OK'' from the editor dialog box. Changes are committed to the main internal list only after clicking on ''OK'' from the list dialog box.
 == Examples ==

@@ Line 80: / Line 80: @@
 == Editing an existing format ==
-It works the same way as for the creation of a new format. Select it in the list, click on ''Edit'',edit the attributes and click on ''Ok'' from the editor dialog box. Changes are committed to the main internal list only after clicking on ''Ok'' from the list dialog box.
+It works the same way as for the creation of a new format. Select it in the list, click on ''Edit'', edit the attributes and click on ''Ok'' from the editor dialog box. Changes are committed to the main internal list only after clicking on ''Ok'' from the list dialog box.
 == Examples ==

@@ Line 76: / Line 76: @@
 === Time format ===
-Time format is used by any rule that deals with ''TimeReference'' or if you specify a ''Time'' column (see above section). The specification of time and date is described in [[Time and date specification]].
+Time format is used by any rule that deals with ''StartTime'' or if you specify a ''Time'' column (see above section). The specification of time and date is described in [[Time and date specification]].
 == Editing an existing format ==

@@ Line 72: / Line 72: @@
 === Component table ===
-The component table is a look-up table to translate values assigned to ''Component'' (see above section about ''Rules'') into standard components. Among them there are two special types: ''Ignore'' and ''Time''. If the first one is used, the text column is simply ignored. If ''Time'' is used, ''T0'', ''TimeReference'' and ''SamplingFrequency'' are deduced from sample time stamps.
+The component table is a look-up table to translate values assigned to ''Component'' (see above section about ''Rules'') into standard components. Among them there are two special types: ''Ignore'' and ''Time''. If the first one is used, the text column is simply ignored. If ''Time'' is used, ''StartTime'' and ''SamplingFrequency'' are deduced from sample time stamps.
 === Time format ===

@@ Line 72: / Line 72: @@
 === Component table ===
-The component table is a look-up table to translate values assigned to ''Component'' (see above section about ''Rules'') into standard components. Among them there are two special types: ''Ignore'' and ''Time''. If the first one is used the text column is simply ignored. If ''Time'' is used, ''T0'', ''TimeReference'' and ''SamplingFrequency'' are deduced from sample time stamps.
+The component table is a look-up table to translate values assigned to ''Component'' (see above section about ''Rules'') into standard components. Among them there are two special types: ''Ignore'' and ''Time''. If the first one is used, the text column is simply ignored. If ''Time'' is used, ''T0'', ''TimeReference'' and ''SamplingFrequency'' are deduced from sample time stamps.
 === Time format ===

@@ Line 68: / Line 68: @@
    Time     Long.,g    Tran.,g     Vert.,g
-The same pattern is used N times, with N being the number of interesting channels. For each ''Channel'', there is a corresponding pattern ''Index''. The obtained value is then translated into a standard component with the look-up table describe here below.
+The same pattern is used N times, with N being the number of interesting channels. For each ''Channel'', there is a corresponding pattern ''Index''. The obtained value is then translated into a standard component with the look-up table described hereinafter.
 === Component table ===

@@ Line 58: / Line 58: @@
 For variable rules, ''Value'' is defined according to the pattern and its captured texts. Captured texts are all expressions of the pattern within parenthesis. ''Index'' indicates which captured text has to be assigned to ''Value''. If ''Index'' (right after ''Pattern'') is 0, the whole pattern match is returned in ''Value''. ''Mandatory'' flag is to issue warnings to the user when loading a file without the requested information and also to automatically recognize the file format based on the file content. ''Factor'' can be enventually used to correct the obtained value (only for numerical values). The second ''Index'' right after ''Data'' is designed for data fields which support indexes (e.g. ''TimePick'').
-The above figure shows the rules defined for format GeoSIG. Values for ''Component'' data are handled in a particular way. The value, either constant or captured from the pattern, is translated to a standard component thanks to a look-up table descrided in the next section. This table can be also used to ignore some columns or to specify a ''Time'' column. The later is for formats that do not provide explicit information about the starting time in the header, instead they provide one time stamp per sample.
+The above figure shows the rules defined for format GeoSIG. Values for ''Component'' data are handled in a particular way. The value, either constant or captured from the pattern, is translated to a standard component thanks to a look-up table descrided in the next section. This table can be also used to ignore some columns or to specify a ''Time'' column. The latter is for formats that do not provide explicit information about the starting time in the header, instead they provide one time stamp per sample.
 In this example the pattern for ''Component'' identification is

@@ Line 13: / Line 13: @@
 [[Image:CustomASCIIFormatEditor.png|thumb|left|300px|Custom ASCII format editor]]
-If there are already some formats in the list, select the closest to the new one you are going to create. All the attributes of this model format are loaded.
+If there are already some formats in the list, select the closest to the new one you are going to create, before clicking on ''New''. All the attributes of this model format are loaded.
 To ease adjustment of attributes of a format specification it is easier to work on a file example. Enter a file name in ''File example'' or click on the browse ("...") button on the right side of the ''Example'' field. There is also a ''Load'' button to run the file loader with the current Custom ASCII format on the example file. The log view is showing a detailed report with more verbosity than usual file load. Revise this report carefully, even if there are no critical error, there might be some warnings about undefined header data.

@@ Line 3: / Line 3: @@
 [[Image:CustomASCIIFormats.png|thumb|right|200px|Custom ASCII format dialog box]]
-Geopsy allows you to load ASCII signal files with a custom header, assigning automatically header information when loading the signal. In order to manage the header formats, go to [[Geopsy: Preferences|Geopsy Preferences]], tab ''Load'', box ''File Format'' and push the button ''Custom ASCII format''.
+Geopsy allows you to load ASCII signal files with a custom header, automatically assigning header information when loading the signal. In order to manage the header formats, go to [[Geopsy: Preferences|Geopsy Preferences]], tab ''Load'', box ''File Format'' and push the button ''Custom ASCII format''.
 A list of custom formats is maintained and stored in the general [[User settings|user settings]]. These formats are included in the list of accepted formats for [[Geopsy: Supported file formats#Automatic recognition|''automatic recognition'']] and for importation. They cannot be used for export.