Exercise no. 4
C++ code within Kepler (CPO handling)
(approx. 30 min)
The knowledge gained:After this exercise you will:
- know how to prepare C++ codes for FC2K
- know how to prepare C++ library
- know how set up Makefile
- know how start and configure FC2K tool
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
You can find there various files. Pay particular attention to following ones:
- simplecppactor.cpp - C++ source code that will be executed from Kepler
- Makefile - makefile that allows to build library file
- simplecppactor_fc2k.xml - parameters for FC2K application (NOTE! this file contains my own settings, we will modify them during tutorial)
- simplecppactor_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
shell> source $ITMSCRIPTDIR/ITMv1 kepler test 4.10b > /dev/null
4. Start FC2K application
This is as simple as typing fc2k from terminal
shell> fc2k
After a while, you should see FC2K's main window.
Info |
---|
Default settings |
5. Open project simplecppactor
- Choose File -> Open
- Navigate to $TUTORIAL_DIR/FC2K/simplecppactor.
- Open file simplecppactor_fc2k.xml.
- You should see new parameter settings loaded into FC2K.
Fig. 1. FC2K main window: project simplecppactor loaded |
---|
6. Project settings
Please take a look at the project settings.
Fig. 2. FC2K arguments tab |
---|
Function arguments:
- input argument - CPO arrayequilibrium
- input argument - double
- output argument - double
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.
Info |
---|
Generating an actor for the second time |
8. Confirm Kepler compilation
After actor is generated, FC2K offers to compile Kepler application. Make sure to compile it by pressing "Yes".
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/simplecppactor_workflow.xml
You should see similar workflow on screen.
Fig. 5. Kepler worflow loaded |
---|
Launch the workflow
You can start the workflow, by pressing "Play" button
Fig. 6. Workflow launch button |
---|
After workflow finishes it's execution, you should see result similar to one below:
Fig. 7. Outcome of the workflow execution |
---|