IBM Experience Modeler - Theme Editor Installing Python Image Library

1. Presenter’s Name - Presenter’s Title DD Month Year IBM Experience Modeler - Theme EditorInstalling Python Image Library

2. Overview • Experience Modeler’s new Theme Editor is written in python and runs as an external application. • Separating the Theme Editor from the modeler enables changing the theme and Theme Editor without changes to the Modeler. • Theme Editor was written in python, a commonly use computer language and uses Tcl/Tk for GUI and requires python 2.7.x. Even though python 3.x is available, Tcl/Tk currently only works with v2.7.x which is standard on Max OS X. • You can confirm the presence and version of python on your Mac after opening a terminal window and entering the command: • python –version • Because the Theme Editor incorporates images for better presentation and understanding, you will also install the Python Image Library (PIL). 2

3. Installation • After confirming the presence of a compatible version of python, you will need to install the Python Image Library (PIL). • There are many ways to install PIL, but these will do a basic install using standard Mac tools. You can also install with MacPorts and Homebrew, although they install in locations unique to themselves. • Procedure: • Install Xcode from App Store – free • Install command line tools for Xcode • This include gcc the GNU c compiler • Install PIP – Package Installer for PHP • Install PIL – Python Image Library • That’s it 3

4. Open Apple’s App Store – Search for xcode 4

5. IBM Presentation Template Full Version From App Store - install Xcode Source: If applicable, describe source origin 5

6. Install additional Xcode components 6

7. Click “Install” button 7

8. 8

9. 9

10. 10

11. Launch Xcode and select Preferences 11

12. Click on Downloads icon, click “Command line tools”, Install. Normally appears here. Mine is already installed. 12

13. 13

14. 14

15. 15

16. 16

17. Python Image Library is now complete • Your Experience Modeler Theme Editor has the components necessary to run. 17

18. From the top menu, Run, select External Tools. On that menu, select External Tools Configuration Set up the Theme Editor in Experience Modeler

19. Click on the “New” icon

20. Configuring your first Theme Editor Enter a name using the pattern: project_theme_ThemeEditor On a Mac python install location is in “/usr/bin/python” Click on the Browse Workspace button to set the working directory

21. Select the ThemeEditor.py python script in the project and theme you want to edit. Navigate to the project > themes folder > Theme folder > Theme Editor folder Click on the Theme Editor folder On the right side, select the ThemeEditor folder

22. Complete configuration and Run the Theme Editor Working directory was set from browsing. Add Argument: ThemeEditor.py Click Apply Click Run

23. Creating subsequent Theme Editor activators After you create your first Theme Editor, you can easily duplicate a previous one and change the name and Working Directory. Open the Run > External Tools > External Tools Configuration dialog

24. Duplicate one of your Theme Editor Configurations Click on a previous Theme Editor Configuration, preferably one in the same project.

25. Modify setting for new Theme Editor Activator Change the name to reflect the project and theme Either browse to the project > themes folder > theme folder > Theme Editor folder or just modify the string for the Working Directory Location and Argument remain the same

26. Complete the configuration and Run the Theme Editor Click Apply and Run

27. Additional Information You can also review the video on YouTube for configuring the Theme Editor, although it is for Windows so the path to the python executable is different.