YA (TQL): Difference between revisions

From Tygron Support wiki
Jump to navigation Jump to search
No edit summary
 
(7 intermediate revisions by the same user not shown)
Line 1: Line 1:
The 'YA' clause value is a variation on the [[Y (TQL)|'Y']] clause value. The characters 'YA' should be followed by an underscore and the name of an [[Attribute]]; for example '''YA_MONUMENTAL'''. Also see the [[#Example|example ]]below.  
The 'YA' clause value is a variation on the [[Y (TQL)|'Y']] clause value. The characters 'YA' should be followed by an underscore and the name of an [[Attribute]]; for example '''YA_MONUMENTAL'''.


The result of using 'XA' for the clause value, is the automatic creation of multiple TQL statements, one with each Item ID for that Clause Parameter that can be found in the project data. Items are only taken into account of they have a non zero value for the specified attribute.
The result of using 'XA' for the clause value, is the automatic creation of multiple TQL statements, one with each Item ID for that Clause Parameter that can be found in the project data. Items are only taken into account of they have a non zero value for the specified attribute.
Line 20: Line 20:
The TQL statement to obtain the names of the monumental Buildings is:
The TQL statement to obtain the names of the monumental Buildings is:
<pre>SELECT_NAME_WHERE_BUILDING_IS_YA_MONUMENTAL</pre>  
<pre>SELECT_NAME_WHERE_BUILDING_IS_YA_MONUMENTAL</pre>  
which internally is replaced with a list of TQL statements, separated by comma's,
which internally is replaced with a list of TQL statement arrays, separated by a comma:
<pre>SELECT_NAME_WHERE_BUILDING_IS_1, SELECT_NAME_WHERE_BUILDING_IS_2, SELECT_NAME_WHERE_BUILDING_IS_4</pre>
<pre>[SELECT_NAME_WHERE_BUILDING_IS_1], [SELECT_NAME_WHERE_BUILDING_IS_2], [SELECT_NAME_WHERE_BUILDING_IS_4]</pre>
Its result will be a list of names, separated by comma's:
Its result will be a list of arrays with names, separated by a comma:
<pre>["Kerklaan 40"], ["Achterweg 7"], ["Kerklaan 61"]</pre>
<pre>["Kerklaan 40"], ["Achterweg 7"], ["Kerklaan 61"]</pre>
Similarly, the TQL statement to obtain the culvert Diameters of the Culverts used by the water Overlay is:
Similarly, the TQL statement to obtain the culvert Diameters of the Culverts used by the water Overlay is:
<pre>SELECT_ATTRIBUTE_WHERE_BUILDING_IS_YA_MONUMENTAL_AND_NAME_IS_MONUMENTAL</pre>  
<pre>SELECT_ATTRIBUTE_WHERE_BUILDING_IS_YA_MONUMENTAL_AND_NAME_IS_MONUMENTAL</pre>  
Its result will be a list of values, separated by comma's:
Its result will be a list of arrays of values, separated by a comma:
<pre>[1.0], [-3.5], [2.0]</pre>
<pre>[1.0], [-3.5], [2.0]</pre>


Line 33: Line 33:


{{article end
{{article end
|notes=
|notes=*The following variants on YA exist:
**YCA: A combination between [[YC (TQL)|YC]] and [[YA (TQL)|YA]].
|seealso=
|seealso=
*[[XA (TQL)]]
*[[XA (TQL)]]

Latest revision as of 13:13, 20 May 2026

The 'YA' clause value is a variation on the 'Y' clause value. The characters 'YA' should be followed by an underscore and the name of an Attribute; for example YA_MONUMENTAL.

The result of using 'XA' for the clause value, is the automatic creation of multiple TQL statements, one with each Item ID for that Clause Parameter that can be found in the project data. Items are only taken into account of they have a non zero value for the specified attribute.

Internally, the resulting TQL statements are placed in an array of arrays; Similarly the result will be an array of TQL result arrays.

Example

Consider the following (simplified) Building data of a project:

[ 
 { "id" : 0, "name" : "Lindelaan 3", "attributes": { "MONUMENTAL" : [0.0], "MEASURED_M2" : [200.0] } },
 { "id" : 1, "name" : "Kerklaan 40", "attributes": { "MONUMENTAL" : [1.0] } }, 
 { "id" : 2, "name" : "Achterweg 7", "attributes": { "MONUMENTAL" : [-3.5] } }, 
 { "id" : 3, "name" : "Achterweg 9", "attributes": { },
 { "id" : 4, "name" : "Kerklaan 61", "attributes": { "MONUMENTAL" : [2.0]} 
 { "id" : 5, "name" : "Duiker 1235", "attributes": { "CULVERT_DIAMETER" : [1.0]},
]

The TQL statement to obtain the names of the monumental Buildings is:

SELECT_NAME_WHERE_BUILDING_IS_YA_MONUMENTAL

which internally is replaced with a list of TQL statement arrays, separated by a comma:

[SELECT_NAME_WHERE_BUILDING_IS_1], [SELECT_NAME_WHERE_BUILDING_IS_2], [SELECT_NAME_WHERE_BUILDING_IS_4]

Its result will be a list of arrays with names, separated by a comma:

["Kerklaan 40"], ["Achterweg 7"], ["Kerklaan 61"]

Similarly, the TQL statement to obtain the culvert Diameters of the Culverts used by the water Overlay is:

SELECT_ATTRIBUTE_WHERE_BUILDING_IS_YA_MONUMENTAL_AND_NAME_IS_MONUMENTAL

Its result will be a list of arrays of values, separated by a comma:

[1.0], [-3.5], [2.0]

Clause Parameters

The YA value can be used in the following TQL Clause parameters:

Notes

  • The following variants on YA exist:
    • YCA: A combination between YC and YA.

See also