User Tools

Site Tools


gellish_expression_format

This is an old revision of the document!


The Gellish Expression Format

The Gellish Expression Format is a tabular format. It can be expressed in various basic formats, such as CSV, JSON or spreadsheet formats, such as XLS, typically using the UTF-8 encoding standard. The following columns in the table form the core of the expressions, using English terminology and provided with an example of a Gellish expression:

31 101 3 201 7
Name of an intentionName of a left hand objectName of a kind of relationName of a right hand objectSymbol of unit of measure
assertionThe Euromastis located inRotterdam

The above Gellish expression table is language dependent and human readable. It can be made language independent by adding references to unique language independent identifiers (UIDs) by extending the table with columns for such UIDs as follows:

1 5 2 60 15 66
UID of an ideaUID of an intentionUID of a left hand objectUID of a kind of relationUID of a right hand objectUID of a unit of measure
pr:1970025pr:1015138pr:102

Note that

  • The UIDs shall be distinguished from the numeric UIDs that are standard in Gellish. Users can make their own UIDs by a prefix followed by a colon (:), followed by free codes. In this example Column 1 with UID therefore contains the prefix 'pr' and code '101', resulting in UID pr:101.
  • The UID of an idea is intended for being used for making statements about the expression as a whole.
  • An 'assertion' is a standard kind of intention with the Gellish UID 970025.
  • The Euromast and Rotterdam do not appear in the Gellish Dictionary (assumed), thus the user can allocate his own UIDs for those concepts.
  • The kind of relation 'is located in' is a standard phrase for the standard kind of relation with UID 5138.
  • The unit of measure column is not applicable for this expression, thus the columns for the UID as well as the symbol is left empty. If the columns are not required in a whole table, then the columns can be deleted from the table.

Multi language support

There is a separate pair of columns available for specifying the UID and name of the language of the name of the left hand object on each row. This enables to use various languages in the expressions in one table, including the specification that term is a translation of another term for the same concept. Furthermore, one or more separate columns can be inserted each of which for specifying alternative names for the left hand object in a specific language. The column ids for those columns should be the Gellish UIDs for the particular languages. For example, a table in English may include an expression in Dutch and an additional column with a name of the left hand objects in German. This will look as follows:

Contextual facts

Other columns are available for expression of contextual facts, such as status, date of creation, author, etc. Those columns can be added depending in the requirements of the user by selecting them from a list of available columns. The columns may be arranged in any order that is convenient for the user. Multiple tables can be combined and different tables may consist of different collections of columns.

Header rows

The table has three header rows. The first header row contains the following fields:

GellishEnglishVersionversion codedate of releasename or category of expressionsfile name

followed by an optional sequence of name based parameter names and values:

Lower_obj_uid=nUpper_obj_uid=nLower_rel_uid=nUpper_rel_uid=nPrefix=prefixref_iris=IRIs

Notes:

  • The string 'Gellish' is an obligatory standard term in the first field.
  • The name 'English' in the second field may be replaced by another language name, such as 'Nederlands'. It specifies the language that is used in text fields, although on each row it is possible to overwrite this by specifying the language that is used for the name of the left hand object. Furthermore there can be one or more additional columns that specify names of the left hand object in a particular language (as is described above).
  • The following five fields are optional free text fields.

The name based parameter names and values are intended for use with automated UID generation only.

  • The optional Lower_obj_uid and next three UIDs may specify ranges for new numeric UIDs.
  • The optional prefix specifies a prefix that may be used to precede a colon (:) and newly generated numeric codes for generating new UIDs for new concepts. For example, the prefix 'pre' can be used by software for generating the following sequence of UIDs within the object uid range 20-30: pre:20, pre:21, pre:22, etc. The software should first verify which is the highest current value within the range for the prefix.

The columns in a table are identified by language independent column IDs in the second header row. The third header row contains free text names of the columns, corresponding with the column IDs.

Various examples of tables in Gellish Expression Format are given in the download area.

A detailed specification of the definition of the tabular format is given in the document 'The Gellish Syntax and contextual facts' that is available in the download section of the gellish website.

==⇒> next page

gellish_expression_format.1540916117.txt.gz · Last modified: 2018/10/30 17:15 by andries