JetStream TimeLiner

JetStream TimeLiner

User Manual

Autodesk, Inc.

Revision 5.5.38796

Autodesk, Inc. reserves the right to make changes in specification at any time and without notice. The information furnished by Autodesk, Inc. in this publication is believed to be accurate; however, no responsibility is assumed for its use, nor for any infringement of patents or other rights of third parties resulting from its use.

JetStream and the JetStream logo are registered trademarks of Autodesk, Inc. All other trademarks and copyrights are property of their respective owners. All rights reserved.

Contains Autodesk(R) RealDWG by Autodesk, Inc., Copyright (C) 1998-2007 Autodesk, Inc. All rights reserved.

This software is based in part on the work of the Independent JPEG Group.

Contains a modified version of Open CASCADE libraries. See the license file "OpenCascadeLicense.txt" in the JetStream installation directory. Source code is available from www.navisworks.com/files/OpenCascade.zip.

LightWorks and the LightWorks logo are registered trademarks of LightWork Design Ltd. LWA, LWA-Enabled and the LWA-Enabled logo, Interactive Image Regeneration, IIR, A-cubed, Feature-Following Anti-Aliasing and FFAA are all trademarks of LightWork Design Ltd. All other trademarks, images and logos remain the property of their respective owners. Copyright of LightWork Design Ltd. 1990-2005, 2006.

Overview of TimeLiner

Overview of TimeLiner

The TimeLiner plugin adds 4D schedule simulation to JetStream. TimeLiner imports schedules from a variety of sources; allows you to connect objects in the model with tasks in the schedule; simulate the schedule showing the effects on the model, including planned against actual schedules; and export images and animations based on the results of the simulation. TimeLiner will automatically update the simulation if the model or schedule changes.

TimeLiner has a Playback-only option when a full TimeLiner license is not available, allowing any externally created project data to be simulated, but no changes to be made to that data.

If both a TimeLiner and a Clash Detective license are available together, it is possible to combine the functionalities of both plugins to provide time-based clash checkes on the project. See Selecting Items for Clash Testing in the Clash Detective documentation for further details on Time-based Clashing

The TimeLiner interface is arranged as a tabbed dialog. You will perform different activities using each tab. The typical activities are outlined below:

    Getting Started

  1. Load a model into JetStream in the usual way (see the section called "Opening Files" in the chapter called "File Management" of the JetStream Roamer book for more information on opening files) and then choose TimeLiner from the Tools menu.

    Note

    If a full TimeLiner license is not available, simulation playback will be available using TimeLiner Playback from the Tools menu. TimeLiner Playback will only give access to the Simulation tab and related controls.

    The TimeLiner dialog is displayed:

    Note

    The TimeLiner dialog can be docked within the JetStream interface. To stop the dialog from docking, hold down the Ctrl key.

  2. Create some tasks, each having a name, start and end date and a task type. You can enter tasks by hand on the Tasks Tab. Alternatively, the Tools context menu on the Tasks Tab will create an initial set of tasks based on layer, item, or selection set names. TimeLiner defines some default task types for you (Construct, Demolish and Temporary), or you can define your own using the Configure Tab

    You can use the Links Tab to import tasks from an external source, such as Microsoft Project. You can choose a field from the external schedule to define the types of the imported tasks, or you can set task types by hand. Linked fields cannot be edited directly in TimeLiner. You can, of course, update the schedule externally and synchronize the tasks in TimeLiner with those from the external source.

  3. Connect objects in the model to tasks. You do this by hand on the Tasks Tab, using the context menu to attach selections, searches or selection sets.

    If you used the Tools menu on the Tasks Tab to create an initial set of tasks based on layer, item or selection set names, then the corresponding layers, items or selection sets will already be attached for you. Alternatively, you can use the Rules Tab to automatically attach objects.

  4. Simulate your schedule. Use the Simulate Tab to visualise your model at any date in your schedule with the currently active tasks highlighted. Run through the entire schedule using familiar animation controls. You can set the simulation to interact with an existing saved animation (created in JetStream Roamer) to provide a highly dynamic simulation.

  5. Configure the behaviour of the simulation. Use the Configure Tab to create new task types and edit old ones. The task type defines what happens at the start and end of each task of that type. You can hide attached objects, change their appearance or reset them to the appearance specified in the model.

  6. Create image and AVI files. Export the current simulation view as an image, or the entire simulation as an AVI.

  7. Keep upto date with changes in your project. Save your project as a JetStream .nwf file. Open the .nwf and use Synchronize Tasks from Link from the Links Tab. JetStream will update the project based on any changes to the model and external schedule. Use Rebuild Task Hierarchy from all Links to add any newly created tasks from your external schedules.

    Sort All Tasks from the context menu on the Tasks Tab will keep all your tasks in numerical/alphabetical order.

Tasks

Tasks

The Tasks tab allows you to add, view and edit all of the scheduled tasks, either manually created, or linked to your scheduling software (e.g. Microsoft Project). Selections in the model can then be attached to Tasks. Relinking a task to an external schedule will prompt you to select a link via the Select Link Dialog

The Tasks Tab

The Tasks Tab

