Benutzer-Werkzeuge

Webseiten-Werkzeuge


fileformats:hdascii

Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen angezeigt.

Link zu dieser Vergleichsansicht

Beide Seiten der vorigen RevisionVorhergehende Überarbeitung
Nächste Überarbeitung
Vorhergehende Überarbeitung
fileformats:hdascii [2017/02/28 15:36] – [Multi-dimensional doubles] oliverfileformats:hdascii [2017/12/22 15:08] (aktuell) – [File extentions and mime types] oliver
Zeile 1: Zeile 1:
 ======The HD-ASCII File Format====== ======The HD-ASCII File Format======
 +=====History=====
 This component implements the //HD-ASCII File format//, originally designed and implemented by Jan Simon in [[https://de.mathworks.com/products/matlab.html|Matlab]] for usage in the [[http://www.heidel-motionlab.de/|Gaitlab Heidelberg]].  This component implements the //HD-ASCII File format//, originally designed and implemented by Jan Simon in [[https://de.mathworks.com/products/matlab.html|Matlab]] for usage in the [[http://www.heidel-motionlab.de/|Gaitlab Heidelberg]]. 
  
 +=====General features=====
 The HD-ASCII file format is a container format for any data organized in matrices. The data types are orientated on the types available in the [[https://de.mathworks.com/products/matlab.html|Matlab environment]]. Each matrix of data is named, but there is no defined order. The HD-ASCII file format is a container format for any data organized in matrices. The data types are orientated on the types available in the [[https://de.mathworks.com/products/matlab.html|Matlab environment]]. Each matrix of data is named, but there is no defined order.
  
 =====Disadvantages===== =====Disadvantages=====
  
-The HD-ASCII file format is extensivly used in the [[http://www.heidel-motionlab.de/|Gaitlab Heidelberg]], but it is not recommended for **Nimue** based applications, because of different limitations:+The HD-ASCII file format is extensivly used in the [[http://www.heidel-motionlab.de/|Gaitlab Heidelberg]], but it is not recommended for **Nimue** based applications, because of several limitations:
  
   * The resolution of the numbers is insufficient defineable. This can result in ilusive bugs.   * The resolution of the numbers is insufficient defineable. This can result in ilusive bugs.
Zeile 16: Zeile 18:
 All of these limitations are overruled by the Nimues default open and flexible [[http://nimue-platform.motion-science.org/doku.php?id=fileformats:d3d|.d3d file format]]. All of these limitations are overruled by the Nimues default open and flexible [[http://nimue-platform.motion-science.org/doku.php?id=fileformats:d3d|.d3d file format]].
  
-=====File extentions=====+=====File extentions and mime types =====
  
 To distinguesh different sets of data in the [[http://www.heidel-motionlab.de/|Heidelberg Gaitlab]] different file suffixes are defined.  To distinguesh different sets of data in the [[http://www.heidel-motionlab.de/|Heidelberg Gaitlab]] different file suffixes are defined. 
  
-^ File Extension ^ Frames ^ Description ^ Fix set of variables | +^ File Extension ^ Mime type ^ Frames ^ Description ^ Fix set of variables | 
-^ .glk | single trial | Lower Body Kinetics (PiG)  | X | +^ .glk | single trial | Lower Body Kinetics (PiG) | X | 
-^ .glkn | single trial | time normalized .glk  | X | +^ .glkn | single trial | Time normalized .glk-files| X | 
-^ .glm | single trial | Lower/Upper Body Kinematics (PiG)|   X | +^ .glm | text/x-glm | single trial | Lower/Upper Body Kinematics (PiG)| X | 
-^ .glmn | single trial | time normalized .glm  | X | +^ .glmn | single trial | Time normalized .glm-files | X | 
-^ .gle | single trial |  EMG data |   X | +^ .gle | text/x-gle | single trial | EMG data | X | 
-^ .glen  | single trial |  time normalized .gle  | X |  +^ .glen | single trial | Time normalized .gle-files| X |  
-^.gla | mean | * lower/upper body kinematics (PiG)  | X | +^.gla | text/x-gla | mean| Lower/upper body kinematics (PiG) average files | X | 
-^ .pkl | | Meta Data   | X | +^ .pkl | | Meta Data  | X | 
-^ .glx | single trial | experimentel  | | +^ .glx | text/x-glm | single trial | Data of single gait trials, without time-normalisation, experimental set of variables and parameters, typically an extention set of the data written in glm-files. | | 
-^ .glxn  | single trial  | time normalized .glx | | +^ .glxn | single trial | time normalized .glx | | 
-^ .gxa | mean   |*         | experimentel   +.gxa or .gxa | text/x-gax | mean  |*         | experimentel   
-^ .gaf | mean   | Foot Kinematics | X | +^ .gaf | text/x-gaf | mean   | Foot Kinematics | X | 
-^ .glf   | single trial  | Foot Kinematics | X | +^ .glf | single trial | Foot Kinematics | X | 
-^ .glfn  | mean  session mean; normalized to 101 frames time normalized .glf  | X | +^ .glfn  | mean | Session mean; normalized to 101 frames time normalized .glf | X | 
 +^ .gnm | text/x-gnm | | | |
  
 If a single trial is splittet into strides and timenormalized for each stride a seperate file is created. These files are numbered as the following examples shows: If a single trial is splittet into strides and timenormalized for each stride a seperate file is created. These files are numbered as the following examples shows:
Zeile 68: Zeile 70:
 ====String lists (Matlabs cell string)==== ====String lists (Matlabs cell string)====
  
-The strings of a string list can vary in the length and no trailing spaces are needed. The single strings of the list are written as lines separated by line breaks. Therefore strings must not contain line breaks (ASCII code 10 or 13). For string lists with more than 2 dimensions the first index is varied at first, then the second and so on, so-called +The strings of a string list can vary in the length and no trailing spaces are needed. The single strings of the list are written as lines separated by line breaks. Therefore strings must not contain line breaks (ASCII code 10 or 13). For string lists with more than 2 dimensions the first index is varied at first, then the second and so on, so-called columnwise order.
- +
-columnwise order (see examples).+
  
 ====Double arrays==== ====Double arrays====
Zeile 153: Zeile 153:
 of all other dimensions 2*4 = 8. of all other dimensions 2*4 = 8.
  
-=====Examples: strings=====+====Examples: strings====
 A single string is a row vector of characters like 'abc'. It has the dimension [1 x 3], but the number of columns is determined by the number of characters per line. The variable is called 'D': A single string is a row vector of characters like 'abc'. It has the dimension [1 x 3], but the number of columns is determined by the number of characters per line. The variable is called 'D':
  
-[D]$ +  [D]$ 
-abc+  abc
  
 This is equivalent to: This is equivalent to:
  
-[D]$1 +  [D]$1 
-abc+  abc
  
 A character array of size [2 x 6] named 'E' with contents ['Du    '; 'hier  '], spaces shown as dots: A character array of size [2 x 6] named 'E' with contents ['Du    '; 'hier  '], spaces shown as dots:
  
-[E]$2 +  [E]$2 
-Du.... +  Du.... 
-hier..+  hier..
  
 Pay attention for the 2nd dimension: The length of each line determines the row dimension! Therefore $N, $1$N and $N$1 are treated identically in opposite to the other types. Pay attention for the 2nd dimension: The length of each line determines the row dimension! Therefore $N, $1$N and $N$1 are treated identically in opposite to the other types.
Zeile 210: Zeile 210:
 'A' is a double of size [0 x 2 x 3], then: 'A' is a double of size [0 x 2 x 3], then:
  
-[A]:0:2:3+  [A]:0:2:3
  
 and no values appear. and no values appear.
Zeile 216: Zeile 216:
 The tag line can be commented with the '#' character. Spaces after the dimensions section are ignored. The tag line can be commented with the '#' character. Spaces after the dimensions section are ignored.
  
-[TagName]:2:  # This is the comment+  [TagName]:2:  # This is the comment
  
 Empty lines can be inserted before a tag line: Empty lines can be inserted before a tag line:
Zeile 223: Zeile 223:
   String1   String1
  
-[Tag2]& +  [Tag2]& 
-StringListElement1+  StringListElement1
  
-=====Header line=====+====Header line====
 Old style: In ASC-HD v2.0 the header line looks as following: Old style: In ASC-HD v2.0 the header line looks as following:
  
Zeile 252: Zeile 252:
 If new variables are appended to an existing file, the number of digits must not be decreased to avoid a loss of data. Be aware that management of data precision is a critical drawback when using ASCII files. If new variables are appended to an existing file, the number of digits must not be decreased to avoid a loss of data. Be aware that management of data precision is a critical drawback when using ASCII files.
  
-======Comments======+=====Comments=====
  
 Disk space is cheap today. Therefore it is recommended to use 'complete' data files: Among the data enough information to allow a re-creation of the contents.  Disk space is cheap today. Therefore it is recommended to use 'complete' data files: Among the data enough information to allow a re-creation of the contents. 
Zeile 260: Zeile 260:
 Date and time of creation, host name, institution, properties of measurement and computation, examined subject or object - or at least a pointer to a location where these information could be found. Date and time of creation, host name, institution, properties of measurement and computation, examined subject or object - or at least a pointer to a location where these information could be found.
  
-======Guidelines for implementations of reading and writing routines======+=====Guidelines for implementations of reading and writing routines===== 
 + 
 +Line breaks deviating from the preferred DOS style should be accepted.  
 + 
 +Before appending new variables to a file, check the trailing line break. It is a beloved feature to extract single variables from am ASC-HD file, but avoid dull searching for '[' to locate tag lines: It can be data of a string or string list!  
 + 
 +Users will insert errors in ASCII files whenever possible. A fair reading function counts the found elements and displays the name of the variable and the line number of problems. 
  
-Line breaks deviating from the preferred DOS style should be accepted. Before appending new variables to a file, check the trailing line break. It is a beloved feature to extract single variables from am ASC-HD file, but avoid dull searching for '[' to locate tag lines: It can be data of a string or string list! Users will insert errors in ASCII files whenever possible. A fair reading function counts the found elements and displays the name of the variable and the line number of problems. There is no idea how to treat characters with more then 7 bits. Think of an additional unicode type, the TeX like ["a] for the german Umlaut-a, the ISO-Latin-1 [ä].+There is no idea how to treat characters with more then 7 bits. Think of an additional unicode type, the TeX like ["a] for the german Umlaut-a, the ISO-Latin-1 [ä].
fileformats/hdascii.1488292574.txt.gz · Zuletzt geändert: 2017/02/28 15:36 von oliver

Donate Powered by PHP Valid HTML5 Valid CSS Driven by DokuWiki