mesquite.lib.duties
Class CharacterSimulator

java.lang.Object
  mesquite.lib.MenuOwner
      mesquite.lib.EmployerEmployee
          mesquite.lib.MesquiteModule
              mesquite.lib.duties.CharacterSimulator

All Implemented Interfaces:

Commandable, Doomable, Explainable, FileDirtier, FunctionExplainable, HNode, Identifiable, Listable, Logger, MesquiteListener, Showable

public abstract class CharacterSimulator
extends MesquiteModule

Simulates characters.

Field Summary

Fields inherited from class mesquite.lib.MesquiteModule

author, browserString, checkMethodsAtStartup, hiredAsDefaultInScripting, lastResult, lastResultString, logWindow, mesquiteDirectory, mesquiteDirectoryPath, mesquiteTrunk, moduleInfo, prefsDirectory, proj, textEdgeCompensationHeight, textEdgeCompensationWidth, totalFinalized, userDirectory

Fields inherited from class mesquite.lib.EmployerEmployee

employees, employer, startupBailOut, stringPos, suppressHireQueries, totalCreated, totalDisposed, useOtherChoices

Fields inherited from class mesquite.lib.MenuOwner

considerPriorities, doomed, MAXPRIORITY, menuCompositionTime, menuCompositionTime1, menuCompositionTime2, menuCompositionTime2a, menuCompositionTime2b, menuCompositionTime2c, menuCompositionTime3, menuCompositionTime4, menuCompositionTime5, menuCompositionTime6, menuCompositionTime7, menuCompositionTime8, menuCompositionTime9, menuTracing, module, parser

Fields inherited from interface mesquite.lib.MesquiteListener

ANNOTATION_ADDED, ANNOTATION_CHANGED, ANNOTATION_DELETED, ASSOCIATED_CHANGED, BRANCHES_REARRANGED, BRANCHLENGTHS_CHANGED, COMMAND_CANCELLED, DATA_CHANGED, ELEMENT_CHANGED, ITEMS_ADDED, NAMES_CHANGED, OBJECT_DESTROYED, PARTS_ADDED, PARTS_CHANGED, PARTS_DELETED, PARTS_MOVED, SELECTION_CHANGED, TAXA_SUBSTITUTED, TEXTFIELD_EDITED, UNKNOWN, VALUE_CHANGED

Fields inherited from interface mesquite.lib.HNode

MOUSEDOWN, MOUSEEXIT, MOUSEMOVE

Constructor Summary

CharacterSimulator()

Method Summary

int	getDefaultNumChars() Returns default number of characters to simulate.
java.lang.Class	getDutyClass() Returns duty Class the module belongs to; should be defined not by module itself but by abstract class representing duty
java.lang.String	getDutyName() Returns the name of the duty; set by the duty-defining library classes.
java.lang.String	getFunctionIconPath() returns an icon to accompany the explanation of what the module does.
int	getMaximumNumChars(Taxa taxa) Returns maximum number of characters to simulate.
abstract CharacterDistribution	getSimulatedCharacter(CharacterDistribution statesAtTips, Tree tree, MesquiteLong seed) Returns a character for the terminal taxa (place in passed CharacterDistribution if it is non-null, and return the same reference, or create new one otherwise).
abstract CharacterHistory	getSimulatedHistory(CharacterHistory statesAtNodes, Tree tree, MesquiteLong seed) Returns a character for all the nodes in the tree (place in passed CharacterDistribution if it is non-null, and return the same reference, or create new one otherwise).
abstract java.lang.Class	getStateClass() Indicates the type of character created (e.g., "CategoricalState")
void	initialize(Taxa taxa) Does any needed initializations.

Methods inherited from class mesquite.lib.MesquiteModule

