Skip to main content

Notice: this Wiki will be going read only early in 2024 and edits will no longer be possible. Please see: https://gitlab.eclipse.org/eclipsefdn/helpdesk/-/wikis/Wiki-shutdown-plan for the plan.

Jump to: navigation, search

Triquetrum/Getting Started

< Triquetrum
Revision as of 13:41, 12 February 2016 by Cxbrooks.gmail.com (Talk | contribs) (Fixed typo)

This page covers how to get started with Triquetrum.

There are at least two ways to get started with Triquetrum:

  1. Building From Sources, which is for people who will collaborate on Triquetrum
  2. Downloads, which is for people who want to use Triquetrum

Running

Select a workspace

When Triquetrum starts up, you will be prompted to Select a workspace:

The "Select a workspace" window.  Either click on OK or Browse to a different location

The Welcome Pane

The Eclipse Application may show a welcome window, which you can close.

The Welcome pane.  Close the pane by clicking on the X in the pane tab

The first Triquetrum window

You will then see a fresh Triquetrum window:

The first Triquetrum window

Create a Triquetrum Project

Triquetrum is based on a project model, so first we create a project:

  1. Right click on the Project Explorer tab
  2. Select New -> Project -> General -> Project

The window that appears after right clicking in the Project Explorer pane and selecting New -> Project -> General -> Project.

  1. Click on Next
  2. Enter the name of your project. We chose ``MyProject``.

Create a project named ``My Project``

  1. Click on Finish
  2. Your project will appear in the Package Explorer tab

Create a Workflow

The next step is to create a workflow:

  1. In the Package Explorer, right click on the newly created workspace
  2. Select New -> Other

[1]

  1. In the Select a wizard dialog, open Workflows and select Triquetrum workflow model

[2]

  1. Click on Next
  2. In the Diagram window, select the Diagram type of Triquetrum workflow (you may need to double click on Triquetrum workflow)
  3. In Triquetrum, a tab called newDiagram should appear:

[3]

Build and Run A Model

  1. Drag a Const, Discard and SDF director from the right side into the newDiagram pane.
  2. Then drag from the Const output port to the Discard input port.
  3. Then click on the background of the diagram so that the relation changes from an orange dashed line to a blue solid line:

[4]

  1. Save the model.
  2. Click the green run arrow in the upper left tool bar.
  3. Look in the Console tab of the Eclipse that was used to launch Triquetrum. You should see lines that have the state of the ptolemy.actor.Manager, starting with STARTING:


2015-12-15 15:20:22,890 INFO [pool-1-thread-1]  executor.WorkflowExecutionTask (call:124) - Context 1d97dbcf-28e6-4fb6-abb0-3827c6408870 - Starting execution of model newDiagram
2015-12-15 15:20:22,890 INFO [pool-1-thread-1]  executor.WorkflowExecutionTask (managerStateChanged:275) - Context 1d97dbcf-28e6-4fb6-abb0-3827c6408870 - Execution state change of model newDiagram : STARTING
2015-12-15 15:20:22,912 INFO [pool-1-thread-1]  executor.WorkflowExecutionTask (managerStateChanged:275) - Context 1d97dbcf-28e6-4fb6-abb0-3827c6408870 - Execution state change of model newDiagram : ACTIVE
2015-12-15 15:20:22,912 INFO [pool-1-thread-1]  executor.WorkflowExecutionTask (managerStateChanged:275) - Context 1d97dbcf-28e6-4fb6-abb0-3827c6408870 - Execution state change of model newDiagram : STOPPING
2015-12-15 15:20:22,913 INFO [pool-1-thread-1]  executor.WorkflowExecutionTask (managerStateChanged:275) - Context 1d97dbcf-28e6-4fb6-abb0-3827c6408870 - Execution state change of model newDiagram : IDLE
23 ms. Memory: 530944K Free: 403671K (76%)
2015-12-15 15:20:22,913 INFO [pool-1-thread-1]  executor.WorkflowExecutionTask (executionFinished:248) - Context 1d97dbcf-28e6-4fb6-abb0-3827c6408870 - Execution finished of model newDiagram


Editing

  • To change the name of an actor, highlight the actor name in the model and type in a new name
  • To change a parameter, double click on the actor and select the parameter:

[5]

FIXME: There is a problem under Mac OS X where the updated values are ignored, see Triquetrum Issue #7.

Back to the top