Container

A Container substitutes a part of a Statement with data and adds grammatical information to them if given. The data can have two different sources. On the one hand, the data you provide through a Variable Node, on the other hand, a static text.

A Container proccesing data from a Variable Node is of type Variable Output and a Container using static text is of type Grammar Provider. In short, Variable Container and Grammar Container.

Requirements

Minimum: A statement with a single character.

Types

Types Description
Variable Output Uses the content of a variable node. Configure the output and alter the grammar features.
Grammar Provider Use the static text and add grammar features.

Content Settings

Variable Output Container

Also called Variable Container, uses the content of a Variable Node to render the text. In the settings, you can configure the content output, grammar features, and text formatting.

The following table shows the three configuration categories.

Settings Description
Variable Select a Variable Node for modification.
Phrase Parts Configure the Noun Phrase Parts to output or choose output as a Pronoun instead.
Group Settings The selected variable holds a group of phrases or values. Configure the output of the non-empty entries.
Variable (Content Settings)

A way to reselect Variable Nodes quickly. The settings Phrase Parts used for content output differ depending on the content and are derived from used Text Nodes or Mapping Nodes. A distinction is made between Value, Phrase, and Group.

Value Content

Mapping Nodes return transformed or raw content (e.g. 14, GTX 1080, "real words" ...). Generally, this type is used to place numerical information, unusual words or compositions into the text. For example, “The 7.5 inch Super AMOLED display ...”, “MTFBWY and other abbreviations.“ or “Get off at 103RD ST STATION B/C at 9:01 AM”. However, you can use this type to pass any content of a Mapping Node into your Statement.

In the section Content Parameters, see a detailed explanation for all options you can configure.

Phrase Content

First, a straightforward way to use the content from your data in a Statement and add grammar features in the Grammar Settings to the content. Secondly, you can use the features of a Phrase Node and provide a more complex phrase. A character, word, phrase, subclause, or a sentence can derive from a Phrase Node and be used as a Phrase Content (see Phrase Node). However, the general use for Phrase Content is to generate simple phrases consist of an adjective and a noun and both originate from your data. For example, "a black car" where the color comes from the data and may vary. Therefore, the article should be updated depending on the given adjective - a vs. an. For this, the noun and the adjective need to be provided through a Phrase Node as Phrase Content. Then in a Container, unlock the option use Phrase adjective and, lastly, set an indefinite determiner. This setting creates a short phrase in which the determiner automatically adjusts itself according to the provided adjective. Furthermore, the whole Phrase Content can be output as a pronoun and will be adjusted automatically in accordance with the gender. This allows constructing statements like “Jennifer went to … .There she met …”

See Phrase Parts for detailed explanation of the options and Grammar Setting for more grammar features that can be used to adjusted grammar automatically.

Group Content

To put it simply, it's a list. The type of the content of each (list) item provided by the Group Node can differ if wanted (see Group Node). From a value return through a Mapping, a phrase from a Phrase Node, or even another Group Node, the Group Content is mainly used to form an enumerable phrase or a bullet point list. Furthermore, additional options are applicable through Group Settings. Because the items can contain the output of a Phrase Node, it is likely to use options in the Phrase Parts. In doing so the options are applied to each element.

Phrase Parts --!-- can be better

Phrase Parts allow configuring a Nominal Phrase. Different options are available based on the content type (Value, Phrase, Group). The content can come from the data and vary between Documents, be a result of some transformations or a static text, the active options will be applied to any of them after evaluation. Before applying, the system verifies whether the content is present. Then the grammatical properties are determined. Depending on the language, suitable components are grammatically adapted and generated by the appropriate options.

The output is discarded If the (input) content is absent. Also, you can opt-in the functionality to discard a whole branch if the content is missing.

To determine the grammar the system looks on the provided information by the user. For example, the Headnoun-field in a Phrase Node, the user’s lexicon entries, the selected options under Grammar Settings and, lastly, it checks the lexicon provided by AX-Semantics.

If the system did not find any clues to determine the correct grammatical form for a particular option, it will omit that option. (This behavior was preferred by our customers).

See [Content Parameters] for a detailed explanation for each option.

Group Settings --!-- can be better

Change the output of a Group Content by using an output format and a method for how or which non-empty elements to use. Empty items are ignored so that the first item in a Group Content always has content unless the entire Group Content is empty.

The output can be displayed in two different ways, as a list for bullet points and inline for the enumeration in a statement. By using the inline output you can enter conjunction (e.g. and, or...) before the last entry into the unlocked option “Conjunction for last entry”. With a method, in addition, you can define which elements from the Group Content should be used.

Content Parameters

Determiner - Add a determiner, Possessive Target

Determiner (e.g. a, an, the, his ...) occurs together with a noun or a noun phrase in accordance with the selected language (e.g. en, de, fr …) and provided grammatical information (e.g. Number, Person).

In addition, you can manually enforce grammatical information about the gender and number through the use of the Headnoun field in a [Phrase Node].

Numerals - Use Numeral Variable, Numeral Type

Converts numbers to cardinal or oridnal or vice versa. TODO: Link to grammar sheet

Pronoun - Output whole phrase as a pronoun

Creates a pronoun based on the grammatical number and gender of the content. TODO: Link to grammar sheet

Adjectives - Use Phrase Adjectives, Adjective Conjunctions

Grammar Container

Settings Description
Content Select the data you want to use and apply the grammar or formatting to its content.
Grammar Define the grammatical categories to the content.
Formatting Select how to output the content.
Configure Content (Grammar Container)

TODO: Description

Settings Description
Grammar Provider for noun To provide grammar the Lemma (canonical / dictionary form) is looked up in the dictonary and altered according to what is defined in the Grammar tab.
Phrase Parts Configure the Noun Phrase Parts to output or choose output as a Pronoun instead.
Parameters

Determiner - Add a determiner

Define which determiner should preceed the content. TODO: Link to grammar sheet

Pronoun - Output whole phrase as a pronoun

Creates a pronoun based on the grammatical number and gender of the content. TODO: Link to grammar sheet

Configure Grammar (Variable Container)

TODO: Description

Settings Description
Role Define a Name to refer to any point in the statement for grammatical concordance.
Contextual Grammar Nouns need to be changed according to their role in the sentence.
Lexical Grammar Nouns change lexically if they are not named entities. Certain grammatical information (e.g. number) might be correlated to other parts of the sentence.
Parameters

Role

Name this container (according to its function within the statement). You can refer to a certain role at any point in the statement for grammatical concordance.

Preposition

Define which determiner should preceed the content.

Grammatical Case

Select the case of your content.

Named Entity - Is named entity

Treat content as a named entity.

Agreement - Agrees with Container(Noun)

Align Containers in number and in gender.

Number Select a number category.

Gender Select the grammatical gender

Configure Formatting (Variable Container)

Grammar Settings

TODO: Description

Settings Description
Role Define a Name to refer to any point in the statement for grammatical concordance.
Contextual Grammar Nouns need to be changed according to their role in the sentence.
Lexical Grammar Nouns change lexically if they are not named entities. Certain grammatical information (e.g. number) might be correlated to other parts of the sentence.

Parameters

Preposition

Define which determiner should preceed the content.

Grammatical Case

Select the case of your content.

Named Entity - Is named entity

Treat content as a named entity.

Agreement - Agrees with Container(Noun)

Align Containers in number and in gender.

Number Select a number category.

Gender Select the grammatical gender

Formatting Settings

TODO: description

Parameters

auto

TODO: Text

Capitalize

TODO: Text

Upper Case

TODO: Text

Lower Case

TODO: Text

raw

TODO: Text