ParsedTarget

java.lang.Object
- util.PropertyContainer
- - util.PropertyResources
  - - target.AbstractTarget
    - - stella.xml.SporeTarget
      - stella.xml.ParsedTarget

All Implemented Interfaces:

Serializable, Cloneable, Comparable<ParsedTarget>, Appointable, Handable, HistoryAware, Observable, TargetDefinition, PropertySupplying, ResourceSupplying

Direct Known Subclasses:

GrbTarget
```
public class ParsedTarget
extends SporeTarget
implements HistoryAware, Appointable, Observable, Comparable<ParsedTarget>
```
An DOM-based description of a target. This TargetDefinition can be parsed from and to an xml-file, see TargetFragment, but has no document specific elements in it. This class should be used in the STELLA observations. It is fed and can be exported to xml-files. For details of the xml-format, see DOMTarget.

See Also:

Serialized Form

Nested Class Summary

Nested Classes
Modifier and Type	Class and Description
`private class`	`ParsedTarget.RateThread` A thread that waits for an expression to be fulfilled, then queries its constraints and rates an observation as successful, if everthing is fulfilled.

Nested classes/interfaces inherited from class stella.xml.SporeTarget
SporeTarget.Constraint, SporeTarget.Dump

Nested classes/interfaces inherited from class target.AbstractTarget
AbstractTarget.Aim, AbstractTarget.Allocation, AbstractTarget.ConstraintAdapter, AbstractTarget.FitsEntry, AbstractTarget.PickAdapter, AbstractTarget.Setup, AbstractTarget.TargetComparator

Nested classes/interfaces inherited from class util.PropertyResources
PropertyResources.Load, PropertyResources.URLResource

Nested classes/interfaces inherited from interface stella.HistoryAware
HistoryAware.Pick

Nested classes/interfaces inherited from interface stella.Appointable
Appointable.Constraint

Field Summary

Fields
Modifier and Type	Field and Description
`private boolean`	`abort` A flag stating that the target should be aborted.
`private Map<String,Appointable>`	`daughters` Keys from xml-file, parsed on `resolveChildren(java.util.Collection<stella.Appointable>)`.
`private double`	`daymerit` The daily high merit.
`private long`	`daytime` and its date.
`private static double`	`DEFACCELERATE` The default parameter name giving the remaining night-time.
`private static int`	`DEFDELAYMAX` Default number of delays.
`private static long`	`DEFDELAYTIME` Default time of delays.
`private static double`	`DEFMERITCAP` The default merit cap.
`private static String`	`DEFNIGHT` The default parameter name giving the remaining night-time.
`private static boolean`	`DEFOBSBAD` The default resources.
`private static boolean`	`DEFOBSGOOD` The default resources.
`private static int`	`DEFRATERETRY` The maximum number of retries to rate a target.
`private static long`	`DEFRATEWAIT` The wait time between individual rate attempts.
`private static int`	`DEFRETRYMAX` Default number of retries.
`private int`	`delaycount` The number of actual delays.
`private static List<TimerTask>`	`delays` The timer to allow re-enabling of the target.
`private static Timer`	`delaytimer` The timer to allow re-enabling of the target.
`private boolean`	`finished` Signals that this target has been finished.
`private double`	`himerit` The highest merit achieved.
`private long`	`hitime` The highest merit time.
`private static HistorySql`	`hsql` The history database.
`static String`	`KEY_ACCELERATE` The key to the optional acceleration.
`static String`	`KEY_CALCULATOR` The key to the properties of the exposure time calculator.
`static String`	`KEY_HISTORYDB` If special history-db properties are required.
`static String`	`KEY_NIGHT` The key to the parameter name of the remaining night-time.
`static String`	`KEY_OBSBAD` Defaults to false.
`static String`	`KEY_OBSGOOD` Defaults to false.
`static String`	`KEY_RATERETRY` The maximum number of retries to rate a target.
`static String`	`KEY_RATEWAIT` The wait time between individual rate attempts.
`static String`	`KEY_TASKDB` If special task-db properties are required.
`private Appointable.Constraint`	`lastfail` The constraint that made observing impossible.
`private double`	`lastmerit` The last merit achieved.
`private Handable`	`parent` The parent target.
`private boolean`	`picked` True when the target gets picked.
`private static ThreadGroup`	`rategroup` The rate thread groups.
`private boolean`	`retry` A flag stating that the target should be retried immediately.
`private int`	`retrycount` The number of actual retries.
`private static long`	`serialVersionUID` Sometimes this must be changed!.
`private Appointable`	`successor` The successor target.
`private boolean`	`triumph` True until an error signals unsuccessful target execution.
`private static TaskSql`	`tsql` The task database.

