TableOfContents

Show Notebook

Overview

Notebooks allow users to collect images and cropped elements from any survey and optionally record comments and additional data related to the image or cropped element. Updates to a notebook may only be made by the notebook's owner. However, users may view and copy the notebooks of other users. Images and cropped elements within notebooks have the same features as images within other reports, including the opening of jumbo-sized images in new windows, display of element attributes when the mouse is paused over a cropped element, and hyperlinks to cluster and panel detail.

Each user may have up to 100 notebooks and each notebook can have an unlimited number of entries. A new notebook is created by clicking the New button and optionally entering a name and defining data fields.

The size of images and cropped elements and the number of images displayed per page are determined by the users settings in UserPreferences. If you have a slow internet connection and have a low quality setting to improve response time, you may collect interesting images or cropped elements in your notebook, change your Image Preferences, and view your notebook images at higher quality (after waiting patiently for the downloads to complete), and then change your Image Preferences back to your normal setting.

Designing a Notebook

Your first notebook is created for you automatically when you access the Show Notebook function or add your first image to your default notebook. The default notebook's name is No Name. To change the notebook name or add additional data collection fields to all entries of a notebook, click the Design button. Clicking the New button will create an additional notebook and proceed to this same design page.

attachment:ScreenShots/Notebook1.jpg

After clicking the Design button you are presented with a a page showing a small text area with the current notebook name and a larger text area labeled Define each data field... To change the notebook name, just type in the new name and click the Submit button.

To add additional fields for data collection to this notebook, you only need to define the label for the field and the type of field your wish to generate.

There are four possible types of field definitions for your notebooks:

• Checkbox - begins with a label and ends with an *

• Text or numeric entry - begins with a label and ends with a #

• Calculation - begins with a label, has an =, ends with a algebraic calculation

• Heading - has only a label or phrase used to delineate groups of data fields

The example below establishes some additional detail to be gathered for anthropomorphic elements with sackhats. There will be 3 check boxes generated and two fields for text or numeric data entry where the length of the sackhat and the length of the body may be entered. The DRA application will calculate and display the resulting ratio per the formula entered. Note that because the length labels have embedded blanks, the blanks must be replaced by underscore _ characters in the formula. The check boxes and numeric data will be highlighted with headings of Checkbox Attributes and Measurements. If you use check boxes, be sure to group them under headings because unchecked boxes are not displayed on the ShowNotebook pages.

attachment:ScreenShots/Notebook2.jpg

Once the data design is complete, click the Submit button to save it.

Adding an Image or Cropped Element to Your Notebook

A new notebook entry begins by indicating that an image or cropped element is to be entered into the notebook. This is done by performing a slow-click or a drag-click operation. To perform a slow-click, move the mouse pointer over any image, press the left mouse button, hold down for one second and release.

A drag-click is performed by holding the mouse pointer near the target image, pressing the left mouse button, moving the mouse pointer over the image while holding the button down, and releasing the button.

For simple notebooks with no defined data fields, the slow-click operation adds the image to the front of your notebook, the drag-click operation adds the image to the back. For notebooks with data fields defined, entries are always presented sorted by data values.

Both of slow-click and drag-click operations are intended to work only on images displayed by research functions, and will not work on images displayed by most recording functions. "Adding" an image from within the Notebook function itself allows you to update the comment or data associated with the image.

Notebook entries can be adversely affected by changes to a survey. Should an image or element be deleted by the owner of the survey, viewers of the notebook will see a text message describing the former contents.

When a slow-click or drag-click operation is performed on an image, a small pop up window will appear. The pop-up window will contain the image or element to be added to your notebook, a drop down box containing a list of all your notebooks with the last-used notebook selected, a text area for a comment, optional data fields as previously defined, and Add and Cancel buttons.

For example, the user could find all the anthropomorphic elements in the database by performing a SearchByAttributes. Any of the elements displayed as a result of the search may be individually added to the notebook by performing a slow-click or drag-click as discussed above. Doing either will open a new window. In the example below, comments and data have already been entered FootNote(For this example, the ratio of hat to body is deemed the important measure so the length measurements can be taken directly from the image):

attachment:ScreenShots/Notebook3.jpg

When the Add button is clicked, the window will briefly display an acknowledgement message and then close automatically. If there are no data fields defined, the sequence of your notebook will be determined by the order of entry and whether the image or element was added by a slow-click or drag-click as described above. If there are data fields defined, the sequence of the notebook is determined by the value of the data fields. For check boxes, unchecked boxes have a lower value than checked boxes.

