Pedro Tutorials

Parts of a Pedro Window

Learn how to ...

The full screen

The Pedro GUI consists of three parts: the menu bar, the record tree, and the record form. Other lessons will go into greater detail about each feature but for now let us get a high level look. The main body of the application window is divided into two parts. The left part of the window is the record tree that lists records and subrecords in an experiment file. The right part shows a record form for the currently selected record in the tree.

In the directory, double click on the run_tutorial MS-DOS Batch File to start the tutorial example.

The Menu Bar

The menu bar is found at the top left of the Pedro GUI.

Below is a summary of the various feature within each menu item.

Feature Description
New causes a new blank Pedro window to appear.
Open... opens an experiment file.
Save saves any changes you've made to disk.
Save As... saves the data you have to disk, in a file with a name you specify.
Close closes the current file.
Import Records allows you to import the rows of a tab-delimited text file as subrecords for the current file.
Import from XML... allows you to import from an XML file.
Export to Final Submission Format... allows you to export the current file to different formats.
Templates a submenu that allows you to save or load reusable "chunks" of an experiment file. This feature is useful in situations where curators are using the same set of conditions over multiple experiment files.
Exit terminates the program.

Feature Description
Copy lets you copy one of two things to the clip board:
  • highlighted text from a text field in the record form;
  • the currently selected record and all its subrecords in the record tree.
Copied text can be pasted into applications such as Microsoft Word.
Paste lets you paste copied text into the data field that shows the flashing cursor. It also lets you paste the contents of a copied record into the current record form.

Feature Description
Show Errors shows errors in the current file. An error will either mean that some edit field in the current record is incorrect, or that some record in the record tree is missing a required subrecord.
Show Dependencies...
Show Changes shows changes you've made since the last time you saved your file to disk. Changed items in the record tree will appear either with a blue folder or a blue bullet.
Search... lets you search through the subrecords.
Clear clears all highlighting done by other features in the "View" menu.

Feature Description
Alerts... let's you validate your document by using additional checks made by other people

Feature Description
File: This window shows a list of the currently open files. Pressing a button in this menu will cause the window containing that file to appear in front of the others.

Feature Description
About... describes the team of people who made the software.
Schema Information... tells you the name and version of the schema currently being used by the application.
Help... takes you to the main help topic pages.
Enable context help toggles context-sensitive help. When this feature is ticked, you can move the mouse cursor around and click for help on any place where a question mark cursor appears.

The Record Tree

The tree allows you to navigate through all records of your form.

The Record Form

The record form shows the data fields for the currently selected record and a set of control buttons located in the bottom-right for saving, deleting and cancelling operations.

Form Fields

Required data fields appear in bold print while optional fields are in regular print. Fields can be directly editable or modified only by accessing subrecords or values linked to an ontology. A field that is has an associated ontology i s marked with a * character before it. All list fields have a "New" and "Edit" buttons that correspond to creating a subrecord and editing a subrecord respectively. Fields with enumerated values appear either as a pre-set list or as radio buttons. These kinds of fields do not have "New" or "Edit" buttons.

The appearance of list fields is effected by two factors:

List fields that can contain multiple subrecord types appear with a "Show:" label and a combination field with choices for subrecord type. The combination field value is used in two ways:

Control Buttons

A group of three buttons always appears in the bottom-right part of the record form. If they appear to be greyed out then this means that this particular feature is unavailable until some change is made to the form.

Feature Description
Keep saves the changes you've made to the currently displayed record and stores them in memory.
Cancel restores the last saved values of the data fields for the current record.
Delete deletes the record from the file.