Fields inherited from class stella.xml.SporeTarget
aborting, astronomy, blocking, canrate, constraints, daughternames, dbread, dbwrite, DEFIMAGETYPE, delaying, delaymax, delaytime, description, duration, email, enabled, fitsheader, gains, hdbread, hdbwrite, history, historymax, historyover, ignoring, imagetype, institution, KEY_IMAGETYPE, notify, proposal, rate, requires, retrying, retrymax, setup, submitted, successorname, targetfile, targetname, targettype, team, timeslots, title, user

Fields inherited from class target.AbstractTarget
expo

Fields inherited from class util.PropertyResources
KEY_NOINITONCREATE, POSTFIX_ALPHABET, POSTFIX_BYTES, POSTFIX_DIR, POSTFIX_EXT, POSTFIX_FILE, POSTFIX_LIST, POSTFIX_MODTIME, POSTFIX_URL

Fields inherited from class util.PropertyContainer
KEY_LISTSEPARATOR, KEY_MAPKEYVALUECHAR, KEY_MAPSEPARATOR

Fields inherited from interface util.ResourceSupplying
KEY_URLRESOURCES, KEY_URLUSECONFIG, KEY_URLUSECURRENT, KEY_URLUSEHOME

Fields inherited from interface util.PropertySupplying
CONFIG, KEY_CLASS

Constructor Summary

Constructors
Constructor and Description

ParsedTarget()

ParsedTarget(Map<String,String> prop)
Constructs a new xml target.

Constructors
Constructor and Description
`ParsedTarget()`
`ParsedTarget(Map<String,String> prop)` Constructs a new xml target.

Method Summary

All Methods Static Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`void`	`addExecution(GlobalGrouping condition, Date start, long duration, String unique, String rem)` Adds a pick to this target.
`private boolean`	`checkConstraints(GlobalGrouping condition, List<Appointable.Constraint> olimit)` Checks the constraints if any are over.
`private boolean`	`checkOver(GlobalGrouping condition, List<?> merits)` Checks the list of merits for possible end point-defining merits.
`int`	`compareTo(ParsedTarget o)` Compares two parsed targets.
`boolean`	`equals(Object that)` Compares this target definition for equality.
`void`	`errorDaughter(ErrorEvent success, ErrorFinalizing finish, ParameterClustering set)` Signals that an error has occured in a daughter of this target.
`void`	`errorMain(ErrorEvent success, ErrorFinalizing finish, ParameterClustering set)` Signals that an error has occured in this target.
`void`	`errorSuccessor(ErrorEvent success, ErrorFinalizing finish, ParameterClustering set)` Signals that an error has occured in the successor to this target.
`double`	`getActualMerit(GlobalGrouping condition, Collection<Appointable> oftargets, long within)` Returns the actual value of the merit of this target.
`Date`	`getDailyDate()` The date of the high daily merit.
`double`	`getDailyMerit()` The highest merit in the last 24 hours.
`Collection<Appointable>`	`getDaughters()` Returns a list of daugther targets.
`Date`	`getHighestDate()` The date of the highest merit.
`double`	`getHighestMerit()` The highest merit ever achieved.
`Appointable.Constraint`	`getLastFail()` If anybody want to query why we have been unobservable, use this method.
`double`	`getLastMerit()` If anybody wants to query the last merit the target achieved and not want to wander through the `TargetMerit` parameter.
`long`	`getObservingTime(GlobalGrouping set)` Returns an estimate of the observing time required for this target.
`Handable`	`getPrecursor()` Returns the parent target.
`long`	`getRemainingTime(GlobalGrouping set)` Returns the remaining time of the observation time for this target.
`private long`	`getRemainingTime(GlobalGrouping set, boolean info)` Returns the remaining time of the observation time for this target.
`Appointable`	`getSuccessor()` Returns the successor target, if this target has one.
`int`	`hashCode()` For entries in hash-tables.
`boolean`	`isAbort(GlobalGrouping set)` Checks if the target should be aborted.
`boolean`	`isFinished()` Returns the finished flag.
`boolean`	`isNotify(UserProfile.Notifies condition)` Returns true if the condition passed over is found in the notification list.
`boolean`	`isObservable(GlobalGrouping condition)` Determines if this target is currently observable.
`boolean`	`isPicked()` Returns true if this target is currently picked.
`boolean`	`isProgramOver(GlobalGrouping condition)` Checks if a target has completed is life-cycle within an observing program.
`boolean`	`isRetry(GlobalGrouping set)` Checks if the target should be retried.
`static ParsedTarget`	`makeRunnable(String tel, SporeTarget skel)`
`private void`	`processError(ErrorEvent success, ErrorFinalizing finish, ParameterClustering set, List<String> blocklist, List<String> delaylist, Integer delmax, Long deltime, List<String> retrylist, Integer retmax, List<String> ignorelist, List<String> abortlist)` Depending on the target the termination acts on, the different abort sections are loaded.
`boolean`	`resolveChildren(Collection<Appointable> alltargets)` Resolve all children.
`void`	`setEnabled(boolean to)` Sets the access attribute to `enabled`.
`void`	`setFinished(boolean isready)` Sets the finished flag.
`static void`	`setHistorySql(HistorySql h)` Sets the history database.
`void`	`setLoggingForFailedConstraints(boolean to)` We set the volatile flag for extensive logging on reasons why this target is not observable during night run.
`void`	`setLoggingForObservingTime(boolean to)` Announce interest on logging the target's remaining observing time
`void`	`setPicked(boolean ispicked)` Signals that this target has been selected for observing.
`void`	`setPrecursor(Handable anchestor)` Sets the parent target of this target.
`void`	`setProgramCompleted(boolean over)` Returns true if the observing program on this target is over.
`static void`	`setTaskSql(TaskSql t)` Sets the task database.
`String`	`toString()` Returns a string representation of the DOM-Target.
`private static void`	`trimHistory(List<? extends HistoryAware.Pick> history, long notlater)` Trimming the histroy means removing any pick that is later than the stated day.

