Class: WhyAmISpecialCatalogFunction

WhyAmISpecialCatalogFunction(terria)

new WhyAmISpecialCatalogFunction(terria)

A Terria Spatial Inference function to determines the characteristics by which a particular region is most different from all other regions.

Parameters:
Name Type Description
terria Terria

The Terria instance.
Source:

Extends

Members

(static) parameters :Array.<CatalogProcessParameters>

Gets the parameters used to CatalogProcess#invoke to this function.

Type:
  • Array.<CatalogProcessParameters>
Source:

_memoizedInfoItemsSourceLookup

Lookup table for _sourceInfoItemNames, access through CatalogMember#_infoItemsWithSourceInfoLookup

Inherited From:
Source:

cacheDuration :String

Gets or sets the cache duration to use for proxied URLs for this catalog member. If undefined, proxied URLs are effectively cachable forever. The duration is expressed as a Varnish-like duration string, such as '1d' (one day) or '10000s' (ten thousand seconds).

Type:
  • String
Inherited From:
Source:

contextItem :CatalogItem

A catalog item that will be enabled while preparing to invoke this catalog function, in order to provide context for the function.

Type:
Inherited From:
Source:

customProperties :Object

Gets or sets the dictionary of custom item properties. This property is observable.

Type:
  • Object
Inherited From:
Source:

description :String

Gets or sets the description of the item. This property is observable.

Type:
  • String
Overrides:
Source:

forceProxy :Boolean

Gets or sets whether or not this member should be forced to use a proxy. This property is not observable.

Type:
  • Boolean
Inherited From:
Source:

hasDescription :Boolean

Tests whether a description is available, either in the 'description' property or as a member of the 'info' array.

Type:
  • Boolean
Inherited From:
Source:

hideSource :boolean

