Claims Computed on WarmHub

You can have claims automatically computed on WarmHub to make building your assertion tree very easy.

To have WarmHub compute your claim, you will need to set up a claim type and select the "Compute on WarmHub" Checkbox, in the Create a New Claim dialogue.

Description - You will want to give your type a good description so that it is easy to understand how the claim is being computed.

About - Select the Article Type that the Claim will be about, from the list of available Article Types in your repo

Collectors

Collectors are how you gather the array(s) of assertions that will be used to compute the properties of your claim.

• Name - This is the name of your collector that will used to reference it in your computations

• Assertion Type - The is the Assertion Type that the collector will be collecting properties from. The list will be populated by all of the available Assertion Types in your repo

• Count - This is the limit of how many assertions you want to gather properties from. For example, setting this to 10, would collect up to the last 10 instances of the specified assertion type, subject to the Date Offset

• Date Offset - This allows you to define the time period for which you would like to collect from. It uses ISO 8601 Durations.

  • ISO 8601 is an international standard that facilitates the exchange and communication of date and time-related data. It provides a consistent format for representing durations, which can be particularly useful in various applications, such as programming and data analysis. To create durations in ISO 8601 format, you use the "P" (period) designator followed by time components. For example, P1D represents a duration of one day, while PT15M indicates a duration of 15 minutes. You can also combine these to express more complex durations, such as P1DT15M, which means one day and 15 minutes. If you ever need help crafting the right expression for your needs, asking your favorite language model (LLM) is a great way to get assistance!

• Property to Collect

  • This is what property, from the selected assertion type that you want to collect.

Properties

Other than the $id which is a required property for all assertions, every property on claim that WarmHub is computing must come from an expression, that WarmHub can compute.

When setting up a property, the Type selected will determine the expressions that are available.

Once a property has been created, you must select an expression to compute that property. The currently available expressions are listed below.

Function	Description	Collector Data Type	Claim Property Data Type
Average	Calculates the Average of an array of numbers	numbers	number
Stdev	Calculates the Standard Deviation of an array of numbers	numbers	number
Variance	Calculates the Variance of an array of numbers	numbers	number
RMSE	Calculates the Root Mean Square Error of an array of numbers	numbers	number
Median	Calculates the Median of an array of numbers	numbers	number
Mode	Calculates the Mode of an array of numbers	numbers	number
Magnitude	Calculates the Magnitude of an array of numbers	numbers	number
Concat	Concenates strings	String	String
AverageDateTimeDelta	Calculates the Average Time Delta between consecutive DateTime values	DateTimes	Time
AllTruthy	Checks if all values are Truthy	Any	Boolean
AllFalsy	Checks if all values are Falsy	Any	Boolean
PercentageTruthy	Calculates the percentage of truthy values in an array	Any	Boolean
PercentageFalsy	Calculates the percentage of falsy values in an array	Any	Boolean

Triggers

Triggers are where you can set the event or events that cause the defined claim to be computed and committed. Typically, this will be when a certain type of assertion is made.