Methods inherited from class stella.xml.SporeTarget
addDaughterName, clearHistory, getAbortErrors, getAstronomicalData, getBlockErrors, getConstraints, getDatabaseRead, getDatabaseWrite, getDaughterNames, getDelayErrors, getDelays, getDelayTimes, getDescription, getDescriptionID, getDuration, getEmailAddresses, getEntireHistory, getFailure, getFailureCount, getFile, getFirstFailure, getFirstPick, getFirstSuccess, getFitsHeader, getGainMerits, getHistoryDatabaseRead, getHistoryDatabaseWrite, getHistoryMax, getIgnoreErrors, getImageType, getInstitution, getLastFailure, getLastPick, getLastSuccess, getName, getNotify, getPick, getPickCount, getRateConstraints, getRateRequires, getRequires, getRetries, getRetryErrors, getSetups, getSubmitted, getSuccess, getSuccessCount, getSuccessorName, getTargetResource, getTargetSpecific, getTeam, getTimeslotMerits, getTitle, getType, getUser, isEnabled, isProgramCompleted, setAstronomicalData, setConstraints, setDatabaseAccess, setDelayAndRetry, setDescription, setDuration, setEmailAddresses, setErrors, setFitsHeader, setHistory, setHistoryDatabaseAccess, setImageType, setInstitution, setMerits, setNotify, setRateConstraints, setRateRequires, setRequires, setSetups, setSubmitted, setSuccessorName, setTargetFile, setTargetName, setTargetType, setTeam, setTitle, setUser, sumExposures

Methods inherited from class util.PropertyResources
clone, createFrom, createFrom, createFrom, createInstance, getApplet, getAsResources, getLocate, getPropertiesToKey, getPropertiesToKey, getResource, getResourceAsStream, getResourceFromKey, getResources, hasLocalURLs, initProperties, keyCreate, keyCreate, reload, setApplet

Methods inherited from class util.PropertyContainer
augment, augment, augment, augment, augment, defaultBoolean, defaultChar, defaultDouble, defaultFloat, defaultInt, defaultLong, defaultObject, defaultObject, defaultProperties, defaultProperty, getAsBoolean, getAsChar, getAsDouble, getAsEnums, getAsFloat, getAsInt, getAsList, getAsLong, getAsMap, getAsMap, getAsObject, getAsObject, getProperties, getProperty, has, isNew, parseObject, parseObject, reload, removeProperty, requires, rescanned, setObject, setProperties, setProperty, stringProperties

Methods inherited from class java.lang.Object
finalize, getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface stella.HistoryAware
getEntireHistory, getFailure, getFailureCount, getFirstFailure, getFirstPick, getFirstSuccess, getLastFailure, getLastPick, getLastSuccess, getPick, getPickCount, getSubmitted, getSuccess, getSuccessCount, isProgramCompleted

Methods inherited from interface stella.Handable
isEnabled

Methods inherited from interface target.TargetDefinition
getDescription, getDescriptionID, getEmailAddresses, getImageType, getInstitution, getName, getTargetResource, getTargetSpecific, getTeam, getTitle, getType, getUser

Methods inherited from interface util.PropertySupplying
defaultBoolean, defaultChar, defaultDouble, defaultFloat, defaultInt, defaultLong, defaultObject, defaultObject, defaultProperties, defaultProperty, getAsBoolean, getAsChar, getAsDouble, getAsFloat, getAsInt, getAsList, getAsLong, getAsMap, getAsObject, getAsObject, getProperties, getProperty, has, parseObject, removeProperty, setObject, setProperty, stringProperties

- Field Detail
  - serialVersionUID
```
private static final long serialVersionUID
```
    Sometimes this must be changed!.
    
    See Also:
    
    Constant Field Values
  - KEY_NIGHT
```
public static final String KEY_NIGHT
```
    The key to the parameter name of the remaining night-time.
    
    See Also:
    
    Constant Field Values
  - KEY_ACCELERATE
