Transcript
HYLARSMET WRC project K5/2024 1 st PyTOPKAPI workshop Prof. Geoff Pegram Dr. Scott Sinclair 13 February 2012 The purpose of this document is to provide a tutorial introduction on the use of PyTOP-KAPI, a BSD licensed Python library implementing the TOPKAPI Hydrological model(Liu and Todini, 2002).The tutorial session is meant to be hands-on and it’s expected that the workshop par-ticipants follow all of the examples on their own computers. Each participant has beenprovided with a bootable USB flash drive containing a customized live install of UbuntuLinux. This will ensure that everyone has an identical computing environment duringthe tutorial. 1 Introduction to the working environment In the first part of the tutorial, we’ll develop some basic familiarity with the customizedUbuntu Linux environment that you’ll be using to run the PyTOPKAPI model. Themodel can also run on many other computer operating systems including Microsoft Win-dows and Apple Mac. Our primary method of interaction will be via the command lineas this provides a powerful and repeatable way of generating model results, that can alsobe scripted to avoid manually performing the same procedures when multiple model runsare required.Fig. 1: The Ubuntu Linux desktop as it appears after booting the computer using thelive USB. The application launcher appears on the left side of the screen.1 Fig. 2: Clicking on the icon at the top of the launcher opens the system dashboard, whichcan be used to search for applications.Fig. 3: Typing terminal into the search bar shows a selection of terminal applicationsinstalled on the system. Click on the Terminal icon to start a Terminal instance.2 Fig. 4: We are going to launch an interactive Python environment called IPython fromthe terminal. You’ll see the advantages of IPython later on, for now it isn’t necessary tounderstand the command entered in the terminal, it’s sufficient to type it in and press Enter on your keyboard.Fig. 5: The IPython console application. Once this window has appeared, you canminimize the terminal window to clear screen clutter. We’ll develop familiarity with thethe scientific python workflow using IPython in the next section.3
