Shortcut Navigation:

Using the Interactive Console

In this tutorial you will learn how to move comfortably in the interactive console of POY. To begin, open POY and from the Analyses menu select Run Interactive Console.

  1. A new terminal window should appear and POY should be running in it. If you are using Mac OS X or Linux, resize it to your preference. If you are in windows, unfortunately the terminal can not be resized.
  2. Now click anywhere in the terminal, and type the command  help (), then press enter.
  3. The interactive console is composed of four different frames. All the commands you type will appear in the interactive console frame.
  4. Now type the command,  report (data). You will see new information appearing in the output frame.
  5. If during an interactive session, you would like to repeat a previous command, press the combination keys Control-p (which we will from now and on represent as <C-p>). You will see that the last command  report (data) appears on screen. Using the arrows and the delete keys, modify that command into  report (treestats). Now press enter.
  6. A lot of text will have appeared in the output window. In order to scroll up, simply use the up and down arrow keys. The screen should move one line at a time, letting you see the contents of that frame.
  7. Scrolling line by line can take a long time, using the page-up and the page-down keys, the program will scroll up and down, one page at a time, in the output window.
  8. First use the <C-p> combination to go back to the  help () command. Then go back to  report (diagnosis) using <C-n>. <C-n> lets you go forward in your command history. Once in the  report (diagnosis) command, press enter.
  9. Typing commands can take a long time, and typos will lurk in. To avoid them, you can use the Tab key let POY autocomplete things for you. For example, type the following (every occurrence of <TAB> means ``press the tab key''):
                tra<TAB><TAB><TAB><TAB>(static_<TAB>)
    You will see how POY auto-completes the commands, and cycles on all possible matches when more than one possible command is found. The program will also autocomplete filenames for you.
  10. Finally, if in the following tutorials, you want to cancel a command that is being executed, simply press <C-c> (Control-c). That will roll back the program to the previous interactive state (i.e. the last time you pressed the <ENTER>).

We are ready to work with actual data. You can get it here.

American Museum of Natural History

Central Park West at 79th Street
New York, NY 10024-5192
Phone: 212-769-5100

Open daily from 10 am - 5:45 pm
except on Thanksgiving and Christmas
Maps and Directions