```
public static final String KEY_ACCELERATE
```
    The key to the optional acceleration. Used mainly for testing.
    
    See Also:
    
    Constant Field Values
  - KEY_CALCULATOR
```
public static final String KEY_CALCULATOR
```
    The key to the properties of the exposure time calculator.
    
    See Also:
    
    Constant Field Values
  - KEY_RATERETRY
```
public static final String KEY_RATERETRY
```
    The maximum number of retries to rate a target.
    
    See Also:
    
    Constant Field Values
  - KEY_RATEWAIT
```
public static final String KEY_RATEWAIT
```
    The wait time between individual rate attempts.
    
    See Also:
    
    Constant Field Values
  - KEY_HISTORYDB
```
public static final String KEY_HISTORYDB
```
    If special history-db properties are required.
    
    See Also:
    
    Constant Field Values
  - KEY_TASKDB
```
public static final String KEY_TASKDB
```
    If special task-db properties are required.
    
    See Also:
    
    Constant Field Values
  - KEY_OBSBAD
```
public static final String KEY_OBSBAD
```
    Defaults to false.
    
    See Also:
    
    Constant Field Values
  - KEY_OBSGOOD
```
public static final String KEY_OBSGOOD
```
    Defaults to false.
    
    See Also:
    
    Constant Field Values
  - DEFRETRYMAX
```
private static final int DEFRETRYMAX
```
    Default number of retries.
    
    See Also:
    
    Constant Field Values
  - DEFDELAYMAX
```
private static final int DEFDELAYMAX
```
    Default number of delays.
    
    See Also:
    
    Constant Field Values
  - DEFDELAYTIME
```
private static final long DEFDELAYTIME
```
    Default time of delays.
    
    See Also:
    
    Constant Field Values
  - DEFRATERETRY
```
private static final int DEFRATERETRY
```
    The maximum number of retries to rate a target.
    
    See Also:
    
    Constant Field Values
  - DEFRATEWAIT
```
private static final long DEFRATEWAIT
```
    The wait time between individual rate attempts.
    
    See Also:
    
    Constant Field Values
  - DEFNIGHT
```
private static final String DEFNIGHT
```
    The default parameter name giving the remaining night-time.
    
    See Also:
    
    Constant Field Values
  - DEFMERITCAP
```
private static final double DEFMERITCAP
```
    The default merit cap.
    
    See Also:
    
    Constant Field Values
  - DEFACCELERATE
```
private static final double DEFACCELERATE
```
    The default parameter name giving the remaining night-time.
    
    See Also:
    
    Constant Field Values
  - DEFOBSBAD
```
private static final boolean DEFOBSBAD
```
    The default resources.
    
    See Also:
    
    Constant Field Values
  - DEFOBSGOOD
```
private static final boolean DEFOBSGOOD
```
    The default resources.
    
    See Also:
    
    Constant Field Values
  - finished
```
private boolean finished
```
    Signals that this target has been finished. Used for target-chaining.
  - picked
```
private boolean picked
```
    True when the target gets picked. False if not picked.
  - triumph
```
private boolean triumph
```
    True until an error signals unsuccessful target execution.
  - abort
```
private boolean abort
```
    A flag stating that the target should be aborted.
  - lastfail
```
private Appointable.Constraint lastfail
```
    The constraint that made observing impossible.
  - lastmerit
```
private double lastmerit
```
    The last merit achieved.
  - himerit
```
private double himerit
```
    The highest merit achieved.
  - hitime
```
private long hitime
```
    The highest merit time.
  - daymerit
```
private double daymerit
```
    The daily high merit.
  - daytime
```
private long daytime
```
    and its date.
  - retry
```
private boolean retry
```
    A flag stating that the target should be retried immediately.
  - retrycount
```
private int retrycount
```
    The number of actual retries.
  - delaycount
```
private int delaycount
```
    The number of actual delays.
  - parent
```
private Handable parent
```
    The parent target. Set during parent construction.
  - successor
```
private Appointable successor
```
    The successor target. Parsed on resolveChildren(java.util.Collection<stella.Appointable>).
  - daughters
```
private Map<String,Appointable> daughters
```
    Keys from xml-file, parsed on resolveChildren(java.util.Collection<stella.Appointable>).
  - delaytimer
```
private static transient Timer delaytimer
```
    The timer to allow re-enabling of the target.
  - delays
```
private static transient List<TimerTask> delays
```
    The timer to allow re-enabling of the target.
  - rategroup
```
private static transient ThreadGroup rategroup
```
    The rate thread groups.
  - hsql
```
private static transient HistorySql hsql
```
    The history database.
  - tsql
```
private static transient TaskSql tsql
```
    The task database.
- Constructor Detail
  - ParsedTarget
```
public ParsedTarget()
```
  - ParsedTarget