The Tasks tab shows all of the tasks in your schedule, listed in a multi-column format.

The columns show, task name; start date; end date; planned start date; planned end date; task type; whether any objects from the model are attached to the task; whether the task is linked to an external schedule; index of task in external schedule; and unique ID of task in external schedule.

An icon is displayed to the left of each task. These identify the current status of the task, with relation to attached items and links to external schedules:

Task with no attached items
Task with attached items
Task with link synchronized to external schedule
Task with link synchronized to external schedule, including Task Type
Task with link to external schedule that is either broken or old (unsynchronized)

A context menu, accessed by right clicking in the Tasks tab, allows you to perform a number of functions to create, edit and check the tasks in your schedule:

  • Add Task . Choose this to add a new task to the schedule. "New Task" will be created and by default assigned the present date which you can change by clicking on the drop down icon to the right of the Start and End dates, then choosing the date you require from the calendar that is displayed:

    Note

    The dates under the Start and End columns are Actual start and end dates. For Planned start and end dates, see >assigning planned start and end dates

    Use the left and right arrow buttons at the top of the calendar to move backwards and forwards a month, respectively, then click on the day you require.

    Should you wish to change the start or end time, select the task, then click once on the time to highlight the hour, minute or second field. Once highlighted, you can then edit its value. Use the left and right arrow keys to move to the next time unit field. The date can also be edited in this way.

    Should you also wish to add Planned start and end dates, simply click on the drop down icon to the right of the Planned Start and Planned End dates, then choose the date you require from the calendar.

    Note

    If you have both Actual and Planned dates entered, but would like to disable one or the other, then this can be done by unchecking the check box to the left of the date.

    From the Task Type drop down, select the type of task you wish this task to be. There are three pre-defined task types, Construct, Demolish and Temporary . The task type defines how the items attached to the task will be displayed during simulation; for example, a default construction sequence would start with all items hidden, as the task starts the attached items will be displayed in transparent green, then as the task ends the attached items will be displayed as they are in the normal model display (this may be with materials applied if previously set up in JetStream Presenter). Task Types themselves can be defined and new types created in the Configure tab.

    Each task has it's own Status identified by an icon, representing planned against actual relationships:

    Actual start and end dates equal Planned start and end dates
    Actual end date before Planned start date
    Actual start date after Planned end date
    Actual start date before Planned start date and Actual end date after Planned end date
    Actual start date before Planned start date and Actual end date equals Planned end date
    Actual start date equals Planned start date and Actual end date after Planned end date
    Actual start date equals Planned start date and Actual end date before Planned end date
    Actual start date after Planned start date and Actual end date equals Planned end date
    Actual start date before Planned start date and Actual end date before Planned end date
    Actual start date after Planned start date and Actual end date after Planned end date
    Actual start and end dates only
    Planned start and end dates only

    Note

    The relevant Status icon will be automatically displayed based on the tasks actual and planned start and end dates.

    The check box in the Active column enables you to turn a task on/off. If a task is turned off, then it will not appear in the simulation . For hierarchical tasks, turning off the parent task will automatically turn off all child tasks.

    JetStream TimeLiner supports a hierarchical task structure, as brought through from a link to your scheduling software, e.g. Microsoft Project (see The Links Tab for more information). The hierarchy can be expanded or contracted by clicking on the plus or minus sign, respectively, to the left of the task.

    Note

    It is possible to move between entries in a manually editable task using the keyboard. Simply select a task that has been set to be manually editable, and use Tab and Shift-Tab to move forwards and backwards between fields. The keyboard can then be used to edit and set each entry where necessary.

  • Delete Task . Choose this to delete the selected task(s).

  • Detach Selection . Choose this to detach the currently selected items in the scene, from the selected task(s). See the chapter called "Selecting Items" in the JetStream Roamer book for more information on making a selection in the scene.

  • Attach Selection . Choose this to attach the currently selected items in the scene, to the selected task(s). See the chapter called "Selecting Items" in the JetStream Roamer book for more information on making a selection in the scene.

  • Append Selection . Choose this to append the currently selected items in the scene, to the items already attached to the selected task(s). See the chapter called "Selecting Items" in the JetStream Roamer book for more information on making a selection in the scene.

  • Attach Search . Choose this to attach all items selected by the current Search , to the selected task(s). See the section called "Finding Items" in the chapter called "Finding" in the JetStream Roamer book for more information on searching.

  • Attach Named Search . Choose this to attach all items selected by the named search currently selected in the selection tree. For example, anything on the Sets or Properties tabs.

  • Attach Selection Set . This option is used to attach all items contained within a Selection Set , to the selected task(s). When you choose this option a list of all Selection and Search Sets saved in the current scene is displayed. Choose the Selection or Search Set you wish to attach to the task(s). See the section called "Selection and Search Sets" in the chapter called "Selecting Items" in the JetStream Roamer book for more information on Selection and Search Sets.

  • Display Attached Items . Choose this to select in the scene and the selection tree, all items attached to the selected task(s). The items will be highlighted based on the selection options you have defined. See the section called "Selection Options" in the chapter called "Selecting Items" in the JetStream Roamer book for more information on selection options.

  • Relink . Choose this to relink the selected task with your scheduling software. You will only be able to relink the parent task, i.e. the task with the same name as the link. You will be prompted to choose the link to attach the task to, as you may have more than one link set up. See Select Link Dialog for more information on linking tasks.

    Note

    Whilst a task is linked to an external schedule, Actual or Planned start and end dates cannot be edited. Unlinking a task from it's schedule will enable you to edit the dates, however it will obviously no longer be synchronized with the schedule. For editing of dates, it is recommended to do this in the scheduling software and then Synchronize Tasks from Link

  • Unlink . Choose this to unlink the selected task from an external schedule, enabling you to maually edit start and end dates. You will only be able to unlink the parent task, i.e. the task with the same name as the link.

  • Check . This option enables you to check the validity of the schedule, by identifying items that have not been included in any task, are duplicated in multiple tasks or, are in overlapping tasks. Choosing Check will list the available checks, including:

    • Find uncontained items . Choose this to select any items in the scene that are not attached to a task, or are not contained within any other item attached to a task.

      Note

      A Contained item is the child of another item. For example, if you select a Group, Block or Cell which is comprised of various pieces of geometry, then that geometry is contained within the Group, Block or Cell. A Group, Block or Cell may therefore be attached to a task and although the child geometry is not directly attached ltself, it is contained within an item that is attached.

    • Find contained items . Choose this to select any items in the scene that are either attached to a task or contained within any other items attached to a task.

    • Find attached items . Choose this to select any items in the scene that are directly attached to a task.

    • Find items attached to multiple tasks . Choose this to select any items in the scene that are directly attached to more than one task.

    • Find items contained in multiple tasks . Choose this to select any items in the scene that are either attached to, or contained within any other item that is attached to more than one task.

    • Find items attached to overlapping tasks . Choose this to select any items in the scene that are attached to more than one task, where the task durations overlap.

    • Find items contained in overlapping tasks . Choose this to select any items in the scene that are either attached to, or contained within any other item that is attached to more than one task, where the task durations overlap.

  • Tools . This option enables you to quickly create your own schedule, based on model layers, topmost items, or selection sets:

    • Add named task for each topmost Layer . Choose this to create a new task for each topmost layer in the current scene. Each task will be named the same as the topmost layers and each layer will be attached to the corresponding task. Start and End dates will be automatically created, starting from the current date and incrementing by one day for each subsequent end and start date. Planned Start and End dates will also be automatically created and these will be the same as the 'Actual' dates. Finally, the task type will be set to Construct.

    • Add named task for each topmost item . Choose this to create a new task for each topmost item in the current scene, which may be a layer, a group, block or cell, or geometry, depending on how the model is constructed. Each task will be named the same as the topmost item and each item will be attached to the corresponding task. Start and End dates will be automatically created, starting from the current date and incrementing by one day for each subsequent end and start date. Planned Start and End dates will also be automatically created and these will be the same as the 'Actual' dates. Finally, the task type will be set to Construct.

    • Add named task for each selection set . Choose this to create a new task for each selection set in the current scene. Each task will be named the same as the selection set and each selection set will be attached to the corresponding task. Start and End dates will be automatically created, starting from the current date and incrementing by one day for each subsequent end and start date. Planned Start and End dates will also be automatically created and these will be the same as the 'Actual' dates. Finally, the task type will be set to Construct.

  • Add Comment . Choose this to add a comment to the task. See the section called "Commenting" in the chapter called "Reviewing" in the JetStream Roamer book for more information on adding comments.

  • Rename . Choose this to rename the task. When the text field becomes active, enter the new name then press Enter to save it.

