Geopsy: Database - Revision history

Marc: /* Internal database structure */

2020-04-30T10:59:28Z

Internal database structure

Admin: /* Internal database structure */

2015-02-04T09:51:47Z

Internal database structure

Admin: /* Internal database structure */

2015-02-04T09:49:57Z

Internal database structure

Admin: /* Internal database structure */

2015-02-04T09:40:15Z

Internal database structure

Admin: /* Internal database structure */

2015-02-04T09:36:18Z

Internal database structure

Marc: /* Internal database structure */

2011-09-16T15:22:35Z

Internal database structure

Marc: /* Internal database structure */

2011-09-16T15:21:48Z

Internal database structure

Marc: /* Internal database structure */

2011-09-16T15:14:55Z

Internal database structure

Sylvette Thomassin: /* Database file structure */

2010-03-12T15:06:11Z

Database file structure

Marc: /* Database file structure */

2010-03-12T14:56:30Z

Database file structure

@@ Line 84: / Line 84: @@
 |IsOriginalFile
 |string
-|<span id="Field:IsOriginalFile">Contains "Original" if the signal samples have not been affected by any signal processing. Otherwise, the field is blank. See saving a database for details. This value is read-only</span>
+|<span id="Field:IsOriginalFile">Contains "Original" if the signal samples come from an imported file. Otherwise, the field contains "processed". See saving a database for details. This value is read-only</span>
 |-
 |MatlabVariableName

@@ Line 86: / Line 86: @@
 |<span id="Field:IsOriginalFile">Contains "Original" if the signal samples have not been affected by any signal processing. Otherwise, the field is blank. See saving a database for details. This value is read-only</span>
 |-
-|'''MatlabVariableName'''
+|MatlabVariableName
 |string
 |<span id="Field:MatlabVariableName">For signals loaded from a Matlab file, this field contains the name of the Matlab variable.</span>
@@ Line 106: / Line 106: @@
 |<span id="Field:NumberInFile">A signal file may contain various signals. This parameter is this index of this signal in its file. This parameter is read-only.</span>
 |-
-|'''OriginalFileName'''
+|OriginalFileName
 |string
 |<span id="Field:OrignialFileName">The original file name as recorded by the acquisition device.</span>
@@ Line 150: / Line 150: @@
 |<span id="Field:Source">The coordinates of the source for which the signal was recorded (Cartesian system expressed in metres). These fields are relevant to records where the source is clearly identified. It is generally useful for refraction and travel time tomography analysis</span>
 |-
-|'''StackCount'''
+|StackCount
 |integer
 |<span id="Field:StackCount">The number of recorded stack.</span>

@@ Line 78: / Line 78: @@
 |<span id="Field:HeaderModified">'true' if the header was modified. When closing the current database, if at least one signal has this field as true, the user is warned to save the database. This value is read-only</span>
 |-
-|'''ID'''
+|'''Id'''
 |integer
 |<span id="Field:ID">Unique number to reference the signal, used by [[Geopsy:Groups|groups]]. This value is read-only</span>