```
public ParsedTarget(Map<String,String> prop)
```
    Constructs a new xml target. Defaults the KEY_NIGHT, the KEY_ACCELERATE and the KEY_CALCULATOR.
- Method Detail
  - makeRunnable
```
public static ParsedTarget makeRunnable(String tel,
                                        SporeTarget skel)
```
  - setLoggingForFailedConstraints
```
public void setLoggingForFailedConstraints(boolean to)
```
    We set the volatile flag for extensive logging on reasons why this target is not observable during night run.
    
    Specified by:
    
    setLoggingForFailedConstraints in interface Observable
  - setLoggingForObservingTime
```
public void setLoggingForObservingTime(boolean to)
```
    Description copied from interface: Observable
    
    Announce interest on logging the target's remaining observing time
    
    Specified by:
    
    setLoggingForObservingTime in interface Observable
  - setHistorySql
```
public static void setHistorySql(HistorySql h)
```
    Sets the history database. Constructed from properties on first parsed target construct, or from outside.
  - setTaskSql
```
public static void setTaskSql(TaskSql t)
```
    Sets the task database. Constructed from properties on first parsed target construct, or from outside.
  - hashCode
```
public int hashCode()
```
    For entries in hash-tables.
    
    Overrides:
    
    hashCode in class Object
  - getPrecursor
```
public Handable getPrecursor()
```
    Returns the parent target. The parent target is only set if construction of this daughter target was done at creation of the parent target.
    
    Specified by:
    
    getPrecursor in interface Handable
  - setPrecursor
```
public void setPrecursor(Handable anchestor)
```
    Sets the parent target of this target.
    
    Specified by:
    
    setPrecursor in interface Handable
  - setEnabled
```
public void setEnabled(boolean to)
```
    Sets the access attribute to enabled.
    
    Specified by:
    
    setEnabled in interface Handable
    
    Overrides:
    
    setEnabled in class SporeTarget
  - setFinished
```
public void setFinished(boolean isready)
```
    Sets the finished flag. Used during target chaining. Should be reset after all chain-links of the target has been executed.
    
    Specified by:
    
    setFinished in interface Handable
  - isFinished
```
public boolean isFinished()
```
    Returns the finished flag. Used to avoid multiple executions in target-chaining.
    
    Specified by:
    
    isFinished in interface Handable
  - setPicked
```
public void setPicked(boolean ispicked)
```
    Signals that this target has been selected for observing. If the argument is false, the selection time is reset. This time is used for adding a DTDConstants.PICK section when this method is called with a false argument. Additionally, this method clears some flags:
    - The abort flag is cleared, whenever this method is called.
    - The retry counter is reset, when the target is not doing a retry method is called. The retry counter also acts as the retry flag.
    Specified by:
    
    setPicked in interface Handable
    
    See Also:
    
    Handable.errorMain(stella.ErrorEvent, stella.ErrorFinalizing, stella.ParameterClustering)
  - isPicked
```
public boolean isPicked()
```
    Returns true if this target is currently picked. This does not guarantee that this target is observed right now, it only reveals the fact that a scheduler has signaled the target selection via the setPicked(boolean) method.
    This method check if the selection time is bigger than zero.
    
    Specified by:
    
    isPicked in interface Handable
    
    Returns:
    
    True as soon as the scheduler signals picking.
    
    See Also:
    
    Handable.setPicked(boolean)
  - isNotify
```
public boolean isNotify(UserProfile.Notifies condition)
```
    Returns true if the condition passed over is found in the notification list.
    
    Specified by:
    
    isNotify in interface Handable
    
    Parameters:
    
    condition - An object-specific identifier for user notifiaction.
  - errorMain
```
public void errorMain(ErrorEvent success,
                      ErrorFinalizing finish,
                      ParameterClustering set)
```
    Signals that an error has occured in this target. If the error event handed over is null or a status event, the observation is considered successful. In any other case, the type of the error event defines the further treatment of the target.
    - If the error is found in the DTDConstants.IGNORE list, the observation is considered successful, i.e. the error encounter is spurious.
    - If the error is found in the DTDConstants.RETRY list and its current retry-count has not reached the maximum retries, it is rescheduled immediately, if it is still observable. If the maximum retries are reached, the target is disabled.
    - If the error is found in the DTDConstants.DELAY list and its current delay-count has not reached its maximum, the target is disabled for the stated amount of time and may be picked afterwards. If the maximum retries are reached, the target is disabled.
    - If the error is either stated in the DTDConstants.BLOCK list or is unknown, further target picking is disabled.
    - If the error is found in the DTDConstants.ABORT section, the abort flag is raised.
    Specified by:
    
    errorMain in interface Handable
    
    Parameters:
    
    success - The ErrorEvent outcome of the last sequence.
    
    at - The target which was executed and produced the outcome.
    
    See Also:
    
    processError(stella.ErrorEvent, stella.ErrorFinalizing, stella.ParameterClustering, java.util.List<java.lang.String>, java.util.List<java.lang.String>, java.lang.Integer, java.lang.Long, java.util.List<java.lang.String>, java.lang.Integer, java.util.List<java.lang.String>, java.util.List<java.lang.String>)
  - errorDaughter
