charger.act

Class ActorPrimitive

Object

charger.act.ActorPrimitive

public class ActorPrimitive
extends Object

Contains (mostly static) methods to implement actor primitive operations. Developers are encouraged to use the plug-in interface ActorPlugin for non-primitive actors. TO ADD A PRIMITIVE ACTOR TO THE SYSTEM, do the following:

• create its executable code method in the ActorPrimitive class. Give it some name. Executable code method must call GraphUpdater#updateGNode on any changed outputs. Executable code should deal with inputs/outputs whose value is "null" meaning _|_
• insert a call to its primitive function in the ActorPrimitive#performActorOperation
• insert code to construct an input-output signature in GraphUpdater#registerPrimitives
• insert a test in the GraphUpdater#isExecutable

Author:

Harry S. Delugach ( delugach@uah.edu ) Copyright 1998-2020 by Harry S. Delugach If an actor's input or output concepts have distinct types, then numbering may not strictly be necessary. Numbers are really only required if there might be ambiguity in either input or output ordering.

See Also:

GraphUpdater.updateGNode(charger.obj.GNode), performActorOperation(charger.act.GraphUpdater, java.lang.String, java.util.ArrayList, java.util.ArrayList), GraphUpdater.registerPrimitives(), ActorPlugin

Constructor Summary

Constructors

Constructor and Description
ActorPrimitive()

Method Summary

Modifier and Type	Method and Description
static void	activateArithmeticPrimitive(GraphUpdater gu, String operation, ArrayList inputs, ArrayList outputs) Implements the arithmetic primitives for actors.
static void	activateLogicalPrimitive(GraphUpdater gu, String operation, ArrayList inputs, ArrayList outputs) /** Implements a set of logical primitive actors.
static void	activateLookupPrimitive(GraphUpdater gu, String actorName, ArrayList inputs, ArrayList outputs) Implements a lookup primitive for actors.
static void	activateUnaryPrimitive(GraphUpdater gu, String operation, ArrayList inputs, ArrayList outputs)
protected static void	checkInOutSize(int numInputs, int numOutputs, ArrayList inputs, ArrayList outputs) Verifies that the number of input concepts and the number of output referents for the actor matches its definition.
private static double	operateOnReferents(ArrayList inputs, NumberFormat vformat, String operation) Performs operations for varying input cardinality actors.
static void	performActorOperation(GraphUpdater gu, String actorName, ArrayList inputs, ArrayList outputs) Calculates the output nodes' referents from the input nodes' referents.
private static String	trimDecimals(double result, int numDecimals) trims trailing decimal places (NOT rounded!)

Methods inherited from class Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

ActorPrimitive

public ActorPrimitive()

Method Detail

performActorOperation

public static void performActorOperation(GraphUpdater gu,
                                         String actorName,
                                         ArrayList inputs,
                                         ArrayList outputs)
                                  throws CGActorException

Calculates the output nodes' referents from the input nodes' referents. Assumes that inputs and outputs are well-formed (i.e., verified against the registry)

Parameters:

gu - The updater whose thread should be executing our update

actorName - Label from actual actor that appears in graph.

inputs - The list of input concepts that appear.

outputs - The list of output concepts that appear.

Throws:

CGActorException

checkInOutSize

protected static void checkInOutSize(int numInputs,
                                     int numOutputs,
                                     ArrayList inputs,
                                     ArrayList outputs)
                              throws CGActorException

Verifies that the number of input concepts and the number of output referents for the actor matches its definition. If they don't, throws an exception.

Throws:

CGActorException

activateArithmeticPrimitive

public static void activateArithmeticPrimitive(GraphUpdater gu,
                                               String operation,
                                               ArrayList inputs,
                                               ArrayList outputs)
                                        throws CGActorException

Implements the arithmetic primitives for actors. If any output referents have been changed, then call update

Parameters:

gu - The updater whose thread should be executing our update

operation - One of the arithmetic actor names: "plus" "minus" "multiply" "divide"; also used for "greaterthan" "greaterequal" "lessthan" "lessequal" because they need number inputs also.

inputs - List of GNodes which are the inputs

outputs - List of GNodes which are the outputs

Throws:

CGActorException

See Also:

performActorOperation(charger.act.GraphUpdater, java.lang.String, java.util.ArrayList, java.util.ArrayList)

activateLogicalPrimitive

public static void activateLogicalPrimitive(GraphUpdater gu,
                                            String operation,
                                            ArrayList inputs,
                                            ArrayList outputs)
                                     throws CGActorException

/** Implements a set of logical primitive actors. If any output referents have been changed, then call update

Parameters:

gu - The updater whose thread should be executing our update

operation - one of "equal", "notequal" ; numeric comparisons are in activateArithmeticPrimitive

inputs - List of GNodes which are the inputs

outputs - List of GNodes which are the outputs

Throws:

CGActorException

See Also:

Needs: a way to handle contexts here ...

activateUnaryPrimitive

public static void activateUnaryPrimitive(GraphUpdater gu,
                                          String operation,
                                          ArrayList inputs,
                                          ArrayList outputs)
                                   throws CGActorException

Parameters:

gu - The updater whose thread should be executing our update

operation - one of "copy" "exp"

Throws:

CGActorException

activateLookupPrimitive

public static void activateLookupPrimitive(GraphUpdater gu,
                                           String actorName,
                                           ArrayList inputs,
                                           ArrayList outputs)
                                    throws CGActorException

Implements a lookup primitive for actors. Assumes that one input referents are symbols for a particular defined database (really just hashtables or property lists). If any output referent has been changed, then call update on it.

Parameters:

gu - The updater whose thread should be executing our update

actorName - should be "dbfind"

inputs - List of GNodes which are the inputs

outputs - List of GNodes which are the outputs

Throws:

CGActorException

See Also:

performActorOperation(charger.act.GraphUpdater, java.lang.String, java.util.ArrayList, java.util.ArrayList)

trimDecimals

private static String trimDecimals(double result,
                                   int numDecimals)

trims trailing decimal places (NOT rounded!)

Parameters:

result - value whose decimal is to be rounded

operateOnReferents

private static double operateOnReferents(ArrayList inputs,
                                         NumberFormat vformat,
                                         String operation)
                                  throws CGActorException

Performs operations for varying input cardinality actors.

Parameters:

inputs - The input concept to the actor

vformat - The numberic format to be used in parsing (or formatting) numbers

operation - one of "plus" or "multiply" at present

Throws:

CGActorException