Task Reports

The task report displays information about a selected task and how it is used in the deconflicted schedule.

The task report is designed so that it provides information about the definition of one or more tasks in such a manner that it may be programmatically parsed using an external application.

Task Reports may be created by selecting Task -> Report from the Menu Bar, then selecting a task if one is not already selected.

Task Reports

Report Details

The report details section contains a set of keywords with their associated data for each task included in the report. The following sections detail each keyword.

Keyword Format Description
TR_TASK_NAME TR_TASK_NAME '{task name}' The TR_TASK_NAME keyword precedes the name given to the task on the Task Definition Form. The name of the task will appear contained within quotation marks.
TR_DESCRIPTION TR_DESCRIPTION '{task description}' The TR_DESCRIPTION keyword precedes the description given to the task on the Task Definition Form. The description of the task will appear contained within single quotation marks.
TR_ALLOWBONUSING TR_ALLOWBONUSING {YES/NO} The TR_ALLOWBONUSING keyword precedes a yes or no Boolean value that describes if the task can be bonused, or allow its assignments to bonus other tasks who also have this value set to true.
TR_BONUSEDTASKS TR_BONUSEDTASKS TaskA, TaskB, ... The TR_BONUSEDTASKS keyword precedes a comma delimited list of tasks that were bonused due to this task's assignments.
TR_DEFERRED TR_DEFERRED {YES/NO} The TR_DEFERRED keyword precedes a yes or no Boolean value that describes whether or not the task is currently deferred as define on the Status Tab of the Task Definition Form.
TR_LOCKED TR_LOCKED {YES/NO} The TR_LOCKED keyword precedes a yes or no Boolean value that describes whether or not the task is currently locked as defined on the Status Tab of the Task Definition Form.
TR_PRIORITY TR_PRIORITY {task priority value} The TR_PRIORITY keyword precedes the priority given to the task on the General Tab of the Task Definition Form.
TR_SCHEDULING_PREFERENCE TR_SCHEDULING_PREFERENCE {EARLY/MIDDLE/LATE/NONE} The TR_SCHEDULING_PREFERENCE keyword precedes the scheduling preference of the task as defined on the General Tab of the Task Definition Form.
TR_TIMESLOT_PREFERENCE TR_TIMESLOT_PREFERENCE {EARLY/MIDDLE/LATE/NONE} The TR_TIMESLOT_PREFERENCE keyword precedes the timeslot preference of the task as defined on the General Tab of the Task Definition Form. This refers to the relation of the scheduled time and where it falls within a timeslot.
TR_GROUPS TR_GROUPS {number of groups} The TR_GROUPS keyword precedes the number of task groups that the task is included in as defined on the General Tab of the Task Definition Form.
TR_GROUP_NAME TR_GROUP_NAME '{group name}' The TR_GROUP_NAME keyword precedes the name of a group in which the task is included in as defined on the General Tab of the Task Definition form. The group name is contained within single quotation marks. The number of TR_GROUP_NAME keywords in the report will equal the number of groups the task is included in (See TR_GROUPS above).
TR_TASK_TYPE TR_TASK_TYPE {task type - RECURRING_PARENT_DEFINITION/TEMPLATE_PARENT_DEFINITION/SINGLE_INSTANCE_DEFINITION} '{name of template parent task}' '{name of recurring parent task}' The TR_TASK_TYPE keyword precedes parameters that define the type of task. Parameters include the task type, name of template task (if any), and name of recurring parent task (if any).
TR_FOM_TOTAL TR_FOM_TOTAL {task's FOM} The TR_FOM_TOTAL keyword precedes the task's FOM score, which is a sum of components, each component being scaled by a weight set on the FOM Properties Tab of the Schedule Properties form.
TR_FOM_ASSIGN TR_FOM_ASSIGN {raw Assign component of the task's FOM} The TR_FOM_ASSIGN keyword precedes the Assign component of the task's FOM score, unscaled by the corresponding FOM weight.
TR_FOM_DUR TR_FOM_DUR {raw Dur component of the task's FOM} The TR_FOM_DUR keyword precedes the Dur component of the task's FOM score, unscaled by the corresponding FOM weight.
TR_FOM_PP TR_FOM_PP {raw PP component of the task's FOM} The TR_FOM_PP keyword precedes the PP component of the task's FOM score, unscaled by the corresponding FOM weight.
TR_FOM_PN TR_FOM_PN {raw PN component of the task's FOM} The TR_FOM_PN keyword precedes the PN component of the task's FOM score, unscaled by the corresponding FOM weight.
TR_FOM_EARLY TR_FOM_EARLY {raw Early component of the task's FOM} The TR_FOM_EARLY keyword precedes the Early component of the task's FOM score, unscaled by the corresponding FOM weight.
TR_FOM_MAXDUR TR_FOM_MAXDUR {raw MaxDur component of the task's FOM} The TR_FOM_MAXDUR keyword precedes the MaxDur component of the task's FOM score, unscaled by the corresponding FOM weight.
TR_FOM_PT TR_FOM_PT {raw PT component of the task's FOM} The TR_FOM_PT keyword precedes the PT component of the task's FOM score, unscaled by the corresponding FOM weight.
TR_RECURRING_TYPE TR_RECURRING_TYPE {TIME/RESOURCE/NA} The TR_RECURRING_TYPE keyword precedes a parameter that describes what the task uses as a basis to define its scheduling windows defined by on the Scheduling Tab of the Task Definition Form.
TR_APPLY_RECURR_DUR_EXTENSION TR_APPLY_RECURR_DUR_EXTENSION {TRUE/FALSE} The TR_APPLY_RECURR_DUR_EXTENSION keyword precedes a parameter that describes if the recurring children tasks will have their timeslots extended by a certain value as define by on the Scheduling Tab of the Task Definition Form.
TR_RECURRING_CONSTRAINTS TR_RECURRING_CONSTRAINTS {minAfterType} {minTimeAfter} {maxAfterType} {maxTimeAfter} The TR_RECURRING_CONSTRAINTS keyword precedes the parameters that describes how the recurring children tasks will be scheduled in relation to other children tasks of the same parent on the Scheduling Tab of the Task Definition Form.
TR_SINGLEINST_DISCRETE_WINDOWS TR_SINGLEINST_DISCRETE_WINDOWS {number of windows} The TR_SINGLEINST_DISCRETE_WINDOWS keyword precedes the number if discrete windows that are used to define the scheduling times for a single instance task as defined on the Scheduling Tab of the Task Definition Form.
TR_WINDOW_DEF TR_WINDOW_DEF {window start time/date} {window stop time/date} '{window comment}' The TR_WINDOW_DEF keyword precedes parameters that define a discrete window used to describe the scheduling windows of the task. The parameters include the window start time, window stop time, and window comments as defined on the Scheduling Tab of the Task Definition Form. The number of TR_WINDOW_DEF keywords in the report equals the number of discrete windows (See TR_SINGLEINST_DISCRETE_WINDOWS above).
TR_SINGLEINST_STKREPORTS TR_SINGLEINST_STKREPORTS {number of reports} The TR_SINGLEINST_STKREPORTS keyword precedes the number of STK reports that are used to define the scheduling windows of a single instance task as defined on the Scheduling Tab of the Task Definition Form.
TR_STKREPORT_DEF TR_STKREPORT_DEF {report start time/date} {report stop time/date} {WINDOW/FIXEDSTART/FIXEDSTOP} {start offset time duration} {duration or end offset time} '{STK object 1 path}' '{STK object 2 path}' '{report type}' '{maintain offset times (YES or NO)}' '{use next time value in report (TRUE or FALSE)}' The TR_STKREPORT_DEF keyword precedes parameters that define a STK report that is used to describe the scheduling windows for the task. The parameters include the report start time, reports stop tine, report type (window, fixed start, or fixed stop), durations and/or offset times, STK object paths, the report type as define on the DefineSTK Time Report Form, and report start/stop time definition type (maintain report start/stop time offsets from schedule start/stop times or not when schedule start/stop times are changed), report duration type as using the next line in the report (TRUE) or explicitly defining the fixed duration (FALSE). The number of TR_STKREPORT_DEF keywords in the report equals the number of defined STK reports (See TR_SINTLEINST_STKREPORTS above).
TR_SINGLEINST_PERIODIC_DEFS TR_SINGLEINST_PERIODIC_DEFS {number of periodic definitions} The TR_SINGLEINST_PERIODIC_DEFS keyword precedes the number of periodic definitions that are used to define the scheduling windows of a single instance task as defined on the Scheduling Tab.
TR_SINGLEINST_PERIOD TR_SINGLEINST_PERIOD {frequency} {periodic start time/date} {epoch (custom frequency only)} {interval (custom frequency only} {periodic stop time/date} '{periodic comments}' {number of inner windows} The TR_SINGLEINST_PERIOD keyword precedes parameters that define a period window definition that is used to describe scheduling windows of a single instance task. The parameters include the periodic frequency, periodic start time, periodic stop time, epoch (custom frequency only), interval (custom frequency only), user-defined comments, and the number of inner windows as defined on the Scheduling Tab of the Task Definition Form. The number of TR_SINGLEINST_PERIOD keywords in the report equal the number of periodic report definitions. (See TR_SINGLEINST_PERIODIC_DEFS above.)
TR_INNER_WINDOW_DEF TR_INNER_WINDOW_DEF {inner window start time} {inner window duration} '{period comment}' The TR_INNER_WINDOW_DEF keyword precedes parameters that define the inner windows of a period window definition that is used to describe the scheduling windows of a single instance task. The parameters include the inner window start time, inner window duration, and user-defined comments as defined on the Scheduling Tab of the Task Definition Form. The number of TR_INNER_WINDOW_DEF keywords in the report equals the number of inner windows. (See TR_SINGLEINST_PERIOD above).
TR_RECURRING_DISCRETE_WINDOWS TR_RECURRING_DISCRETE_WINDOWS {number of windows} The TR_RECURRING_DISCRETE_WINDOWS keyword precedes the number of recurring windows that are used to define the scheduling times for a recurring instance task as defined on the Scheduling Tab of the Task Definition Form.
TR_WINDOW_DEF TR_WINDOW_DEF {window start time/date} {window stop time/date} '{window comments}' The TR_WINDOW_DEF keyword precedes parameters that define a discrete window used to describe the scheduling windows of the task. The parameters include the window start time, window stop time, and window comments as defined on the Scheduling Tab of the Task Definition Form. The number of TR_WINDOW_DEF keywords in the report equals the number of recurring windows (See TR_RECURRING_DISCRETE_WINDOWS above).
TR_RECURRING_STKREPORTS TR_RECURRING_STKREPORTS {number of reports} The TR_RECURRING_STKREPORTS keyword precedes the number of STK reports that are used to define the scheduling windows of a period task as defined on the Scheduling Tab of the Task Definition Form.
TR_STKREPORT_DEF TR_STKREPORT_DEF {report start time/date} {report stop time/date} {WINDOW/FIXEDSTART/FIXEDSTOP} {start offset time or duration} {duration or end offset time} '{STK object 1 path}' '{STK object 2 path}' '{report type}' '{maintain offset times (YES or NO)}' '{use next time value in report (TRUE or FALSE)}' The TR_STKREPORT_DEF keyword precedes parameters that define a STK report that is used to describe the scheduling windows for the task. The parameters include the report start time, report stop time, report type (window, fixed start, or fixed stop), durations and/or offset times, STK object paths, the report type as defined on the Define STK Time Report Form, and report start/stop time definition type (maintain report start/stop time offsets from schedule start/stop times or not when schedule start/stop times are changed), report duration type as using the next line in the report (TRUE) or explicitly defining the fixed duration (FALSE). The number of TR_STKREPORT_DEF keywords in the report equals the number of define STK reports (See TR_RECURRING_STKREPORTS above).
TR_RECURRING_PERIODIC_DEFS TR_RECURRING_PERIODIC_DEFS {number of periodic definitions} The TR_RECURRING_PERIODIC_DEFS keyword precedes the number of periodic definitions that are used to define the scheduling windows of a recurring task as defined on the Scheduling Tab on the Task Definition Form.
TR_RECURRING_PERIOD TR_RECURRING_PERIOD {frequency} {period start time/date} {epoch (custom frequency only)} {interval (custom frequency only)} {periodic stop time/date} {RepeatType - PERPERIOD/PERWINDOW} {repeats per period} {Priority Delta} '{periodic comments}' {number of inner windows} The TR_RECURRING_PERIOD keyword precedes parameters that define a period window definition that is used to describe scheduling windows of a recurring task. The parameters include the periodic frequency, periodic start time, periodic stop time, epoch (custom only), interval (custom only), perwindow or perperiod option, number of repeats per period/window, priority delta value, user defined comments, and the number of inner windows as defined on the Scheduling Tab of the Task Definition Form. The number of TR_RECURRING_PERIOD keywords in the report equals the number of periodic report definitions (See TR_RECURRING_PERIODIC_DEFS above).
TR_INNER_WINDOW_DEF TR_INNER_WINDOW_DEF {inner window start time} {inner window duration} '{periodic comments}' The TR_INNER_WINDOW_DEF keyword precedes parameters that define the inner windows of a period window definition that is used to describe the scheduling windows of a recurring task. The parameters include the inner window start time, inner window duration, and user-defined comments as define on the Scheduling Tab of the Task Definition Form. The number of TR_INNER_WINDOW_DEF keywords in the report equals the number of inner windows (See TR_RECURRING_PERIOD above).
TR_DURATION_VALUES TR_DURATION_VALUES {duration type - variable/fixed/full_timeslot} {multiple segments allowed} {resource changes between segments} {overlap required} {fixed duration} {minimum total duration} {maximum total duration} {minimum segment duration} {max overlap duration} {overlap duration required} The TR_DURATION_VALUES keyword precedes the parameters that define the type of duration specified on the Duration Tab of the Task Definition Form.
TR_RESOURCE_FORMULA TR_RESOURCE_FORMULA {number of possibilities} '{resource constraint formula}' The TR_RESOURCE_FORMULA keyword precedes a True or False Boolean value that defines if the task uses the common setup time feature as referenced on the Resource Usage Tab of the Task Definition Form.
TR_USE_COMMON_SETUP_TIME TR_USE_COMMON_SETUP_TIME {TRUE/FALSE} The TR_USE_COMMON_SETUP_TIME keyword precedes a True or False Boolean value that defines if the task uses the common setup time feature as referenced on the Resource Usage Tab of the Task Definition Form.
TR_POSSIBILITY TR_POSSIBILITY {priority value} '{list of resources}' {number of resources} {number of STK reports} {number of timeslots} The TR_POSSIBILITY keyword precedes parameters that define one of a task's possibilities as defined on the Timeslots Definitions Tab of the Task Definition Form. The parameters include the possibility priority value, list of resources that are included in the possibility (comma delimited), the number of resources in the possibility, the number of STK reports used to define the possibility's timeslot(s), and the number of timeslots.
TR_RES_USAGE TR_RES_USAGE '{resource name}' {setup duration} {breakdown duration} {capacity usage - NA/DEPLETE/REPLENISH/SETENDVALUE} {capacity change method - NA/FIXED/RATE} {capacity amount} {rate time - seconds/NA} {accommodation applicable - YES/NO} {animation - NA/OBJECTLINE/SENSORON/NONE} {cost amount} {cost rate - PERASSIGNMENT/PERSECOND} {cost setup applied- YES/NO} {cost breakdown applied - YES/NO} {usable setup modes indices - 'comma delimited list in single quotes'} {usable body modes indices - 'comma delimited list in single quotes'} {usable breakdown modes indices - 'comma delimited list in single quotes'} {resource range min constraint applied - YES/NO} {resource range min value} {resource range max constraint applied - YES/NO} {resource range max value} {duration override type} {duration override value - integer/NA} The TR_RES_USAGE keyword precedes a number of parameters that defines how a resource is used as defined on the Resource Usage Tab of the Task Definition Form. The parameters include resource setup time, the name of the resource, capacity usage, capacity change method, capacity amount, rate time, capacity intervals, accommodation applicability, and animation setting. A separate TR_RES_USAGE keyword for each resource will appear after each task possibility (See TR_RESOURCE_FORMULA above).
TR_FILE_IMPORT_DEF TR_FILE_IMPORT_DEF '{filepath/name}' The TR_FILE_IMPORT_DEF keyword precedes a time window filename (including directory path) applied for calculating timeslots for the possibility via the File Import Form accessed through the File Import button on the Timeslots Definition Form. The number of TR_FILE_IMPORT_DEF keywords under each possibility equals the number of files applied to that possibility.
TR_STKREPORT_DEF TR_STKREPORT_DEF {report start time/date} {report stop time/date} {WINDOW/FIXEDSTART/FIXEDSTOP/VALUERANGE} {start offset time or duration} {duration or end offset time} '{STK object 1 path}' '{STK object 2 path}' '{report type}' '{maintain offset times (YES or NO)}' '{use next time value in report (TRUE or FALSE)} {number of repeats}' The TR_STKREPORT_DEF keyword precedes parameters that define a STK report that is used to describe the scheduling windows for the task. The parameters include the report start time, report stop time, report type (window, fixed start, or fixed stop), durations and/or offset times, STK object paths, the report type as defined on the Define STK Time Report Form, and report start/stop time definition type (maintain report start/stop time offsets from schedule start/stop times or not when schedule start/stop times are changed), report duration type as using the next line in the report (TRUE) or explicitly defining the fixed duration (FALSE). The number of TR_STKREPORT_DEF keywords in the report equals the number of defined STK reports (See TR_POSSIBILITY above).
TR_TIMESLOT TR_TIMESLOT {timeslot start time/date} {timeslot stop time/date} {timeslot preferred start time/date} {timeslot desirability} '{user comments}' The TR_TIMESLOT keyword precedes a set of parameters that describes the attributes of a task's timeslot as defined on the Timeslot Definition Tab of the Task Definition Form. The parameters include the timeslot start time/date, timeslot stop time/date, desirability, and comments. The number of TR_TIMESLOT keywords equals the number of timeslots for each possibility (See TR_POSSIBILITY above).
TR_TOTAL_TIMESLOT_DURATION TR_TOTAL_TIMESLOT_DURATION {total timeslot duration} {total timeslot duration excluding overlaps} The TR_TOTAL_TIMESLOT_DURATION keyword provides 2 values. The first value is the summation of all of the timeslot durations. The second value is the summation of all the timeslot durations excluding any overlaps.
TR_ANCHOR_TYPE TR_ANCHOR_TYPE {NA} {Start} {End} The TR_ANCHOR_TYPE keyword precedes parameters that describe the task's anchoring constraint requirements.
TR_DEPENDENCIES TR_DEPENDENCIES {nOf during constraints} {total during constraints} {nOf predecessor constraints} {total predecessor constraints} The TR_DEPENDENCIES keyword precedes parameters that describe the task's dependency constraint requirements.
TR_DEPENDENCY TR_DEPENDENCY '{task name}' {dependency type} {minTimeAfter} {minAfterType} {maxTimeAfter} {maxAfterType} The TR_DEPENDENCY keyword precedes an individual task dependency constraint definition as defined on the Dependency Tab of the Task Definition Form.

The types are:

  • dependency type: PREDECESSOR or DURING
  • minTimeAfter: seconds or NA
  • minAfterType: afterStart or afterStop
  • maxTimeAfter: seconds or NA
  • maxAfterType: afterStart or afterStop
TR_NOTES TR_NOTES '{text of note}' The TR_NOTES keyword precedes text of the note contained in the note text as defined on the Notes Tab of the Task Definition Form.
TR_HIDDEN TR_HIDDEN {YES/NO} The TR_HIDDEN keyword precedes a YES/NO term. YES indicates that the task is hidden (not displayed) on the Scheduler main Gantt view. NO indicates that the task is displayed normally on the Gantt view.
TR_ASSIGNMENTS TR_ASSIGNMENTS {number of assignments} {total assigned duration} {total cost of task assignments} The TR_ASSIGNMENTS keyword precedes the total number of assignments that the task has as defined on the Status Tab of the Task Definition Form, as well as the total assigned task duration (sum of individual assignment durations if more than one assignment has been made) and the total cost of resources used by the task.
TR_ASSIGNMENT TR_ASSIGNMENT {assignment start date/time} {assignment stop date/time} {assignment duration} '{assigned resources}' {cost of task assignment} {is bonused} {common setup start time or NA} {notes} The TR_ASSIGNMENT keyword precedes a number of parameters that describes the task assignment as defined on the Status Tab of the Task Definition Form. The parameters include the assignment start date and time, assignment stop date and time, the duration of the assignment, list of comma delimited resources that are assigned, the cost of the assignment, and if the assignment was bonused. The number of TR_ASSIGNMENT keywords is equal to the number of task assignments (See TR_ASSIGNMENTS above).
TR_CHILD_ASSIGNMENTS TR_CHILD_ASSIGNMENTS {number of assignments} {total assigned duration including overlap times} {total assigned duration excluding overlaps per child task} {total assigned duration excluding overlaps over all child tasks} {total cost of all child task assignments}

The TR_CHILD_ASSIGNMENTS keyword provides 5 values.

The values are:

  • The total number of child assignments
  • The summation of all child assignment duration including overlaps
  • The summation of all child assignment durations excluding overlaps within each child task
  • The summation of all child assignment durations excluding overlaps over all child tasks
  • The represents the total cost for all assignments of the task children

TR_CHILD_ASSIGNMENT TR_CHILD_ASSIGNMENT {assignment start date/time} {assignment stop date/time} {assignment duration} '{assigned resources}' {cost of child task assignment} {is bonused} The TR_CHILD_ASSIGNMENT keyword precedes a number of parameters that describes a child task assignment. The parameters include the assignment start date and time, assignment stop date and time, the duration of the assignment, list of comma delimited resources that are assigned, and if the assignment is bonused for the task child assignment. The number of TR_CHILD_ASSIGNMENT keywords is equal to the number of child task assignments (See TR_CHILD_ASSIGNMENTS above).
TR_TOTAL_CHILD_TIMESLOT_DURATION TR_TOTAL_CHILD_TIMESLOT_DURATION {total child timeslot duration including overlap} {total child timeslot duration excluding overlaps per child task} {total child timeslot duration excluding overlaps over all child tasks}

The TR_TOTAL_CHILD_TIMESLOT_DURATION keyword provides 3 values if the task of interest is a recurring parent definition.

The values are:

  • The summation of all of the children's timeslots duration including overlap
  • The summation of all the timeslots durations excluding any overlaps within each child task
  • The summation of all the timeslots duration excluding any overlaps over all child tasks

TR_ASSIGNED_VS_AVAILABLE_RATIO TR_ASSIGNED_VS_AVAILABLE_RATIO {ratio for all duration time} {ratio for all duration times excluding overlaps within each child task} {ratio for all duration times excluding overlaps over all child tasks.}

The TR_ASSIGNED_VS_AVAILABLE_RATIO keyword provides the ratio of the total assigned duration over the total available duration excluding any overlaps. For a single instance task, only the second value (no overlap per child) is provided. For a recurring parent task definition, 3 ratios are provided.

The ratios are:

  • The total assigned duration divided by total timeslot duration including overlaps
  • The total assigned duration divided by total timeslot duration excluding overlaps per child task
  • The total assigned duration divided by total timeslot duration excluding overlaps over all children

TR_VIOLATION TR_VIOLATION {violation message} The TR_VIOLATION keyword precedes text that describes the source of a violation, should one occur.
TR_VIOLATION_RES_AVAILABILITY TR_VIOLATION_RES_AVAILABILITY {violation message} The TR_VIOLATION_RES_AVAILABILITY keyword precedes text that describes the source of a violation where a task's assignment resource is utilized outside of availability times, should one occur.
TR_SATELLITE_ORBIT_OPTIONS TR_SATELLITE_ORBIT_OPTIONS {OrbitLineColor} {UsesOrbitLineColor [True/False]} {OrbitLineWidth} {UseOrbitLineWidth [True/False]} {DisplayTaskName [True/False]} {DisplayTaskStartTime [True/False]} {DisplayTaskStopTime [True/False]} {ObjectLine}

The TR_SATELLITE_ORBIT_OPTIONS keyword precedes a number of parameters that describe how satellite orbit are displayed in STK and what annotations should go with them.

These values are found on the Task STK Tab. These values are:

  • The orbit line color in a 9 digit RGB format.
  • A Boolean True/False whether that orbit line color is used.
  • A double orbit line width between 1.0 and 10.0.
  • A Boolean True/False whether that orbit line width is used.
  • A Boolean True/False whether to display the Task Name by the satellite orbit.
  • A Boolean True/False whether to display the Task Start Time by the satellite orbit.
  • A Boolean True/False whether to display the Task Stop Time by the satellite orbit.
  • The object line color in a 9 digit RGB format.

Print Button

The print button prints an ASCII version of the report to the Windows default printer.

Save Button

The save button opens the Save As.. form allowing you to specify a file name and a location for an ASCII version of the report to be saved.

Close Button

The close button closes the form.