```
public void errorDaughter(ErrorEvent success,
                          ErrorFinalizing finish,
                          ParameterClustering set)
```
    Signals that an error has occured in a daughter of this target. If the error event handed over is null or a status event, the observation is considered successful. In any other case, the type of the error event defines the further treatment of the target.
    - If the error is found in the DTDConstants.IGNORE list, the observation is considered successful, i.e. the error encounter is spurious.
    - If the error is found in the DTDConstants.RETRY list and its current retry-count has not reached the maximum retries, it is rescheduled immediately, if it is still observable. If the maximum retries are reached, the target is disabled.
    - If the error is found in the DTDConstants.DELAY list and its current delay-count has not reached its maximum, the target is disabled for the stated amount of time and may be picked afterwards. If the maximum retries are reached, the target is disabled.
    - If the error is either stated in the DTDConstants.BLOCK list or is unknown, further target picking is disabled.
    - If the error is found in the DTDConstants.ABORT section, the abort flag is raised.
    Specified by:
    
    errorDaughter in interface Handable
    
    Parameters:
    
    success - The ErrorEvent outcome of the last sequence.
    
    at - The target which was executed and produced the outcome.
    
    See Also:
    
    processError(stella.ErrorEvent, stella.ErrorFinalizing, stella.ParameterClustering, java.util.List<java.lang.String>, java.util.List<java.lang.String>, java.lang.Integer, java.lang.Long, java.util.List<java.lang.String>, java.lang.Integer, java.util.List<java.lang.String>, java.util.List<java.lang.String>)
  - errorSuccessor
```
public void errorSuccessor(ErrorEvent success,
                           ErrorFinalizing finish,
                           ParameterClustering set)
```
    Signals that an error has occured in the successor to this target. If the error event handed over is null or a status event, the observation is considered successful. In any other case, the type of the error event defines the further treatment of the target.
    - If the error is found in the DTDConstants.IGNORE list, the observation is considered successful, i.e. the error encounter is spurious.
    - If the error is found in the DTDConstants.RETRY list and its current retry-count has not reached the maximum retries, it is rescheduled immediately, if it is still observable. If the maximum retries are reached, the target is disabled.
    - If the error is found in the DTDConstants.DELAY list and its current delay-count has not reached its maximum, the target is disabled for the stated amount of time and may be picked afterwards. If the maximum retries are reached, the target is disabled.
    - If the error is either stated in the DTDConstants.BLOCK list or is unknown, further target picking is disabled.
    - If the error is found in the DTDConstants.ABORT section, the abort flag is raised.
    Specified by:
    
    errorSuccessor in interface Handable
    
    Parameters:
    
    success - The ErrorEvent outcome of the last sequence.
    
    at - The target which was executed and produced the outcome.
    
    See Also:
    
    processError(stella.ErrorEvent, stella.ErrorFinalizing, stella.ParameterClustering, java.util.List<java.lang.String>, java.util.List<java.lang.String>, java.lang.Integer, java.lang.Long, java.util.List<java.lang.String>, java.lang.Integer, java.util.List<java.lang.String>, java.util.List<java.lang.String>)
  - processError
```
private void processError(ErrorEvent success,
                          ErrorFinalizing finish,
                          ParameterClustering set,
                          List<String> blocklist,
                          List<String> delaylist,
                          Integer delmax,
                          Long deltime,
                          List<String> retrylist,
                          Integer retmax,
                          List<String> ignorelist,
                          List<String> abortlist)
```
    Depending on the target the termination acts on, the different abort sections are loaded. Processes termination according to the DTDConstants.EXCEPTION section handed over. In particular, this method deals with the DTDConstants.DELAY and the DTDConstants.RETRY and the DTDConstants.ABORT section. Note that this method no longer adds a pick entry to the document, this is done whenever the addExecution(globals.GlobalGrouping, java.util.Date, long, java.lang.String, java.lang.String) method is called.
  - addExecution
```
public void addExecution(GlobalGrouping condition,
                         Date start,
                         long duration,
                         String unique,
                         String rem)
```
    Adds a pick to this target. Depending on errors that occured between the call to the last setPicked(boolean) method with true and the call to this method, either a successful or non-successful pick is added. If the current size of the history is already at the maximum history, first the one pick is removed from the list. The first successful and unsuccessful pick is always retained, the pick removed is the oldest one that is not the first successful or unsuccessful pick.
    S/N is ignored, this is intended for non-STELLA operation.
    
    Specified by:
    
    addExecution in interface HistoryAware
    
    start - The actual observation start.
    
    duration - The duration of target observation, ms.
    
    rem - An optional comment.
  - getDaughters
