• View
• Edit
• History
• Print

Build Triquetrum from Erwin's Sources

The instructions below are obsolete, see BuildTriquetrumFromTheEclipseRepo (December, 2015) Soon, we will do an initial drop of Triquetrum for the Eclipse Foundation to check out the IP. (November, 2015)

Here's how to build what we have so far:

Check Out the Repo

Either run the command from the command line

1. Window -> Show View -> Other -> Git ->Git Repository
2. Click on Clone Repository
3. Enter the URI https://github.com/erwindl0/triquetrum.git
4. Keep the Master Branch
5. Select Finish

Importing Projects

If you checked out Eclipse from the command line, then in Eclipse, right click on the Package Explorer tab and select Import.

If you checked out the Git repo from within Eclipse, then in the Git Repositories tab, expand the triquetrum tab, right click on Working Directory and select Import Projects.

Keep Import existing projects selected, click Next then Finish.

Building

The build will show lots of errors. Don't panic.

1. Expand org.eclipse.triquetrum.target.platform and click on triq.target
   Attach:ErwinTreeTriqTarget1.png Δ
2. The target will build Not sure of the terminology. See the bottom right for the status. It may take a minute or two to build.
3. In trig.target tab, Target Definition pane, click on Set as Target Platform.
   Attach:ErwinTreeSetTargetAsPlatform.png Δ
4. Under org.eclipse.triquetrum.workflow.editor, click on Triquetrum.product
   Attach:ErwinTreeTriquetrumProduct.png Δ
5. In the Triquetrum.product tab, click on the validate icon in the upper right. The icon looks like a lined piece of paper with an check mark.
   Attach:ErwinTreeValidate.png Δ
   A dialog indicating that no problems were detected should come up.
6. In the Triquetrum.product pane, Overview tab, under Testing, click on Launch an Eclipse Application. The application should start up.
   Under Mac OS X, if the application does not start up, see NoClassDefFoundError: org/eclipse/swt/SWTError for a possible solution.

Running

The Eclipse Application may show a welcome window, which you can close. You will then see a fresh Triquetrum window: Attach:ErwinTreeTriqFirstWindow.png Δ

Create a Workspace

Triquetrum is based on a workspace model for projects, so first we create a workspace:

1. Right click on the Project Explorer tab
2. Select New -> Project -> General -> Project
   Attach:ErwinTreeNewProject.png Δ
3. Click on Next
4. Enter the name of your workspace. We chose myWorkspace.
5. Click on Finish
6. Your workspace 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
   Attach:ErwinTreeTriqNewOther.png Δ
3. In the Select a wizard dialog, open Worflows and select Triquetrum workflow model
   Attach:ErwinTreeTriqNewWorkflow.png Δ
4. Click on Next
5. In the Diagram window, select the Diagram type of Triquetrum workflow (you may need to double click on Triquetrum workflow)
6. In Triquetrum, a tab called newDiagram should appear:
   Attach:ErwinTreeTriqNewDiagram.png Δ

Build and Run A Model

1. Drag a Const, Discard and SDF director from the right side into the newDiagram pane:
   Attach:ErwinTreeTriqSimpleModel.png Δ
2. Save the model
3. Click the green run arrow in the upper left tool bar
4. 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-11-25 14:39:54,730 INFO [pool-1-thread-1] executor.WorkflowExecutionTask (call:124) - Context 8467d411-396c-428e-9f29-3b5b76236064 - Starting execution of model newDiagram
   2015-11-25 14:39:54,730 INFO [pool-1-thread-1] executor.WorkflowExecutionTask (managerStateChanged:275) - Context 8467d411-396c-428e-9f29-3b5b76236064 - Execution state change of model newDiagram : STARTING
   2015-11-25 14:39:54,749 INFO [pool-1-thread-1] executor.WorkflowExecutionTask (managerStateChanged:275) - Context 8467d411-396c-428e-9f29-3b5b76236064 - Execution state change of model newDiagram : ACTIVE
   2015-11-25 14:39:54,750 INFO [pool-1-thread-1] executor.WorkflowExecutionTask (managerStateChanged:275) - Context 8467d411-396c-428e-9f29-3b5b76236064 - Execution state change of model newDiagram : STOPPING
   2015-11-25 14:39:54,750 INFO [pool-1-thread-1] executor.WorkflowExecutionTask (managerStateChanged:275) - Context 8467d411-396c-428e-9f29-3b5b76236064 - Execution state change of model newDiagram : IDLE
   21 ms. Memory: 570368K Free: 473118K (83%)
   2015-11-25 14:39:54,751 INFO [pool-1-thread-1] executor.WorkflowExecutionTask (executionFinished:248) - Context 8467d411-396c-428e-9f29-3b5b76236064 - Execution finished of model newDiagram
   

   [$[Get Code]]
   FIXME: There seems to be a delay between when I first run the model and when the output occurs?

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:
  Attach:ErwinTreeTriqEditParameters.png Δ
  FIXME: The values are not yet actually stored.

Problems

NoClassDefFoundError: org/eclipse/swt/SWTError

While starting the Eclipse Application, an error appeared in the console

The solution is to:

1. In the Triquetrum.product pane, click on the Dependencies tab
2. In the Plug-in Selection window, enter *.eclipse.swt, select org.eclipse.swt.cocoa.macosx.x86_64, then click on OK