Exercise no. 4

C++ code within Kepler (

...

IDS handling)

(approx. 30 min)

The knowledge gained:

...

In this exercise you will execute simple C++ code within Kepler. In order to do this follow the instructions:

1. Get familiar with codes that will be incorporated into Kepler

Go to Code Camp related materials within your home directory

shell> cd $TUTORIAL_DIR/FC2K/simplecppactor/cpp/example_4_ids

You can find there various files. Pay particular attention to following ones:

• simplecppactorcpp_ex4.cpp - C++ source code that will be executed from Kepler
• Makefile - makefile that allows to build library file
• simplecppactorcpp_ex4_fc2k.xml - parameters for FC2K application (NOTE! this file contains my own settings, we will modify them during tutorial)
• simplecppactorcpp_ex4_workflow.xml - example workflow

2. Build the code by issuing

shell> make clean
shell> make

Codes are ready to be used within FC2K

3. Prepare environment for FC2K

Make sure that all required system settings are correctly set

...

4. Start FC2K application

This is as simple as typing fc2k from terminal

...

After a while, you should see FC2K's main window.

 

Image Removed

Info
Default settings Note, that your settings will be slightly different. Your Kepler location should point to a valid path for your account.

 

5. Open project

...

cpp_ex4

1. Choose File -> Open
2. Navigate to $TUTORIAL_DIR/FC2K/simplecppactorcpp/example_4_ids.
3. Open file simplecppactorcpp_ex4_fc2k.xml.
4. You should see new parameter settings loaded into FC2K.

Image Removed Image Added
Fig. 1. FC2K main window: project simplecppactor cpp_ex4 loaded

6. Project settings

Please take a look at the project settings.

Image Removed Image Added
Fig. 2. FC2K arguments tab

Function arguments:

• input argument - CPO arrayIDS
• input argument - double
• output argument - double

Image Removed Image Added
Fig. 3. FC2K source tab

You should modify these setting, so they point to locations within you home directory. They will typically be as follows:

7. Actor generation

After all the settings are correct, you can generate actor
Simply press "Generate" button and wait till FC2K finishes the generation.

...

.

...

8. Confirm Kepler compilation

After actor is generated, FC2K offers to compile Kepler application. Make sure to compile it by pressing "Yes".

Image Removed Image Added
Fig.4. FC2K - successful compilation

9. You can now start Kepler and use generated actor

Open new terminal window and make sure that all environment settings are correctly set and execute Kepler.

shell> source $ITMSCRIPTDIR/ITMv1 kepler test 4.10b > /dev/null
kepler.sh

After Kepler is started, open example workflow from the following location

shell> $TUTORIAL_DIR/FC2K/simplecppactor/simplecppactorcpp/example_4_ids/cpp_ex4_workflow.xml

You should see similar workflow on screen.

Image Removed Image Added
Fig. 5. Kepler worflow loaded

10. Launch the workflow

You can start the workflow, by pressing "Play" button

Image Removed Image Added
Fig. 6. Workflow launch button

After workflow finishes it's execution, you should see result similar to one below:

Image Removed Image Added
Fig. 7. Outcome of the workflow execution

...

Exercise no. 4 finishes here.