Sample Display of a Notebook

After several anthropomorphic elements with sackhats have been added, the contents of the notebook can be displayed by executing the Notebook function again. Note the calculated field is shown with a value of Error for the third element because no data values were entered (Not a sackhat was also checked).

attachment:ScreenShots/Notebook4.jpg

Downloading Data from a Notebook

The data values entered into a notebook can be downloaded in CSV (Comma Separated Values) format. The CSV format is widely supported by spreadsheet programs such as Microsoft Excel, Microsoft Works, and Lotus 123. To download, click the Download button and another new window will open:

attachment:ScreenShots/Notebook5.jpg

To save the data to your hard drive, right-click the download button and choose Save as... to initiate a file dialog. Depending upon your browser setting, left-clicking may initiate the same file dialog or may open your default spreadsheet program within the browser window.

If you save the file to your hard drive and then open the saved file with a spreadsheet program such as Microsoft Excel, you can view the contents or perform additional analysis. Note the leftmost columns are not visible below, these contain site, date, category, and cluster information. The panel letter and element number are shown below, and you can see the data has been sorted into sequence by the values beginning with column I.

attachment:ScreenShots/Notebook6.jpg

Other Buttons

Other buttons on the Show Notebook page are described below without example screenshots.

All Notebooks

Displays a list of all notebooks without identifying the owner's name. All notebooks are public and you are free to peek at the notebooks of other users. A user ID number is displayed and your ID number appears enclosed by * characters.

My Notebooks

This button appears when you view someone else's notebook. Clicking this button changes the current notebook to the notebook you last used.

New

Creates a new notebook and opens the Design page so you can name the notebook and enter data fields if desired.

Copy

Creates a copy of the notebook you are currently viewing, either yours or someone else's. You may copy the notebooks of other users and build additional data on top of their work.

Delete

Presents a warning page requesting an acknowledgement that you intend to delete the notebook. Clicking delete a second time deletes the entire notebook. Deleting your last notebook will create an empty "No Name" notebook.

Sort

Presents a page with a choice of fields. Click on a field to sort all notebook entries by the field value. If the field chosen is not the first, a comment related to the sort sequence will be displayed on all subsequent pages.

Remove All

Removes all the entries from the notebook, but retains the design values. A warning message is presented on the first click of this button, a second click is required before all entries are erased.

Submit

Refreshes the page after deleting any entries checked for deletion.

Drop Down Box

This is a list of all your notebooks. You may change the current view just by selecting a different notebook and the page will automatically be refreshed. When viewing someone else's notebook, the drop down box is replaced by the name of the notebook. Click the My Notebooks button to view your last-used notebook.

Note that you can update an entry in your notebook by performing a slow-click or drag-click on the image within the notebook page. After an update, you must click the Submit button to refresh the page and view the updated values. Images or elements may never be made into duplicate entries -- attempts to do so merely edit the original entry.

FootNote

Changing the Design

It is best to test and critique your notebook design with small amounts of data. If you make any changes to the design of a large notebook (other than deleting fields) you must re-add every element to update the changed fields.

If you wish to change the notebook design and retain any existing data, a good starting point is to make a copy of the notebook.

When changing the design of a notebook, you may change the positions of fields (under the same heading) and not lose any existing data. You may also change the positions of whole groups of fields, where a group is all the fields under a single heading. However, any change to the spelling of the field label, the type of field (*, #, or =) or the formula appearing after an = operand will result in null values being set for the field for all existing notebook entries. Changing the spelling of a heading results in null values for all fields under the heading.

Calculation fields are calculated when a new entry is made to the notebook. Therefore, if you add a new calculation based upon existing fields, its value will be null. Re-adding each existing entry without changing any values will trigger the calculation.

Calculation Fields

Calculation are evaluated after all other data fields are entered and may appear before their dependent data fields. This may be useful when you wish to sort entries based upon a calculated value.

You may not use a calculated value to calculate another value.

You may multiply strings by numbers. For example, the following will is acceptable:

Stars #
Star Rating = '*' * Stars

@@ To do:

• a merge capability for notebooks with identical data fields? base level of statistics, frequency counts and %, mean, mode, std deviation?

[http:WikiTutorial http:/wikidata/Graduation.gif] You have completed the DigitalRockArt tutorial. If you want to learn how to edit wiki pages, proceed to the WikiTutorial.