Lucid Builder v4

Lucid Builder Setting Properties for Media items

Properties for media items (images and web pages) are set using edit and check boxes on the Media panel.

Lucid Builder Media Properties panel
Lucid Builder Media Properties panel.

The properties are:

Path and Thumbnail path – Displays the name and file system path of the selected file (and of its thumbnail for image files). This is not editable, and is displayed to enable you to locate files in the file system

Caption – When an image is displayed at full size in the Lucid Player it is annotated with a caption. The caption is also used to refer to the image in a menu list of images, when several images are attached to one item.

Copyright When an image is displayed at full size in the Lucid Player it is annotated with a copyright attribution. Use this box to enter copyright information for the image. The copyright button can be used to insert the copyright symbol (©) before the text.

Comments – When an image is displayed at full size in the Lucid Player it may be annotated with comments. Use this box to enter the comment text.

Needs Revision – Check this to bookmark (for yourself and other key builders) that a media item needs to be revised later. Media items marked as needing revision can also be excluded from the key deployment process.

Publish – Check this to specify that the currently selected media item should be published when the key is deployed. This option is checked by default.

Lucid Builder v4

Lucid Builder Setting properties for items

Properties for key items (Features, States and Entities) and subsets are set using the Items properties tab at the left of the main panels.

Item ID

The Item ID is a unique value assigned by the Lucid Builder to every element within the key. This value is useful when posting keys to a Web Server where the value can be used, for example, to preselect feature states via a custom web interface (e.g. a mapping system). Or for allowing third party applications such as Fact Sheet Fusion to map by ID rather than a text label.

List view name

In Lucid, features and entities are often arranged into hierarchical trees. The name of any item in the tree will often be conditional on its position in the tree.

Thus, the name of the feature Overall Shape in the tree at left only makes sense because of its position as a child of Pileus.

Lucid Builder List View Name example
Lucid Builder List View Name example

At times, it is necessary to break up and rearrange the trees in the Lucid Player, as when the features are arranged in the Best order, or when entities are displayed ranked by their match value. At these times the features and entities are displayed as a list rather than a tree. For this reason, items should sometimes be provided with List View Names as well as Tree View Names.

By default, the Lucid Player creates a List View Name by recording an item’s path in its tree. Thus, the Overall Shape feature above would have a default List View Name of Pileus: Overall Shape.

The List View Name box on the Items properties panel is used to provide an alternative name to the default name. In the case above an appropriate name may be Pileus shape.

Lucid Builder Properties Panel - Items tab with Entity selected example
Lucid Builder Properties Panel – Items tab with Entity selected example


List View Names for features only need to be provided for the lowest-level features - that is, those that have states as children or numeric feature nodes, since only these are displayed when the Player shows the feature in a list. Thus, the node Pileus above does not need a List View Name.

All nodes in the entities tree can be provided with List View Names, since all may be ranked in a list.

Item UID

The Item Universal Identifier (UID) is used for referencing the item in the Lucid Browser player and via JavaScript.


The Comments box is intended for annotating housekeeping comments to items. These comments are internal to the Builder and are not published with the key.

Needs revision

Check this box when the feature or entity is provisional and you intend to revise the data later (note that future releases of the Lucid Builder will include tools for finding and managing these items).

Feature Type

Lucid Builder Properties Panel - Feature selected example
Lucid Builder Properties Panel – Items tab – Feature State selected example.

The Feature Type box displays and sets the type of Feature in the Features panel. There are four types of Features: 

  1. Multi-state Features have states as children; 
  2. Grouping Features have other Features as children; 
  3. Numeric Features, that have no children and;
  4. Text Features used in Natural Language Description generation and is not output in the key for use within the Lucid Player.

The Feature type may be set at the time the Feature is added to the Features panel, or may be changed at any time via the Items property panel. A multi-state Feature may not be changed to a numeric or Grouping Feature until all its states have been removed. A Grouping Feature may not be changed to a multi-state or numeric Feature until its children have been removed. If a numeric Feature has been scored and is changed to a multi-state or Grouping Feature, its score data will be lost and cannot be retrieved.

