Back to JANUS Applications

1.0 Sample Application

The Sample application consists of functions that are related to sample activities. Sample functions include entering and editing data that pertains to samples taken from retrieved cores and the generation of sample labels. Sample functions require that the leg, site, hole, core, and section data already exist in the database.

To access the ODP - Sample Applications window, select the Sample option from the Applications menu of the Ocean Drilling Program - Janus window.

ODP - Sample Application Window

1.1 File

The File option for Sample is:

1.1.1 Exit Sample

When you select this option, you exit Sample and return to the Ocean Drilling Program - Janus window.

1.2 Input/Edit

The Input/Edit menu options facilitate the entering, editing, and viewing of sample data:

1.2.1 Input Sample Data (Sample Input Window -- sam05)

The Sample Input window provides a method to enter core samples by section half and identify them by region. To open the window, select the Input Sample Data option from the Input/Edit menu of the ODP - Sample Application window.

Sample Input Window

When the window opens, the current Leg number is at the top, and the Site, Hole, Core, and Core Type fields are blank. The Entered By field is blank but the choice box contains valid user names. The list box is blank.

NOTE: This window is for data entry only. Editing of sample data must be done in the Edit Sample window. (See Section 1.2.2.)

To enter samples, you must enter the Site, Hole, Core, and Core Type for the samples. (You can enter these manually or by scanning the bar code label on the D-tube of the sample section). If the LSHC/CT combination you entered is not valid, an alert message appears when you attempt to save the data entered below.

You can modify the list box table so that only certain fields or columns are active for data entry. For instance, you may not wish to include subpiece data and comments for the samples you are entering. Do this by clicking on the tab stop arrows at the top of the columns you wish to deactivate. This action turns the column from gray or green to white (read-only) so that data cannot be entered in them. The Piece, SP, and Beaker ID columns are deactivated by default when the window opens.

Before you enter any new data, the DB Changes Pending indicator in the bottom right corner is bright green and state "No DB Changes Pending". As soon as you enter new data, the indicator turns red and states, "DB Changes Pending". This indicator is to remind you to save new data before you close or before you load the list box with data from a template.

HINT: When entering data, navigation from cell to cell in the Sample Input window list box is different from most of the list boxes elsewhere in the Janus System. You must always double-click in the first field to place the cursor there for data entry. After you type a value into a cell, you must hit the Enter key or the Tab key to enter that value into the cell and move into to the next field. Note that it is important that you always hit the Tab or Enter key out of the last column before you save. Otherwise, that value is not entered into that column.

HINT: Iif you enter an invalid value, the value turns blue after you tab to the next field. At the same time, a message appears in the status bar at the bottom that tells you the entry is invalid.

Buttons

NOTE: If you have entered any data improperly, a validation error appears when you click on the Save/Clear button and the Correct Sample Record window appears and contains a list of the reason(s) why the entry is invalid. Use this window to make corrections.. (See Section 1.2.1.1.)

1.2.1.1 Correct Sample Record (Window sam03)

The Correct Sample Record window alerts you that you entered one or more invalid values in either the Sample Input or Sample Edit window. It tells you that the system cannot execute the save action until you make acceptable changes to this incorrect value. The window appears when you click on either the Save/Hold or Save/Clear button and the system detects an invalid value.

Correct Sample Record Window

When the window opens, the data fields at the top contain the same values in the row of the Sample Input or Sample Edit window that has the invalid data. Below this a panel appears listing one or more of the reasons why the system found the record invalid. These possible reasons are:

 

Buttons

 

1.2.1.2 Edit Col (Sample Table Edit Column Window -- sam10)

The Sample Table Edit Column window provides you with a shortcut for editing data that was entered in the Sample Input or Sample Edit windows. It allows you to do global changes on selected rows of a column or an entire column in the sample table (i.e., if you need to change sample code in multiple rows or all rows). To open the window, click on the Edit Col button in either window.

Sample Table Edit Column Window

Highlight the rows in the Sample Input or Sample Edit window that contain the data you wish to edit. Click on the button to bring up the Sample Table Edit Columns window. When it opens, all the fields are blank.

Buttons

1.2.1.3 Sample Templates (Window sam06)