Indicates that the source of this data should be hidden from the UI (obviously this isn't super-secure as you can just look at the network requests).

Type:
  • boolean
Inherited From:
Source:

id :String

An optional unique id for this member, that is stable across renames and moves. Use uniqueId to get the canonical unique id for this CatalogMember, which is present even if there is no id.

Type:
  • String
Inherited From:
Source:

info :Array.<Object>

Gets or sets the array of section titles and contents for display in the layer info panel. In future this may replace 'description' above - this list should not contain sections named 'description' or 'Description' if the 'description' property is also set as both will be displayed. The object is of the form {name:string, content:string}. Content will be rendered as Markdown with HTML. This property is observable.

Type:
  • Array.<Object>
Inherited From:
Default Value:
  • []
Source:

infoSectionOrder :Array.<String>

Gets or sets the array of section titles definining the display order of info sections. If this property is not defined, DataPreviewSections's DEFAULT_SECTION_ORDER is used. This property is observable.

Type:
  • Array.<String>
Inherited From:
Source:

initialMessage :Object

A message object that is presented to the user when an item or group is initially clicked The object is of the form {title:string, content:string, key: string, confirmation: boolean, confirmText: string, width: number, height: number}. This property is observable.

Type:
  • Object
Inherited From:
Source:

isGroup :Boolean

Gets a value that tells the UI whether this is a group. Groups, when clicked, expand to show their constituent items.

Type:
  • Boolean
Inherited From:
Source:

isHidden :Boolean

Gets or sets a value indicating whether this item is hidden from the catalog. This property is observable.

Type:
  • Boolean
Inherited From:
Default Value:
  • false
Source:

isLoading :Boolean

Gets or sets a value indicating whether the group is currently loading. This property is observable.

Type:
  • Boolean
Inherited From:
Source:

isPromoted :Boolean

Gets or sets a value indicating whether this item is kept above other non-promoted items. This property is observable.

Type:
  • Boolean
Inherited From:
Default Value:
  • false
Source:

isUserSupplied :Boolean

Gets or sets a value indicating whether this member was supplied by the user rather than loaded from one of the Terria#initSources. User-supplied members must be serialized completely when, for example, serializing enabled members for sharing. This property is observable.

Type:
  • Boolean
Inherited From:
Default Value:
  • true
Source:

isWaitingForDisclaimer :boolean

Whether this catalog member is waiting for a disclaimer to be accepted before showing itself.

Type:
  • boolean
Inherited From:
Source:

name :String

Gets or sets the name of the item. This property is observable.

Type:
  • String
Overrides:
Source:

nameInCatalog :String

Gets or sets the name of this catalog member in the catalog. By default this is just name, but can be overridden.

Type:
  • String
Inherited From:
Source:

parent :CatalogGroup

The parent CatalogGroup of this member.

Type:
Inherited From:
Source:

propertiesForSharing :Array.<String>

Gets the set of names of the properties to be serialized for this object when CatalogMember#serializeToJson is called for a share link.

Type:
  • Array.<String>
Inherited From:
Source:

serializers :Object

Gets the set of functions used to serialize individual properties in CatalogMember#serializeToJson. When a property name on the model matches the name of a property in the serializers object literal, the value will be called as a function and passed a reference to the model, a reference to the destination JSON object literal, and the name of the property.

Type:
  • Object
Inherited From:
Source:

shareKeys :Array.<String>

An array of all possible keys that can be used to match to this catalog member when specified in a share link - used for maintaining backwards compatibility when adding or changing CatalogMember#id.

Type:
  • Array.<String>
Inherited From:
Source:

shortReport :String

A short report to show on the now viewing tab. This property is observable.

Type:
  • String
Inherited From:
Source:

shortReportSections :Array.<ShortReportSection>

The list of collapsible sections of the short report. Each element of the array is an object literal with a name and content property.

Type:
  • Array.<ShortReportSection>
Inherited From:
Source:

showsInfo :Boolean

Gets a value indicating whether this catalog member can show information. If so, an info icon will be shown next to the item in the data catalog.

Type:
  • Boolean
Inherited From:
Source:

terria :Terria

Gets the Terria instance.

Type:
Inherited From:
Source:

type :String

Gets the type of data member represented by this instance.

Type:
  • String
Overrides:
Source:

typeName :String

Gets a human-readable name for this type of data source, 'Why Am I Special?'.

Type:
  • String
Overrides:
Source:

uniqueId :String

The canonical unique id for this CatalogMember. Will be the id property if one is present, otherwise it will fall back to the uniqueId of this item's parent + this item's name. This means that if no id is set anywhere up the tree, the uniqueId will be a complete path of this member's location.

Type:
  • String
Inherited From:
Source:

updaters :Object

Gets the set of functions used to update individual properties in CatalogMember#updateFromJson. When a property name in the returned object literal matches the name of a property on this instance, the value will be called as a function and passed a reference to this instance, a reference to the source JSON object literal, and the name of the property.

Type:
  • Object
Inherited From:
Source:

Methods

connectsWithRoot()

Goes up the hierarchy and determines if this CatalogMember is connected with the root in terria.catalog, or whether it's part of a disconnected sub-tree.

Inherited From:
Source:

enableWithParents()

"Enables" this catalog member in a way that makes sense for its implementation (e.g. isEnabled for items, isOpen for groups, and all its parents and ancestors in the tree.

Inherited From:
Source:

findInfoSection(sectionName) → {Object}

Finds an CatalogMember#info section by name.

Parameters:
Name Type Description
sectionName String

The name of the section to find.
Inherited From:
Source:
Returns:

The section, or undefined if no section with that name exists.

Type
Object

getParameterValues() → {Object}

Gets the current parameters to this function.

Inherited From:
Source:
Returns:

An object with a property for each parameter. The property name is the id of the parameter and the property value is the value of that parameter.

Type
Object

invoke() → {AsyncProcessResultCatalogItem}

Invokes the function.

Overrides:
Source:
Returns:

The result of invoking this process. Because the process typically proceeds asynchronously, the result is a temporary catalog item that resolves to the real one once the process finishes.

Type
AsyncProcessResultCatalogItem

load() → {Promise}

Loads this function, if it's not already loaded. It is safe to call this method multiple times. The CatalogFunction#isLoading flag will be set while the load is in progress. Derived classes should implement CatalogFunction#_load to perform the actual loading for the function. Derived classes may optionally implement CatalogFunction#_getValuesThatInfluenceLoad to provide an array containing the current value of all properties that influence this function's load process. Each time that CatalogFunction#load is invoked, these values are checked against the list of values returned last time, and CatalogFunction#_load is invoked again if they are different. If CatalogFunction#_getValuesThatInfluenceLoad is undefined or returns an empty array, CatalogFunction#_load will only be invoked once, no matter how many times CatalogFunction#load is invoked.

Inherited From:
Source:
Returns:

A promise that resolves when the load is complete, or undefined if the function is already loaded.

Type
Promise

serializeToJson(optionsopt) → {Object}

Serializes the data item to JSON.

Parameters:
Name Type Attributes Description
options Object <optional>

Object with the following properties:

Properties
Name Type Attributes Description
propertyFilter function <optional>

Filter function that will be executed to determine whether a property should be serialized.
itemFilter function <optional>

Filter function that will be executed for each item in a group to determine whether that item should be serialized.
Inherited From:
Source:
Returns:

The serialized JSON object-literal.

Type
Object

setParameterValues(parameterValues)

Sets the current parameters to this function.

Parameters:
Name Type Description
parameterValues Object

An object describing the parameters to set and their values. Each property name in this object corresponds to the id of a parameter, and the value of that property is the new value for the parameter. If there is no parameter corresponding to a property in this object, that property is silently ignored.
Inherited From:
Source:

updateFromJson(json, optionsopt) → {Promise}

Updates the catalog member from a JSON object-literal description of it. Existing collections with the same name as a collection in the JSON description are updated. If the description contains a collection with a name that does not yet exist, it is created. Because parts of the update may happen asynchronously, this method returns at Promise that will resolve when the update is completely done.

Parameters:
Name Type Attributes Description
json Object

The JSON description. The JSON should be in the form of an object literal, not a string.
options Object <optional>

Object with the following properties:

Properties
Name Type Attributes Description
onlyUpdateExistingItems Boolean <optional>

true to only update existing items and never create new ones, or false is new items may be created by this update.
isUserSupplied Boolean <optional>

If specified, sets the CatalogMember#isUserSupplied property of updated catalog members to the given value. If not specified, the property is left unchanged.
Inherited From:
Source:
Returns:

A promise that resolves when the update is complete.

Type
Promise