List View Node

When the Lucid Player displays its features in a list rather than a tree, all multi-state and numeric features are listed but grouping nodes are not. On the entities side, however, there are no predefined rules for inclusion in the list. Therefore, when the entities panel is active, the List View Node checkbox appears and is used by the author of the key to specify whether an entity is to be included or excluded from the entities list. By default all entities added to the Entities tree are checked for inclusion in the entities list; un-check the checkbox if you wish the entity to be excluded from the list. Entities that are terminal in the entities tree (that is, entities without children) must be list view nodes; the checkbox for these nodes cannot be unchecked.

The List View Node checkbox is only available when an entity is selected.

Default Subsets

Lucid Builder Properties Panel - Entity Subset selected example
Lucid Builder Properties Panel – Entity Subset selected example

See the Subsets topic for more information.

Lucid Builder Properties panel Items tab Feature selected example.

Include in Best

By default a multistate Feature is included in the Lucid Player’s Best algorithm. Instances where you have esoteric or difficult to answer Features you may wish to exclude them from being offered via the Best Function. In a large key with many Features excluding some Features can help speed up the Best algorithm on the Lucid Mobile Platform where some older devices may have under powered CPUs. 


You can use the Key Reporter to reveal all Features excluded from Best.

Score Weight

The score weight setting modifies how the Feature is treated (weighted) in the Lucid Player’s Best algorithm. By default all Features are treated equally when calculating its rank within the list of Features available based on the Entities remaining. The ‘best’ feature (ranked first) is offered to the user for selection. By reducing the Features weight will cause the best algorithm to lower, not exclude, it’s ‘best’ ranking, while taking into account the weight settings of the other Features. For example, you may have a ‘powerful’ feature such as ‘Plant Family’ that is consistently offered as the ‘Best’ Feature to choose from, however your many of your keys users may not have this knowledge and will be forced to request the next best Feature. You can reduce the score weight of this so it may be ranked several orders down the ‘best’ rank and offered to the user as the best character when other easier Features have been exhausted.

Matching Type

Lucid Builder Properties Panel - Items tab - Matching Type options
Lucid Builder Properties Panel – Items tab – Matching Type options.

In older versions of Lucid Builder you needed to decide at a global level for your key how the Lucid Player treated multi selections of States within the same Feature. That is using the logic of AND (Match all states) or OR (Match any states).

Lucid4 now allows you to set the matching logic on a per Feature basis. This flexibility is particularly useful in diagnostic keys.

By default multi-state Features are set to use the ‘Match any states’ setting (OR logic).

Single state selection

By default the Lucid Player allows the user to select one or more of the States of a multi-state Features. Selecting the Single state selection option will set the Feature to allow only a single State to selected on the Feature. After the user selects a State of the Feature further selections are disabled. As shown in the example screen shot below.

Lucid Player single State selection Feature example
Lucid Player single State selection Feature example.


Lucid Builder v4

Lucid Builder Setting properties for the key

General properties for the key are set using the Key properties tab at the left of the main panels.

Lucid Builder Key Properties panel
Lucid Builder Key Properties panel

Key Title

The Key Title should provide an appropriate, short, one-line name for the key, such as Key to Mangroves of AustraliaFly Families of the World or Common Diseases of Rice in South-east Asia. The key title is displayed as the header for the key window when the key is played in the Lucid Player.

Note that the title of the key is independent of the file name that is used to save the key. However, it will often be found useful to use the key title also for the file name, to help locate the key quickly on a hard drive or other storage.

Key Description

The Key Description provides a place to record any details about the key that may help you when you next open the key, or when you distribute your key to another party. Key Description may, for example, contain details such as the key’s purpose, target audience, limitations, version number and date etc. The information in Key Description is not published with a compiled key.

Key Authors

Key Authors provides a place to record authorship and authorship details (such as email addresses etc). The information in Key Authors is not published with a compiled key.


You can enter basic HTML tags within the title, description and author text areas. This information can be used as a part of the key deployment process, if you elect to have the Lucid Builder create a home page for the key.

If you would like an introduction to HTML basics take a look at