```
public Collection<Appointable> getDaughters()
```
    Description copied from interface: Appointable
    
    Returns a list of daugther targets. This list should have no multiple entries. If this target does not have any daugther targets, this method should return null.
    
    Specified by:
    
    getDaughters in interface Appointable
  - isObservable
```
public boolean isObservable(GlobalGrouping condition)
```
    Determines if this target is currently observable. A target is observable if the following conditions are met (checked in the stated order)
    - The target is enabled.
    - The boolean condition stated in the DTDConstants.REQUIRES section is true, evaluated according to the parameters found in the parameter cluster handed over.
    - All of the hard DTDConstants.CONSTRAINTs are fullfilled.
    Specified by:
    
    isObservable in interface Appointable
    
    Parameters:
    
    condition - The actual observing conditions. Conditions related to the target
    
    Returns:
    
    True if the target is currently observable.
  - getActualMerit
```
public double getActualMerit(GlobalGrouping condition,
                             Collection<Appointable> oftargets,
                             long within)
```
    Returns the actual value of the merit of this target. From the TargetFragment expansion, at least one DTDConstants.GAIN and one DTDConstants.TIMESLOT Meriting instance is described. During initialization of the target, the SporeTarget.timeslots and SporeTarget.gains are initialized. To calculate the total merit, all gains are added and then multiplied with the timeslot. The resulting double is returned.
    
    Specified by:
    
    getActualMerit in interface Appointable
    
    Parameters:
    
    condition - A set of actual observing conditions
    
    oftargets - All targets relavant for this target.
    
    within - The timespan within the merit should be maximized.
    
    Returns:
    
    A merit.
  - getLastFail
```
public Appointable.Constraint getLastFail()
```
    If anybody want to query why we have been unobservable, use this method.
    
    Specified by:
    
    getLastFail in interface Appointable
  - getLastMerit
```
public double getLastMerit()
```
    If anybody wants to query the last merit the target achieved and not want to wander through the TargetMerit parameter.
    
    Specified by:
    
    getLastMerit in interface Appointable
  - getHighestMerit
```
public double getHighestMerit()
```
    The highest merit ever achieved.
    
    Specified by:
    
    getHighestMerit in interface Appointable
  - getHighestDate
```
public Date getHighestDate()
```
    The date of the highest merit.
    
    Specified by:
    
    getHighestDate in interface Appointable
  - getDailyMerit
```
public double getDailyMerit()
```
    The highest merit in the last 24 hours.
    
    Specified by:
    
    getDailyMerit in interface Appointable
  - getDailyDate
```
public Date getDailyDate()
```
    The date of the high daily merit.
    
    Specified by:
    
    getDailyDate in interface Appointable
  - isProgramOver
```
public boolean isProgramOver(GlobalGrouping condition)
```
    Checks if a target has completed is life-cycle within an observing program. This is done by cycling through all timeslots and querying any EndpointDefining instance for completeness. As soon as a program is over, also the HistoryAware implementation part toggles to program over.
    
    Specified by:
    
    isProgramOver in interface Appointable
  - checkConstraints
```
private boolean checkConstraints(GlobalGrouping condition,
                                 List<Appointable.Constraint> olimit)
```
    Checks the constraints if any are over.
    
    Parameters:
    
    condition -
    
    olimit -
    
    Returns:
    
    True if at least one constraint is over
  - checkOver
```
private boolean checkOver(GlobalGrouping condition,
                          List<?> merits)
```
    Checks the list of merits for possible end point-defining merits. If any of these is completed, we change the completeness flag on the last pick and return true here.
  - getRemainingTime
```
public long getRemainingTime(GlobalGrouping set)
```
    Returns the remaining time of the observation time for this target. This method hooks onto the DTDConstants.CONSTRAINT list and determines for each DTDConstants.VARIABLE parameter a remaining time via the parameter's Increasing or Decreasing property. Even if the parameter neither implements one of this interfaces, it can still deliver a remaining time of zero, if the current parameter reading is out of bounds.
    
    Specified by:
    
    getRemainingTime in interface Appointable
    
    Returns:
    
    The minimal remaining time in ms, or Long.MAX_VALUE if none given.
  - getRemainingTime
```
private long getRemainingTime(GlobalGrouping set,
                              boolean info)
```
    Returns the remaining time of the observation time for this target. This method hooks onto the DTDConstants.CONSTRAINT list and determines for each DTDConstants.VARIABLE parameter a remaining time via the parameter's Increasing or Decreasing property. Even if the parameter neither implements one of this interfaces, it can still deliver a remaining time of zero, if the current parameter reading is out of bounds.
    
    Returns:
    
    The minimal remaining time in ms, or Long.MAX_VALUE if none given.
  - getObservingTime
