Show Notebook

Notebooks allow users to build additional data of their own choosing on top of any image or cropped element in the database. Updates to a notebook may only be made by the notebook's owner. However, users may view and even copy the notebooks of other DRA users. Images and cropped elements within notebooks have the same features as images within other DRA reports, including the opening of jumbo-sized images in new windows, display of element attributes when the mouse is paused over the 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 entry always begins by the user indicating that an image or cropped element is to be entered into the notebook. These are placed in the user's notebook from any DRA report function 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. The slow-click operation adds the image to the front of your notebook, the drag-click operation adds the image to the back.

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 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.

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

Notebook entries can be adversely affected by changes to the 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 of your choice, and Add and Cancel buttons.

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.

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.

attachment:ScreenShots/Notebook2.jpg

Once the above data design is complete, click the Submit button to save it. For the next step in this 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.

After several anthropomorphic elements with sackhats have been added, the contents of the notebook can be displayed by executing the Show 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

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 on the Show Notebook page are described below without example screenshots.

Browse

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.

Last Used

This replaces the Browse button when you view someone else's notebook. After clicking the Browse button, the drop down list will contain all notebooks (not just yours). Clicking this button changes the current notebook to the notebook you last used, and sets the drop down list to show only your notebooks.

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.

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 only your notebooks or all notebooks. You may change the current view just by selecting a different notebook and the page will automatically be refreshed. After clicking the Browse button all notebooks of all users will be listed in the drop down box. Upon initial entry or after clicking the Last Used button, only your notebooks will be displayed.

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. Images or elements may never be made into duplicate entries -- attempts to do so merely edit the original entry.

Here is a link up to DraTutorial and another to the AdminFunctions.

FootNote

Changing the Design

If you wish to change the notebook design and retain 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 the fields and not lose any existing data. 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.

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.