@@ Line 85: / Line 85: @@
 |string
 |<span id="Field:IsOriginalFile">Contains "Original" if the signal samples have not been affected by any signal processing. Otherwise, the field is blank. See saving a database for details. This value is read-only</span>
 |-
 |MaximumAmplitude
 |double
 |<span id="Field:MaximumAmplitude">It is the maximum amplitude reached by the signal for the whole Duration. The units depends upon the value of [[#Field:Count2Volt|Count2Volt]]. Contrary to the other fields, calculating this value requires the signal samples to be loaded into memory. Hence using this field may slow down Geopsy. We advise using it only if necessary. This value is read-only</span>
 |-
 |Name
@@ Line 105: / Line 105: @@
 |integer
 |<span id="Field:NumberInFile">A signal file may contain various signals. This parameter is this index of this signal in its file. This parameter is read-only.</span>
 |-
 |Pointer
@@ Line 145: / Line 149: @@
 |double
 |<span id="Field:Source">The coordinates of the source for which the signal was recorded (Cartesian system expressed in metres). These fields are relevant to records where the source is clearly identified. It is generally useful for refraction and travel time tomography analysis</span>
 |-
 |'''T0'''

@@ Line 179: / Line 179: @@
 |}
-"double" means double floating point real numbers coded on 64 bits, "integer" means a positive or negative integer, "string" means any string of characters, and "char" is a single character. Fields followed by '[]' are vectors and they accept any positive (>=0) index as argument. Fields marked in bold represent the most important parameters that must be correctly defined to allow a visualization of signals.
+"double" means double floating point real numbers coded on 64 bits, "integer" means a positive or negative integer, "string" means any string of characters, and "char" is a single character. Fields followed by '[]' are vectors and they accept any index as argument. Fields marked in bold represent the most important parameters that must be correctly defined to allow visualization of signals.
 When a new signal file is loaded into the database, a new memory structure is allocated for the signal and the fields listed above are filled in from the information contained in the file header. The information extracted from the file header depends upon the [[Geopsy: Supported file formats|file format]].

@@ Line 34: / Line 34: @@
 |<span id="Field:CountPerVolt">The conversion factor between 'count' and 'volt'. 'counts' are divided by this factor to obtain 'volts'. This value is read from the majority of signal files. By default this value is 1.0. When the factor is equal to unity, the amplitude scale of the signal is automatically considered as counts, else as volts. See also [[#Field:VoltPerUnit|VoltPerUnit]], [[#Field:VoltPerCount|VoltPerCount]], [[#Field:CountPerUnit|CountPerUnit]]</span>
 |-
-|'''DeltaT'''
+|'''SamplingPeriod'''
 |double
-|<span id="Field:DeltaT">It is the sampling period expressed in period. This property, as well as [[#Field:SamplingFrequency|SamplingFrequency]], can be modified. However, make sure that it corresponds exactly to the true recording frequency sampling rate</span>
+|<span id="Field:SamplingPeriod">It is the sampling period expressed in period. This property, as well as [[#Field:SamplingFrequency|SamplingFrequency]], can be modified. However, make sure that it corresponds exactly to the true recording frequency sampling rate</span>
 |-
 |DupAverage[]
@@ Line 56: / Line 56: @@
 |Duration
 |double
-|<span id="Field:Duration">Time elapsed between the first and the last sample of the signal (in seconds). This parameter is not saved in the signal structure but calculated from [[#Field:DeltaT|DeltaT]] and [[#Field:NSamples|NSamples]]. See [[#Field:T0|T0]] for acceptable formats</span>
+|<span id="Field:Duration">Time elapsed between the first and the last sample of the signal (in seconds). This parameter is not saved in the signal structure but calculated from [[#Field:SamplingPeriod|SamplingPeriod]] and [[#Field:NSamples|NSamples]]. See [[#Field:T0|T0]] for acceptable formats</span>
 |-
 |EndTime
@@ Line 118: / Line 118: @@
 |'''SamplingFrequency'''
 |double
-|<span id="Field:SamplingFrequency">It is the sampling frequency expressed in Hz. This parameter is not saved in the structure but calculated from [[#Field:DeltaT|DeltaT]]. You can modified it, [[#Field:DeltaT|DeltaT]] is changed accordingly</span>
+|<span id="Field:SamplingFrequency">It is the sampling frequency expressed in Hz. This parameter is not saved in the structure but calculated from [[#Field:SamplingPeriod|SamplingPeriod]]. You can modified it, [[#Field:SamplingPeriod|SamplingPeriod]] is changed accordingly</span>
 |-
 |SampleSize

@@ Line 116: / Line 116: @@
 |<span id="Field:Receiver">The coordinates of the receiver where the signal was recorded (Cartesian system expressed in metres)</span>
 |-
-|'''SampFreq'''
+|'''SamplingFrequency'''
 |double
-|<span id="Field:SampFreq">It is the sampling frequency expressed in Hz. This parameter is not saved in the structure but calculated from [[#Field:DeltaT|DeltaT]]. You can modified it, [[#Field:DeltaT|DeltaT]] is changed accordingly</span>
+|<span id="Field:SamplingFrequency">It is the sampling frequency expressed in Hz. This parameter is not saved in the structure but calculated from [[#Field:DeltaT|DeltaT]]. You can modified it, [[#Field:DeltaT|DeltaT]] is changed accordingly</span>
 |-
 |SampleSize

@@ Line 203: / Line 203: @@
 Former version of Geopsy were based on a directory structure. This is no longer the case. All the information is stored in a single file with extension '''gpy'''. It is an [[Xml files|xml compressed file]] like many other file types shared by other Geopsy.org softwares.
-Example of [[Media:.gpy]] structure (contents.xml):
+Example of [[Media:lep_ring01_3C.gpy|database]] structure (contents.xml):
   <SignalDB>
     <version>3</version>

← Older revision		Revision as of 14:56, 12 March 2010
Line 203:		Line 203:
	Former version of Geopsy were based on a directory structure. This is no longer the case. All the information is stored in a single file with extension '''gpy'''. It is an [[Xml files\|xml compressed file]] like many other file types shared by other Geopsy.org softwares.		Former version of Geopsy were based on a directory structure. This is no longer the case. All the information is stored in a single file with extension '''gpy'''. It is an [[Xml files\|xml compressed file]] like many other file types shared by other Geopsy.org softwares.

−	~~TODO~~: ~~example of~~ gpy xml ~~structure~~	+	Example of [[Media:.gpy]] structure (contents.xml):
		+	<SignalDB>
		+	<version>3</version>
		+	<File>
		+	<name>/home/mwathele/projets/Documentation/DOCWORKSHOP/RING01_SHORT/WA.WAU01..HHE.D.2010.056.000</name>
		+	<format>MiniSeed</format>
		+	<original>true</original>
		+	<Signal>
		+	<ID>1</ID>
		+	<Name>WA_WAU01</Name>
		+	<Component>East</Component>
		+	<T0>29995</T0>
		+	<TimeReference>25/02/2010 00:00:00</TimeReference>
		+	<DeltaT>0.010000000000000000208</DeltaT>
		+	<Type>Waveform</Type>
		+	<NSamples>93974</NSamples>
		+	<CountPerVolt>1</CountPerVolt>
		+	<VoltPerUnit>1</VoltPerUnit>
		+	<AmplitudeUnit>Velocity</AmplitudeUnit>
		+	<NumberInFile>0</NumberInFile>
		+	<Receiver>0.940537635798569 -0.0688222621658598 43.643929</Receiver>
		+	<OffsetInFile>0</OffsetInFile>
		+	<ByteIncrement>0</ByteIncrement>
		+	<MiniSeedRecords>0,512,512,512,1024,512,1536,... </MiniSeedRecords>
		+	</Signal>
		+	...
		+	</File>
		+	...
		+	<Group>
		+	<folder>true</folder>
		+	<name>/</name>
		+	<comments>Root folder of all groups</comments>
		+	<Group>
		+	<folder>false</folder>
		+	<name>vertical</name>
		+	<comments></comments>
		+	<ids>9 6 18 15 12 21 3 24 </ids>
		+	</Group>
		+	<Group>
		+	<folder>false</folder>
		+	<name>All 3C</name>
		+	<comments></comments>
		+	<ids>9 6 18 15 12 21 3 24 14 17 2 20 5 8 11 23 19 22 13 4 16 7 1 10 </ids>
		+	</Group>
		+	</Group>
		+	</SignalDB>