```
public long getObservingTime(GlobalGrouping set)
```
    Returns an estimate of the observing time required for this target. If a DTDConstants.DURATION element is given, it is parsed and this value is returned. If no such element is given, all the exposure times found in the setup sections of this target are evaluated and added together. If this is a parent target class without a setup section, zero is returned.
    
    Specified by:
    
    getObservingTime in interface Appointable
    
    Returns:
    
    The estimated observation time in ms.
  - isAbort
```
public boolean isAbort(GlobalGrouping set)
```
    Checks if the target should be aborted. The target is aborted either if its abort flag was raised or if the current observing conditions block it from observation.
    
    Specified by:
    
    isAbort in interface Appointable
  - isRetry
```
public boolean isRetry(GlobalGrouping set)
```
    Checks if the target should be retried. A retry is only possible if an error occured that was catched in the DTDConstants.RETRY clause of the DTDConstants.EXCEPTION element, and the number of retries have not reached the maximum retry count. Retry is also prohibited if the current observation conditions block the target from observation.
    
    Specified by:
    
    isRetry in interface Appointable
  - toString
```
public String toString()
```
    Returns a string representation of the DOM-Target. Returns the target name.
    
    Overrides:
    
    toString in class PropertyContainer
  - equals
```
public boolean equals(Object that)
```
    Compares this target definition for equality. Two domtargets are considered equal if their unique target name matches.
    
    Overrides:
    
    equals in class Object
  - compareTo
```
public int compareTo(ParsedTarget o)
```
    Compares two parsed targets. If two targets are not equals, we compare the last merits of the targets. If these happen to be equal, we compare the target names, which is, by definition consistant with equal, as two target may not have the same name.
    
    Specified by:
    
    compareTo in interface Comparable<ParsedTarget>
  - setProgramCompleted
```
public void setProgramCompleted(boolean over)
```
    Returns true if the observing program on this target is over. This method differs from the Appointable.isProgramOver(globals.GlobalGrouping) method in the sense that a program completion is not bound to current observing circumstances, thus the normal action is that an appointable target whose program is over, may set this flag for fast replies.
    
    Overrides:
    
    setProgramCompleted in class SporeTarget
  - getSuccessor
```
public Appointable getSuccessor()
```
    Returns the successor target, if this target has one.
    
    Specified by:
    
    getSuccessor in interface Handable
  - resolveChildren
```
public boolean resolveChildren(Collection<Appointable> alltargets)
```
    Resolve all children. As soon as all targets in the target list has been read in and parsed, this method should be called to convert previously stored children names (i.e. SporeTarget.daughternames and SporeTarget.successorname) into living target definition references.
  - trimHistory
```
private static final void trimHistory(List<? extends HistoryAware.Pick> history,
                                      long notlater)
```
    Trimming the histroy means removing any pick that is later than the stated day. Used in simulators to re-do a night.

Class ParsedTarget

Nested Class Summary

Nested classes/interfaces inherited from class stella.xml.SporeTarget

Nested classes/interfaces inherited from class target.AbstractTarget

Nested classes/interfaces inherited from class util.PropertyResources

Nested classes/interfaces inherited from interface stella.HistoryAware

Nested classes/interfaces inherited from interface stella.Appointable

Field Summary

Fields inherited from class stella.xml.SporeTarget

Fields inherited from class target.AbstractTarget

Fields inherited from class util.PropertyResources

Fields inherited from class util.PropertyContainer

Fields inherited from interface util.ResourceSupplying

Fields inherited from interface util.PropertySupplying

Constructor Summary

Method Summary

Methods inherited from class stella.xml.SporeTarget

Methods inherited from class util.PropertyResources

Methods inherited from class util.PropertyContainer

Methods inherited from class java.lang.Object

Methods inherited from interface stella.HistoryAware

Methods inherited from interface stella.Handable

Methods inherited from interface target.TargetDefinition

Methods inherited from interface util.PropertySupplying

Field Detail

serialVersionUID

KEY_NIGHT

KEY_ACCELERATE

KEY_CALCULATOR

KEY_RATERETRY

KEY_RATEWAIT

KEY_HISTORYDB

KEY_TASKDB

KEY_OBSBAD

KEY_OBSGOOD

DEFRETRYMAX

DEFDELAYMAX

DEFDELAYTIME

DEFRATERETRY

DEFRATEWAIT

DEFNIGHT

DEFMERITCAP

DEFACCELERATE

DEFOBSBAD

DEFOBSGOOD

finished

picked

triumph

abort

lastfail

lastmerit

himerit

hitime

daymerit

daytime

retry

retrycount

delaycount

parent

successor

daughters

delaytimer

delays

rategroup

hsql

tsql

Constructor Detail

ParsedTarget

ParsedTarget

Method Detail

makeRunnable

setLoggingForFailedConstraints

setLoggingForObservingTime

setHistorySql

setTaskSql

hashCode

getPrecursor

setPrecursor

setEnabled

setFinished