TargetDefinition

All Known Subinterfaces:

Appointable, Handable, HistoryAware

All Known Implementing Classes:

AbstractTarget, GrbTarget, ParsedTarget, SporeTarget
```
public interface TargetDefinition
```
An interface describing an astronomical target in a way that it is handable by a scheduler and a sequencer. This interface is only the very basic definition of a whole sequence of target definitions, specifying the target into deeper and deeper detail.
A target definition initially comprises only a unique target name, a target type and some parameters which may be distinguished by an identifier object. This identifier is needed if a target provides different definitions for the same named property. E.g. if a target consists of different stars, all with have a property ra. Specifying the right identifier blocks ambiguities.
For some astronomical observation it may be necessary that one target consists of a couple of daughter targets (e.g. a radial velocity standard target may actually consist of a handful of radial velocity standard stars), or requires another target immediately after this target. This process is called target-chaining. The following rules apply:
- Any target may have daughters and/or a single successor. This applies also to daughter targets.
- If a target has daughters, each daughter must be a valid target definition. In particular, if the parental target is, e.g. Appointable, its daughters should also implement this interface.
- From all daughter targets, only one gets selected. The same scheduler algorithm is used for daughter selection as for principial target selection.
- Targets that have daughters may not have an object declaration. This is also forbidden in the target-DTD grammar.
- Daughters are always executed before successors.
- For Handable targets, they are picked as soon as they enter the execution chain, i.e. as the scheduler classifies them as the top target. Handable targets are unpicked when the do not have an unfinished successor left.
Note that chaining targets that are not Handable will not work.

Method Summary

All Methods Instance Methods Abstract Methods
Modifier and Type	Method and Description
`String`	`getDescription()` Returns a description of the target.
`String`	`getDescriptionID()` Returns an id of the target description.
`Collection<? extends javax.mail.Address>`	`getEmailAddresses()` Returns a list of user e-mails.
`Object`	`getImageType()` Gets the image type.
`UserProfile.Affil`	`getInstitution()` Gets the institution this target belongs to.
`String`	`getName()` Gets the target name.
`URL`	`getTargetResource()` A resource where the target can be located.
`Object`	`getTargetSpecific(Object id)` Gets a description of a specified field in the target description.
`Collection<String>`	`getTeam()` Gets the names of the cois or null if no Co-Is are assigned.
`String`	`getTitle()` Gets the target title.
`Object`	`getType()` Gets the target type.
`String`	`getUser()` Gets the target user.

- Method Detail
  - getName
```
String getName()
```
    Gets the target name. Used to uniquely identify the target.
  - getTargetResource
```
URL getTargetResource()
```
    A resource where the target can be located.
  - getTitle
```
String getTitle()
```
    Gets the target title.
  - getDescription
```
String getDescription()
```
    Returns a description of the target. This is an abstract of the observing program purpose.
  - getDescriptionID
```
String getDescriptionID()
```
    Returns an id of the target description. This might be a proposal name.
  - getUser
```
String getUser()
```
    Gets the target user. Used for assigning observation time shares if getInstitution() is not meaningful.
  - getTeam
```
Collection<String> getTeam()
```
    Gets the names of the cois or null if no Co-Is are assigned.
  - getEmailAddresses
```
Collection<? extends javax.mail.Address> getEmailAddresses()
```
    Returns a list of user e-mails. All entries in the list should follow the java-mail API Address definition.
  - getInstitution
```
UserProfile.Affil getInstitution()
```
    Gets the institution this target belongs to. Used for assigning observation time shares.
  - getType
```
Object getType()
```
    Gets the target type. Normally, the return type will be a string. A sequencer must be able to derive a List of sequencer steps out of this target type.
  - getImageType
```
Object getImageType()
```
    Gets the image type. Normally, the return type will be a string. This method is used for FITS header entries.
  - getTargetSpecific
```
Object getTargetSpecific(Object id)
```
    Gets a description of a specified field in the target description. This description id-tag must be unique and must allow the underlying target definition to return an object out of the definition. This can be used if a target definition is augmented by some additional data like an instrument section that defines an exposure of the target. The id is needed if more than one setup is possible. E.g. if two instrument sections are present, they will have the same keys. Distinguishing is possibly with identifier object.
    Note that this comes in handy with an XML-ID-attribute definition.
    
    Parameters:
    
    id - An identifier, most likely a string.
    
    Returns:
    
    A sub-class of object, commands must know how to use it.

Interface TargetDefinition

Method Summary

Method Detail

getName

getTargetResource

getTitle

getDescription

getDescriptionID

getUser

getTeam

getEmailAddresses

getInstitution

getType

getImageType

getTargetSpecific