TimeLiner tasks can be sorted on a per-column basis. This can be done in two ways.

Firstly columns can be sorted by left-clicking on the column headers. Clicking multiple times will alternate the sort between ascending and descending, treating a-z, 0-9, Monday-Friday etc. as ascending.

Tasks can also be sorted by right-clicking on the column heading and clicking Sort

Columns can then be sorted by selecting Ascending or Descending

Maintain Hierarchy , that is, keeping contained tasks inside their containers, is on by default, and shows in this menu with a tick next to it. When sorting with Maintain Hierarchy selected, tasks are sorted first by container, then by container contents.

If it is not required to maintain the hierarchy in the sort, then Maintain Hierarchy can be un-ticked. Sorting without the hierarchy maintained will treat the tasks and containers as un-connected items and sort everything together.

All columns can be sorted in this manner. If Sorting is selected on the Status column, activities will be sorted from early through to late start for ascending, and vice-versa for descending.

Note

You can use multi-selection (i.e. holding down Shift or Ctrl) to perform most commands on several tasks at once. For example, should you need to delete all tasks, select the first task, then hold down Shift and select the last task, then press Delete

Select Link Dialog

Select Link Dialog

You can Relink a task to an external schedule, by right-clicking on the Task and selecting Relink. When doing this, you will be prompted to select which Link to use, as your project may be linked to multiple schedules.

Links

Links