accumulateParameters, addNEXUSBlock, alert, alert, anySubstantivePrereleases, broadCastAssignedID, changed, classFieldChanged, clearLastResult, clearResultAndLastResult, compatibleWithSystem, containerOfModule, createSupportDirectory, deleteSupportDirectory, discreetAlert, discreetAlert, dispose, disposing, doCommand, echoStringToFile, employeeOutputInvalid, employeeParametersChanged, employeeQuit, employerWithWindow, endJob, fileAboutToBeWritten, fileDirtiedByCommand, fileElementAdded, fileReadIn, finalize, findNEXUSBlock, getAppletInfo, getAuthors, getAutoSaveMacros, getBrowserManualPath, getBrowserPanel, getBuildDate, getBuildVersion, getCitation, getCommandPagePath, getCompatibilityTest, getDateReleased, getDefaultModule, getDocsPath, getExpectedPath, getExplanation, getHireSubchoice, getHTMLExplanation, getID, getIfLastEmployee, getKeywords, getManualPath, getMesquiteVersion, getModuleInfo, getName, getNameAndParameters, getNameForMenuItem, getNexusBlockTest, getNexusCommands, getNexusCommandTest, getPackageImagesPath, getPackageIntroModule, getPackagePath, getParameters, getParametersChangedNotifier, getPath, getPermanentIDString, getProject, getRootImageDirectoryPath, getRootPath, getShortClassName, getShortClassName, getSizedRootImageFilePath, getSnapshot, getSubfunctions, getSubfunctionsVector, getURLString, getUserChooseable, getVersion, getVersionInt, getVersionOfFirstRelease, getVeryShortName, getXMLPrefsVersion, iQuit, iQuit, isCorrectRootTag, isPrerelease, isSubstantive, listEmployeeParameters, listEmployees, loadPreferences, log, log, logln, logln, loglnNoEcho, logNoEcho, makeCommand, mesquiteStartup, nameIsInstanceOf, nameMatches, offHold, okToDispose, onHold, outputInvalid, pageModule, panelGoAway, parametersChanged, parametersChanged, parseFullXMLDocument, permanentIDExists, preparePreferencesForFile, preparePreferencesForXML, processPreferencesFromFile, processPreferencesFromXML, processSingleXMLPreference, projectEstablished, quittingConditions, readNexusBlock, readNexusCommand, readUnrecognizedCommand, registerSubfunction, removeNEXUSBlock, removePaging, reportProfiling, requestPrimaryChoice, respondToPaging, returningPage, saveLastResult, saveLastResult, saveLastResult, saveLastResult, saveLastResultString, saveLastResultString, setAutoSaveMacros, setProject, setToLastEmployee, showCitation, showHTMLSnippet, showLogWindow, showLogWindow, showManual, showMe, showWebPage, showWebPage, sorry, startJob, startProfiling, storePreferences, superStartJob, supportDirectoryPath, toString, URLinPackageIntro, windowGoAway, writeNexusCommands, xmlPrefsVersionMustMatch

Methods inherited from class mesquite.lib.EmployerEmployee

canHireMoreThanOnce, closeDownAllEmployees, decrementEmployeeBrowserRefreshSuppression, deferBranchPriority, employeeOfWhichEmployee, findCharacterDataEditor, findCharacterDataEditorRec, findElementManager, findEmployee, findEmployee, findEmployeeNeed, findEmployeeWithDuty, findEmployeeWithDuty, findEmployeeWithIDNumber, findEmployeeWithName, findEmployeeWithName, findEmployeeWithName, findEmployeeWithPermanentID, findEmployerWithDuty, findImmediateEmployeeWithDuty, findModelCurator, findModelCuratorRec, findModules, findModulesWithDuty, findNearestColleagueWithDuty, findNearestColleagueWithName, findNearestModuleWithDuty, findNextEmployeeWithDuty, fireEmployee, getClonableEmployeeCommand, getEmployeeNeeds, getEmployeeNeedsVector, getEmployeeReference, getEmployeeVector, getEmployer, getEmployerPath, getExplanationByWhichHired, getFileCoordinator, getHColor, getHDaughters, getHImage, getHiredAs, getHiringCommand, getHiringCondition, getHMother, getHShow, getImmediateEmployeesWithDuty, getNextEmployeeWithDuty, getNumberOfEmployees, getNumSupplements, getSearchableAsModule, getSupplementName, getTypeName, hireAllCompatibleEmployees, hireAllEmployees, hireAllOtherCompatibleEmployees, hireAllOtherEmployees, hireCompatibleEmployee, hireEmployee, hireEmployeeFromModuleInfo, hireNamedEmployee, hireNamedEmployee, hireNamedEmployee, hNodeAction, hSupplementTouched, incrementEmployeeBrowserRefreshSuppression, instantiateEmployee, instantiateModule, internalStartUp, isEmployerOf, isMacroAnchor, isPriorityFixed, listEmployees, listNeeds, makeEmployeeVector, moduleActiveWord, moveEmployeeToFront, numCompatibleModulesAvailable, numModulesAvailable, purposeOfEmployee, queryChooseModule, refreshBrowser, registerEmployeeNeed, registerEmployeeNeed, replaceCompatibleEmployee, replaceEmployee, replaceEmployeeWithNext, setHiringCommand, setPriorityFixed, setShowHiringPath, whatIsMyPurpose