The Sample Template window allows you to save and retrieve templates of sample data. Use of templates can make the entry of repetitive sample data quicker and easier. If you enter multiple samples with the same sample code and section number, for instance, you do not need to enter this data each time. You only need to change values in the columns that are different. When you retrieve a template, the template data fills the list box in the Sample Input window, starting at the first available row.

To open the Sample Templates window, click on the Sample Templates button in the Sample Input window.

Sample Template Window

Templates consist of a template name, author, description, and rows of sample input data. When the window opens, the list box contains this information for all templates in the database.

When you click on the New button to create a new template, a panel appears in which to enter identifying data for the template.

HINT: You can append a series of several different templates to the Sample Input window.

Sample Template Window with New Template Panel Activated

Buttons

1.2.2 Edit Sample Data

Scientists can use the Edit Sample Data option to view or edit their own sample data. Curators can use it to view or edit all samples entered by all scientists. Therefore, when you select the Edit Sample Data option, a log in window appears in which to log in either as a scientist or a curator. You must log in before you can begin to edit samples.

1.2.2.1 Sample Login (Window sam07)

When you select the Edit Sample Data option, the Sample Login window appears. The window provides a path for curators and scientists to edit existing core samples in the Sample Edit window.

Sample Login Window

When you log in as a scientist, the Sample Edit window appears and gives you access only to sample data for the last core that you entered. When you log in as a curator, the system gives you global edit capability for all samples from all Site/Holes that exist in the database. The Sample Filter window also appears.

Buttons

 

 

1.2.2.2 Sample Filter (Window sam01)

If you are a curator and have correctly logged on, the window called Sample Filter appears. The window acts as a mechanism for you to search the database and select samples to edit in the Sample Edit window

Sample Filter Window

When the window opens, all fields are blank. To search for specific samples, enter the required filter values which are Leg, Site, Hole, Core, and Core Type. An entry in the optional Top field, accompanied by the required fields, causes the system to search the database for all sample Top values equal to or greater than the Top value that you entered. An entry in the optional Bottom field, accompanied by the required fields, causes the system to search the database for all sample Bottom values equal to or less than the Bottom value you entered. In both cases, additional filtering may be accomplished by entering Sample Code, Section, and Section Half.

Buttons

1.2.2.3 Sample Edit (Window sam04)

The Sample Edit window is used to view or edit previously entered sample data. Scientists gain access to the window directly through the Sample Login window (see Section 1.2.2.1) and certain features are unavailable to them. Curators gain access after logging and then selecting the data they wish to edit in the Sample Filter window (see Section 1.2.2.2). They have global access to all data.

Sample Edit Window (Scientist) - The Query function is not available.

 

Sample Edit Window (Curator)

The list box in the window is a duplicate of the list box in the Sample Input window. All of the widgets are also the same except that the Sample Template button does not appear in this window. The window contains a Query button, but is active only when the user is a curator.

When a scientist logs in to the window, the values default to the most recent LSHC combination of sample data entered by that scientist. NOTE: This is the only set of data accessible to a scientist through this window. When a curator logs in to the window, it opens with all fields loaded with the data relevant to the LSHC/CT selected by the curator in the Sample Filter window.

You can modify the list box table so that only certain fields or columns are active by clicking on the tab stop arrows at the top of the columns you wish to deactivate.

Before you enter any new data, the DB Changes Pending indicator in the bottom right corner is bright green and states "No DB Changes Pending". As soon as you enter new data, the indicator turns red and states, "DB Changes Pending". This indicator is to remind you to save new data before you close or before you load the list box with new data.

HINT: If you enter an invalid value, the value turns blue after you tab to the next field. At the same time, a message appears in the status bar at the bottom that tells you the entry is invalid.

HINT: Nnavigation from cell to cell in the Sample Edit window list box is different from most of the list boxes elsewhere in the Janus System. You must always double-click in the first field to place the cursor there for data entry. After you type a value into a cell, you must hit the Enter key, NOT the tab key to enter that value into the cell and move into to the next field.

Buttons

NOTE: Again, if you have entered any data improperly, a validation error appears when you click on the Save/Clear button and the Correct Sample Record window appears and contain a list of the reasons why the entry is invalid. Use this window to make the corrections.. (See Section 1.2.1.1.)

