• Manual
  • HAPI Namespace
Show / Hide Table of Contents
  • HAPI
    • AbsExpression
    • AddExpression
    • AggregateExpression
    • AndExpression
    • Attribute
    • BetaDistribution
    • BinomialDistribution
    • BooleanDCNode
    • BooleanDDNode
    • BooleanDFNode
    • BooleanExpression
    • CeilExpression
    • Class
    • ClassCollection
    • ClassList
    • ClassParseListener
    • Clique
    • CliqueList
    • CompositeExpression
    • ConstantExpression
    • ContinuousChanceNode
    • CosExpression
    • CoshExpression
    • DataSet
    • DefaultClassParseListener
    • DiscreteChanceNode
    • DiscreteDecisionNode
    • DiscreteFunctionNode
    • DiscreteNode
    • DistributionDistribution
    • DivideExpression
    • Domain
    • Domain.Equilibrium
    • Domain.EvidenceMode
    • Domain.TriangulationMethod
    • EqualsExpression
    • ExceptionArgumentNotAlive
    • ExceptionBadKBFormat
    • ExceptionBadKBPassword
    • ExceptionBadKBVersion
    • ExceptionCGEvidenceIncorporated
    • ExceptionCGLIMIDsNotSupported
    • ExceptionCaseStateTooLarge
    • ExceptionChainGraph
    • ExceptionCompressed
    • ExceptionComputationFailed
    • ExceptionCyclicFunctionalDependency
    • ExceptionCyclicInstanceHierarchy
    • ExceptionCyclicNetwork
    • ExceptionDemo
    • ExceptionDivisionByZero
    • ExceptionEnumeration
    • ExceptionError
    • ExceptionExpiredLicense
    • ExceptionFastRetraction
    • ExceptionFunctionalDependency
    • ExceptionHugin
    • ExceptionIO
    • ExceptionIllegalBinding
    • ExceptionInappropriateArguments
    • ExceptionInconsistencyOrUnderflow
    • ExceptionInsufficientStateRange
    • ExceptionInvalidEvidence
    • ExceptionInvalidExpression
    • ExceptionInvalidLicense
    • ExceptionInvalidName
    • ExceptionInvalidProbabilityPotential
    • ExceptionInvalidStateValues
    • ExceptionLocale
    • ExceptionLowDensity
    • ExceptionMemory
    • ExceptionNoEquilibrium
    • ExceptionNoValue
    • ExceptionNormalization
    • ExceptionNotCompiled
    • ExceptionObjectNotAlive
    • ExceptionOverflow
    • ExceptionParse
    • ExceptionRounding
    • ExceptionSizeTooLarge
    • ExceptionSyntax
    • ExceptionTableTooLarge
    • ExceptionTwice
    • ExceptionUsage
    • ExceptionZeroVariance
    • ExpExpression
    • ExponentialDistribution
    • Expression
    • Expression.Operator
    • ExpressionList
    • FloorExpression
    • FunctionNode
    • GammaDistribution
    • GeometricDistribution
    • GreaterThanExpression
    • GreaterThanOrEqualsExpression
    • IfExpression
    • InstanceNode
    • IntervalDCNode
    • IntervalDDNode
    • IntervalDFNode
    • JunctionTree
    • JunctionTreeList
    • LabelExpression
    • LabelledDCNode
    • LabelledDDNode
    • LabelledDFNode
    • LessThanExpression
    • LessThanOrEqualsExpression
    • Log10Expression
    • Log2Expression
    • LogExpression
    • LogNormalDistribution
    • MaxExpression
    • MinExpression
    • ModExpression
    • Model
    • MultiplyExpression
    • NegateExpression
    • NegativeBinomialDistribution
    • NetworkModel
    • NetworkModel.Constraint
    • Node
    • Node.Category
    • Node.Kind
    • NodeExpression
    • NodeList
    • NoisyOrDistribution
    • NormalDistribution
    • NotEqualsExpression
    • NotExpression
    • NumberExpression
    • NumberedDCNode
    • NumberedDDNode
    • NumberedDFNode
    • NumericDiscreteNode
    • OrExpression
    • PERTDistribution
    • ParseListener
    • PoissonDistribution
    • PowerExpression
    • ProbabilityExpression
    • QuantileExpression
    • SinExpression
    • SinhExpression
    • SqrtExpression
    • StateIndexExpression
    • SubtractExpression
    • Table
    • TanExpression
    • TanhExpression
    • TriangularDistribution
    • TruncateExpression
    • UniformDistribution
    • UtilityNode
    • VarianceExpression
    • WeibullDistribution

Class UtilityNode