The Links tab allows you to add, view and edit all of the Standard Links to external schedules in your project. Task hierarchies can then be added to the Tasks tab and synchronized from the link. The Field Selector Dialog determines various options used when importing data from a link.

The Links Tab

The Links Tab

The Links tab shows all of the links to external schedules in your project, listed in a multi-column format.

The columns show link name, source (e.g. Microsoft Project), project (e.g. my_schedule.mpp , and link status. Any further columns (there maybe none) identify the fields from the external schedule which specify the task type, unique id, start date and end date for each linked task.

The possible values for Status are:

Synchronized

All linked tasks have the same values as the external schedule.

Old

Linked tasks have values that are out of date compared to the external schedule. >Synchronize Tasks from Link to update the tasks.

Status Not Available

Its not possible to determine whether tasks are Synchronized or Old. This value only occurs for schedule sources that don't provide any way of determining when a schedule was last updated.

Broken

The external schedule can not be accessed. The file may have been moved or deleted, or required software may be missing or not functioning correctly. TimeLiner will still function using the task values determined when the link was last synchronized.

All Link operations are performed via the context menu (accessed by right clicking in the Links tab). This allows you to add, delete and edit links; rebuild the task hierarchy from the project file into TimeLiner; synchronize existing tasks in TimeLiner with updated data in the project file.

  • Add Link . Choose this to create a new link to an external project file. Selecting this option will display a further menu, listing all project sources that may be connected to on the current machine (See Supported Scheduling Software for more information on which sources are available). Choose the source to which you wish to link to. A standard Open file dialog will be displayed. Browse to and Open the project file you wish to link to. The Field Selector dialog will then be displayed, from which you can identify additional data to be brought through from the project file.

  • Delete Link . Choose this to delete the currently selected link.

    Note

    Deleting the link to an external project file will not delete any tasks that have previously been rebuilt in the TimeLiner Tasks tab.

  • Rebuild Taks Hierarchy from Link . Choose this to read all of the tasks and associated data (as defined in the Field Selector dialog) from the selected project file and add these to the Tasks tab.

    Choose this option also to synchronize with the selected project file when new tasks have been added to the project file. This will rebuild the task hierarchy in TimeLiner, containing all of the latest tasks and data.

  • Synchronize Tasks from Link . Choose this to update all existing tasks in the Tasks tab, with the latest associated data from the selected project file (e.g. Start and End dates).

  • Rebuild Task Hierarchy from All Links . Choose this to read all of the tasks and associated data (as defined in the Field Selector dialog) from all project files listed in the Links tab and add these to the Tasks tab.

    Choose this option also to synchronize with all project files when new tasks have been added to the project files. This will rebuild the task hierarchy in TimeLiner, containing all of the latest tasks and data.

  • Edit Link . Choose this option to edit the selected link. This will display the Field Selector dialog, from which you can define new fields or re-define existing ones.

  • Rename . Choose this to rename the link to something more appropriate. When the text field becomes highlighted, enter the new name, then press Enter to save it.

Note

Tasks in the external schedule will be ignored if they do not include both start and end dates, with the start date being less than or equal to the end date.

JetStream TimeLiner supports multiple sources of external schedules using a COM interface. Anyone can develop support for a new schedule source - the type library that defines the interface is included with TimeLiner.

Field Selector Dialog

Field Selector Dialog

The Field Selector dialog determines various options used when importing data from a Link. The options available may be different for each type of link source.

Options

From the drop down list to the right of each field, choose the corresponding field from your project source.

Task Type import field

The field used to automatically assign >Task Types to each imported Task.

Unique ID import field

The field used to uniquely identify each imported Task. This allows synchronization to work even if major changes are made to the external schedule in the scheduling software. The default behaviour is to use the most appropriate field for each source. Some sources do not have a well defined unique id, in which case you may need to choose a field manually.

Start Date import field

Some project sources support multiple start dates for different purposes. The default behaviour is to use the most appropriate available date for each source. This field may be used to define an Actual Start date, should it be different to that selected by default.

End Date import field

Some project sources support multiple end dates for different purposes. The default behaviour is to use the most appropriate available date for each source. This field may be used to specifically define an Actual End date, should it be different to that selected by default.

Planned Start

The field used to identify a planned start date. This allows planned against actual comparisons to be made and simulated.

Planned End

The field used to identify a planned end date. This allows planned against actual comparisons to be made and simulated.

User 1 to 10

Ten user fields available to link any custom data fields from the project source.

Standard Links

Standard Links

JetStream TimeLiner supports a variety of scheduling software. Note that some of these may only function if the relevant scheduling software is installed.

Supported Scheduling Software

Microsoft Project 2000

Microsoft Project 2002

Microsoft Project MPX

Primavera Project Planner

Primavera Project Management 4 and 5

Asta Power Project

Microsoft Project 2000

Microsoft Project 2000

This Link requires Microsoft Project 2000 to be installed.

Microsoft Project

Microsoft Project

This Link requires Microsoft Project 2002 to be installed.

Microsoft Project MPX

Microsoft Project MPX

TimeLiner can read Microsoft Project.mpx files directly, without needing a copy of Microsoft Project (or any other scheduling software) installed. Primavera SureTrakPrimavera Project Planner and Asta Power Project can all export .mpx files.

Note

Primavera SureTrak exports its unique id in the text10 field of the .mpx file, rather than the unique id field. When linking to an .mpx file exported from SureTrak be sure to specify the text10 field as the unique id field in the Field Selector Dialog

Primavera Project Planner

Primavera Project Planner

This Link requires Primavera Project Planner to be installed. The Link status will be displayed as "Status not available".

Note

TimeLiner will ask for a username and password to link to Primavera Project Planner. If these are unknown, there is a possibility that these can be retrieved from the P3 shortcut.

To locate this information, right-click on the shortcut used to run P3, and select Properties . The properties dialog will show the target command line which will look something like

"C:\'Program Files\'P3\'P3.exe /U:Bob"
Here, the username is set as "Bob", and for the purposes of the TimeLiner dialog the password will be the same.

Primavera Project Management 4 and 5

Primavera Project Management 4 and 5

This Link requires a number of elements to be installed alongside JetStream:

  • Primavera Project Manager 4 and 5 product

  • ActiveX Data Objects 2.1

  • Primavera Software Development Kit (available on the Primavera CDs)

PPM 4 and 5 are database driven, and as such require the Software Development Kit to be installed in order to set up the ODBC data source link. This can be installed and setup from the Project Management CD by taking the following steps:

  1. Insert Project Management CD, enter the Product Key and accept the License Agreement.

  2. Make sure "Primavera Applications or Components" is selected and click "Next".

  3. Select "Other Components" and click "Next".

  4. Select "Software Development Kit" and click "Next".

  5. Continue through clicking "Next" until the install starts.

  6. Once installation is complete, click "OK" to start the Database Configuration Wizard.

  7. Adjust settings in the Software Development Kit Setup dialog where appropriate, and click "OK".

  8. Click "Yes" for a log file, followed by "Finish" to complete.

On connecting to PPM 4 and 5 within TimeLiner, a logon dialog allows the source link to be selected (a warning occurs if none are present). The username and password are not stored in the NavisWorks file, and will be prompted for each time.

Once connected, a dialog box allows the user to select which project to open. A checkbox determines if all sub-projects are opened.

By default, TimeLiner brings through Start, End, Planned Start, and Planned End as "Start", "Finish", "BL Start" and "BL Finish" respectively.

Other Primavera dates can be selected through the generic TimeLiner 'Field Selector' Dialog, including 'Project Activity Codes', 'Global Activity Codes', and 'User Defined Fields'.

The TimeLiner hierarchy supports the WBS structure for Project / Activity hierarchy.

Note

Due to the nature of the Primavera Project Manager 4 and 5 products using the SDK for data access, linking with TimeLiner can take a longer period of time than other formats.

Asta Power Project

Asta Power Project

This Link requires Asta Power Project to be installed.

Configure

Configure

The Configure Tab allows you to define task types, appearances and an overall start appearance for the simulation.

The Configure Tab

The Configure Tab

The configure tab allows you to define Task Types Appearance Definitions and an Overall Start Appearance for the simulation.

Each Task has a >Task Type associated with it, which specifies how the >items attached to the task are treated (and displayed) at the start and end of the task during simulation. The available options are:

  • None . Choose this if you wish for nothing to happen to the items attached to the task.

  • Hide . Choose this if you wish the items attached to the task to be hidden.

  • Model Appearance . Choose this if you wish the items attached to the task to be displayed as they are defined in the model. This may be the original CAD colors or, if you have applied color and transparency overrides in Roamer or materials in Presenter, then these will be displayed.

  • Appearance Definitions . Choose from the list of Appearance Definitions , including ten predefined appearances and any custom appearances you have added. See >Appearance Definitions for more information.

TimeLiner comes with three predefined Task Types to help get you started. These are: Demolish (highlight the object in red at the start of the task and hide at the end); Temporary (highlight the object in yellow at the start of the task and hide at the end); Construct (highlight object in green at the start of the task and reset to Model Appearance at the end). You are free to add you own task types or even delete the predefined ones, as you wish.

  • Construct . For tasks where the attached items are to be constructed. The default appearance is for items to be highlighted in green (90% transparent) at the start of the task and displayed in the > Model Appearance at the end of the task.

  • Demolish . For tasks where the attached items are to be demolished. The default appearance is for items to be highlighted in red (90% transparent) at the start of the task and hidden at the end of the task.

  • Temporary . For tasks where the attached items are only temporary. The default appearance is for items to be highlighted in yellow(90% transparent) at the start of the task and hidden at the end of the task.

    Managing task types

    New Task Types can be added and any may be deleted or renamed. These functions are available on the context menu (accessed by right clicking in the Task Types list).

  1. Choose Add to create a new Task Type. This will be added to the bottom of the list and will be highlighted, enabling you to enter a new name for it.

    Click on the drop down icons to the right of each Appearance field and choose a definition from the list.

    Note

    Early and Late appearances can be defined here for the purpose of displaying Planned against Actual simulations.

    Simulation Start Appearance allows a unique start appearance to be set on a particular task type. Some tasks need to be visible at the start of a construction project to allow the simulation of the demolition of existing structures, prior to construction of new elements. Any tasks that don't have this set will default to the start appearance set in Default Simulation Start Appearance

  2. Choose Delete to delete the selected Task Type.

  3. Choose Rename to rename the selected Task Type. Once the Task Type is highlighted, enter the new name, then press Enter to save it.

    Defining appearance definitions

    TimeLiner comes with a set of ten predefined Appearance Definitions that you can use when defining task types. Appearances define a level of transparency and a color. You can add your own Apperance Definitions, delete and rename them. These functions are available on the context menu (accessed by right clicking in the Appearance Definitions list):

  1. Choose Add to add a new Appearance Definition. This will be added to the bottom of the list and will be highlighted, enabling you to enter a new name for it.

    In the Transparency % field, use the Up and Down controls to set the transparency level, between 0% and 100% (where 0% is opaque and 100% is fully transparent).

    In the Color field, click on the color to open the color selector. From here, either select one of the basic colors available, or click Define Custom Colors to define your own color choice.

  2. Choose Delete to delete the selected Appearance Definition.

  3. Choose Rename to rename the selected Appearance Definition. Once the Appearance Definition is highlighted, enter the new name, then press Enter to save it.

    Default Simulation Start Appearance

    The Configure tab also specifies a default appearance to apply to all objects in the model at the start of the simulation. The default is Hide , which is ideal for simulating most construction sequences.

  1. From the Default Simulation Start Appearance drop down, choose from the list of >Appearance Definitions that which you wish to start your simulations with.

Rules

Rules

The Rules Tab enables you to automatically map Tasks to items in the model.

The Rules Tab

The Rules Tab

The Rules tab lists all currently available rules. These can be used to map Tasks to items in the model. Each of the default rules can be edited and new rules may be added as necessary:

    Predefined rules

  • Items By Task Name . Choose this rule to attach each Item in the model to each Task with the same name in the specified column. The default is to use the Task Name column. See >Editing TimeLiner rules for information on editing this rule.

  • Selection Sets By Task Name . Choose this rule to attach each Selection Set in the model to each Task with the same name in the specified column. The default is to use the Task Name column. See >Editing TimeLiner rules for information on editing this rule.

  • Layers By Task Name . Choose this rule to attach each Layer in the model to each Task with the same name in the specified column. The default is to use the Task Name column. See >Editing TimeLiner rules for information on editing this rule.

  • Attach Items to Task by Category/Property . Choose this rule to attach each Item in the model with the defined property, to each Task with the same name in the specified column. The default is to use the Task Name column, however you will also need to define the ' and '' values. See >Editing TimeLiner rules for information on editing this rule.

    Editing TimeLiner rules

  1. To edit an existing rule, click the Edit button and the Rules Editor will be displayed for the selected rule. See >Adding custom TimeLiner rules for information on the available options.

    Adding custom TimeLiner rules

  1. From the Rules tab of the TimeLiner control bar, click the New button.

    The Rules Editor dialog is displayed:

  2. Enter a new name for your rule in the Rule name box.

    Note

    If you choose not to enter a name, upon selecting a rule template the name of that template will be used.

  3. From the Rule templates list, choose a template from which your rule will be based upon.

    Note

    The Attach Items to Tasks template is that used for the first three pre-defined TimeLiner rules, (Items, Selection Sets and Layers By Task Name).

    The Attach Items to Tasks by Category/Property template enables you to specify a property within the model scene. If a task has the same name as the specified property value in the model, then all items having that property will be attached to that task when you check the rule Attach Items to Tasks by Category/Property , and click Apply Rules

  4. In the Rule description box, click on each of the underlined values to define your custom rule. The customizable values available with the built in templates are:

    • Column Name . Choose which column in the Tasks tab you wish to compare Item names to. The default is the Task Name , though you may also choose one of the ten User columns, identified in the Field Selector

    • Items . Choose what you would like the value in the Column Name to be compared to in the model scene. The default is Item name, though you may also choose either Selection Sets or Layers

    • Matching . Use case sensitivity and therefore only match names that are exactly the same. You may also choose Ignoring to ignore case sensitivity.

    • Category/Property Name . Use the name of the category or property as it is displayed in the interface (recommended). You can also choose Internal Name which is that accessed via the API (for advanced use only).

    • '' . Choose from the available list, which category the property you wish to define is in. Only the categories that are contained in the scene are available in the drop down.

    • '' . Choose from the available list, which property you wish to define. Again, only the properties in the scene within the chosen category will be available.

  5. Click OK to add the new TimeLiner rule, or Cancel to return to JetStream.

    Applying TimeLiner rules

  1. Check the rules you want to use and press Apply Rules to apply them. The rules will be applied in order and will attach items to any Tasks without attached items.

  2. If Override current selections is checked, then when the rules are applied they will replace any existing attached items.

    Deleting TimeLiner rules

  1. To delete an existing rule, click Delete and the selected rule will be removed.

Simulate

Simulate

The Simulate tab enables you to simulate your TimeLiner sequence throughout the duration of the project schedule. If a full TimeLiner license is available, playback and Overlay Text options can be edited to customize your simulation, using the Simulation Settings button and the Overlay Text Dialog

If no TimeLiner license is available, the Simulate tab will be the only accessible tab, and only Playback will be available.

The Simulate Tab

The Simulate Tab

The simulate tab allows you to simulate your schedule. The tab includes standard animation style controls that enable you to set the simulation to any date within your schedule. Objects attached to each Task are hidden or highlighted as specified by the Task Type appearance definitions on the Configure tab.

    Playing back a simulation

  1. You can use the slide bar to quickly move forwards and backwards through the simulation. Full left is at the beginning and full right is at the end. The date box below the playback controls shows the point in time through the simulation. You can click on the drop down icon (to the right of the date) to display a calendar, from which you can select a date to 'jump' to.

  2. Use the playback controls to step and play forwards and backwards through the animation:

    • Rewind will rewind the simulation back to the beginning.

    • Step Back will step back a single step size (see >Setting the step size for more information).

    • Reverse Play will play the simulation backwards.

    • Pause will pause the simulation at the time you press it at. You can then look around and interrogate the model, or step forwards and backwards through the simulation. To continue playing from where you paused, just press Play again.

    • Stop will stop the simulation playing and rewind back to the beginning.

    • Play will play the simulation from the currently selected time.

    • Step Forwards will step forwards a single step size (see >Setting the step size for more information).

    • Forward will fast forward the simulation to the end.

The simulate tab also shows all Active Tasks at the current simulation time and how close to completion they are (Progress , displayed as a percentage). The Status of each active tasks is also displayed as an icon. For simulations where Planned and Actual dates are available, the status provides a visual representation as to whether there is any variance between the planned and actual dates. See >TimeLiner task status for a definition of each status icon.

The Comments control bar can be used to view any comments attached to an active task (see the section called "Commenting" in the chapter called "Reviewing" in the JetStream Roamer book for more information on commenting).

While the simulate tab is in use, by default the current simulation date is overlayed on the main window. The information displayed can be customized using the Overlay Text Dialog accessed using the Settings button.

Note

If a full TimeLiner license is not available, the Simulation Settings will be inaccessible and the Settings button will be greyed out.

You can use a pre-recorded animation (created in JetStream Roamer) to dynamically change the viewpoint during simulation. See the Simulation Settings section for more information.

Simulation Settings

Simulation Settings

The Settings button provides access to the Simulation Settings dialog.

It is possible to override the Start and End dates that the simulation runs between. Checking the Override Start / End dates check box un-greys the date boxes and enables the setting of start and end dates to suit, allowing a small sub-section of the overall project to be simulated. The dates will be shown on the TimeLiner Simulate tab. These dates will also be used when exporting animations.

You can define the Interval Size to use when stepping through the simulation using the playback controls. The interval size can be set either as a percentage of the overall simulation duration or to an absolute number of days or weeks, etc.

Use the drop down to select the interval unit, then use the Up and Down arrow buttons to increase or decrease the interval size.

It is also possible to highlight all the tasks that are being worked on during the interval. By checking the Show all tasks in interval check box, and for example setting the Interval Size to 5 Days, all tasks being worked on during those 5 days will be set to their Start Appearance in the main view, including those that begin and end within the bounds of the interval. The Simulation slider will show this by drawing a blue line under the slider. If un-checked, tasks that begin and end within the bounds of the interval will not be highlighted in this manner, and will need to overlap with the current date in order to be highlighted in the main view.

You can define the overall Playback Duration for the complete simulation (the time needed to play it through from start to finish). Use the Up and Down arrow buttons to increase or decrease the duration (in seconds). You may also enter a duration directly into this field.

You can define whether the current simulation date should be overlayed on the main window, and if so whether it should appear at the top or bottom of the screen. From the drop down, choose from None (to display no overlay text), Top (to display the text at the top of the window), or Bottom (to display the text at the bottom of the window).

You can Edit the information displayed in the overlay text using the Overlay Text dialog. This dialog also makes it possible to alter the Font Type Style and Size by clicking on the contained Font button.

You can define whether the current simulation should interact with the current animation. If so, during the TimeLiner sequence playback, JetStream will also play the current animation, i.e. providing camera interaction throughout the simulation. You can pre-record a suitable animation for use with the simulation, using the normal JetStream Roamer Animation tools (see the section called "Creating Animations" in the chapter called "Animating" in the JetStream Roamer book). This option also affects the Animation Export

TimeLiner supports Planned and Actual dates and provides five simulation Views . Each view will playback the schedule depicting Planned and Actual relationships:

  • Actual . Choose this view to simulate the Actual schedule only (i.e. only use the Actual start and Actual end dates).

  • Actual (Planned Differences) . Choose this view to simulate the Actual schedule against the Planned schedule. This view will only highlight the items attached to the task over the Actual date range (i.e. between Actual Start and Actual End. See diagram below for graphical representation). For time periods where the Actual dates are within the Planned dates (on schedule), the items attached to the task will be displayed in the Task Type Start Appearance. For time periods where the Actual dates are early, or late in comparison to the Planned dates (there is a variance), then the items attached to the task will be displayed in the Task Type Early or Late Appearance, respectively.

  • Planned . Choose this view to simulate the Planned schedule only (i.e. only use the Planned start and Planned end dates).

  • Planned (Actual Differences) . Choose this view to simulate the Actual schedule against the Planned schedule. This view will only highlight the items attached to the task over the Planned date range (i.e. between Planned Start and Planned End. See diagram below for graphical representation). For time periods where the Actual dates are within the Planned dates (on schedule), the items attached to the task will be displayed in the Task Type Start Appearance. For time periods where the Actual dates are early, or late in comparison to the Planned dates (there is a variance), then the items attached to the task will be displayed in the Task Type Early or Late Appearance, respectively.

  • Actual against Planned . Choose this view to simulate the Actual schedule against the Planned schedule. This will highlight the items attached to the task over the entire Planned and Actual date range (i.e. between the earliest of Actual and Planned start dates and the latest of Actual and Planned End dates. See diagrams below for graphical representation). For time periods where the Actual dates are within the Planned dates (on schedule), the items attached to the task will be displayed in the Task Type Start Appearance. For time periods where the Actual dates are early, or late in comparison to the Planned dates (there is a variance), then the items attached to the task will be displayed in the Task Type Early or Late Appearance, respectively.

Overlay Text Dialog

Overlay Text Dialog

You have the option to define the text overlayed on the main window during simulation, by clicking Edit in the Simulation Settings dialog.

By default the date and time are displayed using the format specified in Control Panel, Regional Settings . You can specify the exact format to use by entering text into the text box. Most text will appear as entered, except that words prefixed with a or character act as keywords and are replaced with various values. The Date/Time and Extras buttons can be used to select and insert all possible keywords. The Colors button can be used to define the color of the Overlay Text.

The Font button brings up the standard Microsoft Windows font picker dialog box. Once the correct font, font style and point size have been selected, press Okay to return to the Overlay Text dialog box. The current font selection is shown next to the Font button, and during the TimeLiner simulation, all text on the overlay will be shown using this font.

Date/Time Keywords

%a

Abbreviated weekday name

%A

Full weekday name

%b

Abbreviated month name

%B

Full month name

%c

Date and time representation appropriate for locale

%d

Day of month as decimal number (01 - 31)

%H

Hour in 24-hour format (00 - 23)

%I

Hour in 12-hour format (01 - 12)

%j

Day of year as decimal number (001 - 366)

%m

Month as decimal number (01 - 12)

%M

Minute as decimal number (00 - 59)

%p

Current locale's A.M./P.M. indicator for 12-hour clock

%S

Second as decimal number (00 - 59)

%U

Week of year as decimal number, with Sunday as first day of week (00 - 53)

%w

Weekday as decimal number (0 - 6; Sunday is 0)

%W

Week of year as decimal number, with Monday as first day of week (00 - 53)

%x

Date representation for current locale

%X

Time representation for current locale

%y

Year without century, as decimal number (00 - 99)

%Y

Year with century, as decimal number

%z

Time-zone abbreviation; no characters if time zone is unknown

%Z

Time-zone name; no characters if time zone is unknown

Color Keywords

$COLOR_RED

Sets the overlay display text color to be red.

$COLOR_BLUE

Sets the overlay display text color to be blue.

$COLOR_GREEN

Sets the overlay display text color to be green.

$COLOR_WHITE

Sets the overlay display text color to be white.

$COLOR_BLACK

Sets the overlay display text color to be black.

$RGBr,g,b$RGB

Sets the overlay display text to any color specified using explicit rgb values between 0 and 255. For example, $RGB127,127,127$RGB sets the color to grey.

Extra Keywords

$TASKS

Adds the name of each currently active task to the overlay display text. Each task is displayed on a new line.

$DAY

Days since start of first task in project (starting from 1)

$WEEK

Weeks since start of first task in project (starting from 1)

Ctrl+Enter

Type Ctrl+Enter to insert a newline into the overlay display text.

Percent sign

Export

Export

You can export a static image at any time during a simulation by using one of the standard JetStream Roamer image exports, whilst the simulation tab is active. See the section called "Exporting an image" in the chapter called "File Management" in the JetStream Roamer book for more information.

You also have the option to Export an AVI of an entire TimeLiner simulation.

Exporting a TimeLiner simulation as an AVI

Exporting a TimeLiner simulation as an AVI

You can export a TimeLiner simulation as an AVI or as a sequence of still images, using the File, Export, Animation dialog. See the section called "Exporting an animation" in the chapter called "File Management" in the JetStream Roamer book for more information.

Options

Options

TimeLiner has some general options.

TimeLiner Options

TimeLiner Options

This dialog is used to control the general TimeLiner options.

    Setting TimeLiner options

  1. Go to Tools, Global Options, TimeLiner

    The TimeLiner dialog is displayed

  2. Check the Auto select attached items check box if you want TimeLiner to select any attached items as each Task is selected.

  3. Check the Display synchronization errors check box if you want TimeLiner to inform you of errors when synchronizing Tasks from external Links.

  4. Click OK to set the options or Cancel to exit the dialog without setting them.