1.3 Output/Reports

The Output/Reports menu options access a variety of reports related to samples:

1.3.1 Labels (Print Labels Window - sam02)

The purpose of the Print Labels window is to select a sample or group of samples and print bar code labels and/or tracking sheets for them. To open the window, select the Labels option from the Output/Reports menu.

Print Labels Window

When the window opens, the current Leg appears at the top and the Site, Hole, Core, and Sections fields are blank. Use this area of the window to retrieve the sample data for which you wish to print bar code labels and tracking reports. You may enter the data manually in these fields or scan the bar code label on the section or sample.

 

Buttons

 

1.3.1.1 Requirements for Printing Bar Codes

In order to print bar codes, your computer must satisfy the following conditions:

  1. Your platform must be a PC;
  2. You must have the Bartender program installed in directory C:\BTW;
  3. A directory called C:\ODP\Janus\Label must exist;
  4. The appropriate .btw file must exist in C:\ODP\Janus\Lib.

1.3.2 Samples by Site (Window sam09)

The Samples by Site/Hole window provides a method to print a hard copy report of or view all samples taken from all of the cores from a specified Site/Hole. To open the window, select the Samples by Site option from the Output/Reports menu.

Samples by Site/Hole Window

When the window opens, the Select Leg, Site, Hole panel contains the current Leg, Site, and Hole identifiers. (Leg is read-only). The list box contains the data for this LSH. You can query the database for sample data for another site/hole.

NOTE: Most Janus reports were created with an independent application called Business Objects. These reports are listed and defined in Appendix D - Business Object Reports of the Functional Specifications.

Buttons

 

 

1.3.3 Pick List (Report Pick List -- Window par06)

The Report Pick List window is used to select and view reports for each application. Access the window by selecting the Pick List option from the Output/Reports menu.

Report Pick List Window

When the window opens, the category selected in the Filter panel defaults to Sample. The list box contains the names of all Sample-related reports. The panel at the bottom shows a brief description of the information in the highlighted report. You can see a list of reports for another application by selecting that application in the Filter panel.

NOTE: Most Janus reports were created with an independent application called Business Objects. These reports are listed and defined in Appendix D - Business Object Reports of the Functional Specifications.

Buttons

 

1.3.4 Barcode List (Sample Barcode List -- Window xry16)

The Sample Barcode List window allows you to print a list of the barcodes for a particular set of sample codes. Open the window by selecting the Barcode List option in the Output/Reports menu. You can also access the window through the Ocean Drilling Program - Janus window in the Preferences menu and the ODP - Xray Application window in the Tech Support menu. NOTE: In order for the barcode list window to work properly, the Bartender format file, xraylist.btw, needs to be in the janus/lib directory. See the Janus Maintenance Manual for details.

Sample Barcode List Window

To print a barcode list, enter the Leg, Site, Hole, Core and Core Type (core and core type are optional) for the samples and then list the sample codes. You can also scan a barcode label. Click on the Print button to print the list.

You can use this list to scan barcodes anywhere in Janus that a barcode entry is required.

Buttons

1.3.5 Barcode Translator (Barcode Translator -- Window par09)

The Barcode Translator window is used to translate a barcode into its corresponding identifiers. You can also translate a set of identifiers into the corresponding barcode. Open the window by selecting the Barcode Translator option in the Tech Support menu. You can also access the window through the Ocean Drilling Program - Janus window in the Preferences menu and the ODP - Xray Application window in the Tech Support menu.

Barcode Translator Window

When the window opens, it is blank. To translate a barcode into the corresponding idenfiers (leg, site, hole, core, etc.), scan the barcode or manually enter it into the Barcode field. Click on the >> button. The system loads the identifiers for that barcode into the ODP Identifiers panel. If the barcode was from a sample, the Sample radio button is selected. If it was from a section, the Section radio button is selected.

To translate a set of identifiers to the corresponding barcode, enter the identifiers into the fields in the ODP Identifiers panel. Select the Sample or Section radio button and click on the << button. The system displays the barcode in the Barcode field.

Buttons

Back to JANUS Applications