A UtilityNode represents a utility function. The utility function can depend on discrete chance and decision Nodes.

Inheritance
object
Node
UtilityNode
Implements
ICloneable
Inherited Members
Node.IsAlive()
Node.Delete()
Node.SetName(string)
Node.GetName()
Node.AddParent(Node)
Node.AddToInputs()
Node.AddToOutputs()
Node.Clone()
Node.EvidenceIsEntered()
Node.EvidenceIsPropagated()
Node.EvidenceToPropagate()
Node.GetAttribute(string)
Node.GetAttributes()
Node.GetChildren()
Node.GetEdgeConstraint(Node)
Node.GetHome()
Node.GetHomeClass()
Node.GetHomeDomain()
Node.GetInstance()
Node.GetJunctionTree()
Node.GetLabel()
Node.GetMaster()
Node.GetParents()
Node.GetPosition()
Node.SetPosition(Point)
Node.GetUserData()
Node.SetUserData(object)
Node.GetSource()
Node.LikelihoodIsEntered()
Node.LikelihoodIsPropagated()
Node.RemoveFromInputs()
Node.RemoveFromOutputs()
Node.RemoveParent(Node)
Node.ReverseEdge(Node)
Node.SetAttribute(string, string)
Node.SetAttributes(List<Attribute>)
Node.SetEdgeConstraint(Node, NetworkModel.Constraint)
Node.SetLabel(string)
Node.SwitchParent(Node, Node)
Node.GetModel()
Node.GetTable()
Node.CreateTemporalClone()
Node.GetTemporalClone()
Node.GetTemporalMaster()
object.GetType()
object.MemberwiseClone()
object.ToString()
object.Equals(object)
object.Equals(object, object)
object.ReferenceEquals(object, object)
object.GetHashCode()
Namespace: HAPI
Assembly: hugincs-9.7-netstandard2.0-x64.dll
Syntax
public class UtilityNode : Node, ICloneable
Remarks

UtilityNodes are used in influence diagrams to represent utilities associated with decision options.

Constructors

UtilityNode(NetworkModel)

Constructs a new UtilityNode in a NetworkModel (i.e., a Class or a Domain).

Declaration
public UtilityNode(NetworkModel belongsTo)
Parameters
Type Name Description
NetworkModel belongsTo

the NetworkModel in which the new UtilityNode should be created.

Exceptions
Type Condition
ExceptionHugin

Methods

GenerateTable()

Generates the utility table of this UtilityNode from its model.

Declaration
public void GenerateTable()
Exceptions
Type Condition
ExceptionHugin

GetCategory()

Returns the Category of this Node

Declaration
public override Node.Category GetCategory()
Returns
Type Description
Node.Category

H_CATEGORY_UTILITY

Overrides
Node.GetCategory()

GetExpectedUtility()

Returns the expected utility associated with this UtilityNode.

Declaration
public float GetExpectedUtility()
Returns
Type Description
float

expected utility associated with this UtilityNode.

Exceptions
Type Condition
ExceptionHugin

GetKind()

Returns the Kind of this Node.

Declaration
public override Node.Kind GetKind()
Returns
Type Description
Node.Kind

H_KIND_DISCRETE

Overrides
Node.GetKind()

GetMaxUtility()

Returns the maximum possible utility associated with this UtilityNode. This is the largest utility value for this node with a positive probability as computed by the most recent inference operation.

Declaration
public float GetMaxUtility()
Returns
Type Description
float

maximum possible utility associated with this UtilityNode.

Exceptions
Type Condition
ExceptionHugin

GetMinUtility()

Returns the minimum possible utility associated with this UtilityNode. This is the smallest utility value for this node with a positive probability as computed by the most recent inference operation.

Declaration
public float GetMinUtility()
Returns
Type Description
float

minimum possible utility associated with this UtilityNode.

Exceptions
Type Condition
ExceptionHugin

GetSampledUtility()

Returns the sampled utility associated with this UtilityNode.

Declaration
public float GetSampledUtility()
Returns
Type Description
float

sampled utility associated with this UtilityNode.

Remarks

This is the utility value determined by the most recent call to Simulate().

Exceptions
Type Condition
ExceptionHugin

GetVarianceOfUtility()

Returns the variance of the utility associated with this UtilityNode. This is the variance of the utility value computed by the most recent inference operation.

Declaration
public float GetVarianceOfUtility()
Returns
Type Description
float

variance of the utility associated with this UtilityNode.

Exceptions
Type Condition
ExceptionHugin

Implements

ICloneable
In this article
Back to top Copyright (C) 2019-2025 Hugin Expert A/S