Methods inherited from class mesquite.lib.MenuOwner

addAuxiliaryMenu, addCheckMenuItem, addCheckMenuItemToSubmenu, addItemToSubmenu, addItemToSubmenu, addLineToSubmenu, addMenuItem, addMenuItem, addMenuItem, addMenuLine, addModuleMenuItems, addSubmenu, addSubmenu, addSubmenu, addSubmenu, addSubmenu, checkMISVector, composeMenuBar, decrementMenuResetSuppression, defineMenus, deleteAllMenuItems, deleteMenuItem, destroyMenu, disposeMenuSpecifications, doom, findMenuAmongEmployers, getContainingMenuSpec, getMenu, getMenuItemSpecs, getMenuResetSuppression, getModuleWindow, getUseMenubar, incrementMenuResetSuppression, isDoomed, makeMenu, needsMenu, recomposeWindowsMenu, resetAllMenuBars, resetAllWindowsMenus, resetContainingMenuBar, setMenuResetSuppression, setMenuToUse, setModule, setModuleWindow, setUndoMenuItemEnabled, setUseMenubar, showPopUp, zeroMenuResetSuppression

Methods inherited from class java.lang.Object

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

Constructor Detail

CharacterSimulator

public CharacterSimulator()

Method Detail

getDutyClass

public java.lang.Class getDutyClass()

Description copied from class: MesquiteModule

Returns duty Class the module belongs to; should be defined not by module itself but by abstract class representing duty

Specified by:

getDutyClass in class MesquiteModule

getDutyName

public java.lang.String getDutyName()

Description copied from class: MesquiteModule

Returns the name of the duty; set by the duty-defining library classes.

Overrides:

getDutyName in class MesquiteModule

getFunctionIconPath

public java.lang.String getFunctionIconPath()

Description copied from class: MesquiteModule

returns an icon to accompany the explanation of what the module does.

Specified by:

getFunctionIconPath in interface FunctionExplainable

Overrides:

getFunctionIconPath in class MesquiteModule

getStateClass

public abstract java.lang.Class getStateClass()

Indicates the type of character created (e.g., "CategoricalState")

initialize

public void initialize(Taxa taxa)

Does any needed initializations.

getSimulatedCharacter

public abstract CharacterDistribution getSimulatedCharacter(CharacterDistribution statesAtTips,
                                                            Tree tree,
                                                            MesquiteLong seed)

Returns a character for the terminal taxa (place in passed CharacterDistribution if it is non-null, and return the same reference, or create new one otherwise).

getSimulatedHistory

public abstract CharacterHistory getSimulatedHistory(CharacterHistory statesAtNodes,
                                                     Tree tree,
                                                     MesquiteLong seed)

Returns a character for all the nodes in the tree (place in passed CharacterDistribution if it is non-null, and return the same reference, or create new one otherwise).

getMaximumNumChars

public int getMaximumNumChars(Taxa taxa)

Returns maximum number of characters to simulate.

getDefaultNumChars

public int getDefaultNumChars()

Returns default number of characters to simulate.