P4 Help


Add to my manuals
153 Pages

advertisement

P4 Help | Manualzz

P4 Help

P4 Version:1.17 - Published: 8/3/2017

Table of Contents

Welcome to P4

...................................................................................................................

4

New Features in P4

.............................................................................................................

5

Event Types

...................................................................................................................

7

Dates and Times in P4

.....................................................................................................

8

Dockable Panels

.............................................................................................................

10

Contact PTAGIS

.................................................................................................................

11

Dashboard

.........................................................................................................................

12

Notifications

.......................................................................................................................

14

Configure

...........................................................................................................................

15

Configuration Tools

.........................................................................................................

16

Profiles

......................................................................................................................

18

General Settings

......................................................................................................

20

Active Peripheral Devices

.........................................................................................

22

Default Property Values for New Sessions

...................................................................

23

Active Tag Actions

...................................................................................................

25

Validation Constraints

..............................................................................................

26

Audible Alerts

.........................................................................................................

27

Filtered Validation Codes

.........................................................................................

29

Repeating Values

........................................................................................................

30

Data Entry Layouts

......................................................................................................

32

Tag Actions

................................................................................................................

35

Tag Lists

....................................................................................................................

37

Peripheral Devices

......................................................................................................

39

PIT Tag Readers

.....................................................................................................

40

Input Devices

..........................................................................................................

42

Digitizer Tablets

......................................................................................................

44

Digitizer Maps

............................................................................................................

45

Calibrate Digitizer Map

.............................................................................................

47

Digitizer Command Types

.........................................................................................

49

Project Defined Fields

..................................................................................................

51

Custom Validation

.......................................................................................................

53

Validation Codes

............................................................................................................

55

Add/Edit User Defined Capture Method

..........................................................................

57

Add/Edit User Defined Conditional Flag

..........................................................................

58

Add/Edit User Defined Hatchery

....................................................................................

59

Add/Edit User Defined MRR Site

...................................................................................

60

Add/Edit User Defined Organization

...............................................................................

61

Add/Edit User Defined SRR Verbose

.............................................................................

62

Add/Edit User Defined Tag Coordinator

..........................................................................

63

Add/Edit User Defined Tag Mask

...................................................................................

64

Add/Edit User Defined Tagging Method

..........................................................................

65

Import Configuration Dashboard

........................................................................................

66

Import Configuration

.....................................................................................................

67

Export Configuration

........................................................................................................

69

Collect

...............................................................................................................................

71

New Session

..................................................................................................................

72

Open Session

.................................................................................................................

74

Data Entry

......................................................................................................................

75

Output Panel

...............................................................................................................

77

Statistics Panel

...........................................................................................................

78

2 of 134

Tag Code Buffer Panel

.................................................................................................

79

Session Properties Panel

.............................................................................................

80

Update Session Properties

.......................................................................................

81

Current Record Values Panel

........................................................................................

82

Batch Update

..............................................................................................................

83

Tool Bar

.....................................................................................................................

84

Keyboard Shortcuts

.................................................................................................

86

Import Data

....................................................................................................................

87

Import P3 or P4 Files

...................................................................................................

88

Windows Virtual Store

..............................................................................................

89

Import Delimited Files

..................................................................................................

90

Download Reader Files

................................................................................................

92

Import Reader Files

.....................................................................................................

94

Import Data Preview

....................................................................................................

96

Manage

.............................................................................................................................

97

Session Management

......................................................................................................

99

Validation Results Summary

..........................................................................................

101

Upload Sessions to PTAGIS

.........................................................................................

103

Join Sessions

.............................................................................................................

104

Duplicate Records

.......................................................................................................

105

Record Management

.......................................................................................................

107

Validation Results

........................................................................................................

110

Find and Replace

........................................................................................................

112

Fill Records

................................................................................................................

114

Adjust Dates

...............................................................................................................

115

Query Management

.........................................................................................................

116

Filter Editor

................................................................................................................

119

Group Summary Editor

.................................................................................................

121

Update Query Results

..................................................................................................

122

Dot Out Records

.............................................................................................................

123

Update From Session

......................................................................................................

125

Database Log

................................................................................................................

127

Utilities

..........................................................................................................................

128

Send Database to PTAGIS

...........................................................................................

130

Validation

..........................................................................................................................

131

Index................................................................................................................................................. 132

Appendix A - MRR Field Definitions and Requirements................................................................... 135

3 of 134

Welcome to P4

P4 is the data entry and management tool developed by PTAGIS for the collection and submission of PIT tag mark/recapture/recovery (MRR) data in the Columbia River basin.

4 of 134

New Features in P4

New MRR Dataset

PTAGIS has implemented a new MRR (mark/recapture/recovery) dataset model for P4 that allows each individual record in a Session to have different values for most of the standard PTAGIS fields. Session fields that must be the same for all records include File, Project Code, Session Message, and Session Note. Every other field can have a different value in each record in a Session.

Several new fields, such as Life Stage, Latitude/Longitude, Coded Wire Tag (and other types of tags), have also been added to the dataset. Please see the MRR Field Definitions and Requirements for a complete list of the session and record data fields available in P4 and the requirements for those fields.

In addition to the new fields, two fields that were available in P3, but never loaded into the database, will now be loaded into PTAGIS and be made available through the reporting system: Session Note and Detail Note.

Explicit Event Types

One of the new data fields in P4 is called Event Type and it is required to be completed for all records. This

field is used to specify the type of data collection event that generated the record. The possible Event Types are Mark, Recapture, Recovery, Passive Recapture or Tally.

Explicit Date Time Values

PTAGIS expected that all date/time values submitted in P3 data were entered in Pacific Standard Time, which is the PTAGIS standard for timestamps. P4 uses a more precise data structure such that the value always unambiguously identifies a single point in time regardless of the local time zone or if Daylight Saving Time is in effect. All times in P4 will be entered and displayed in local time as indicated by the field computer's system settings, but stored with the time zone offset. This will allow PTAGIS to display all timestamps in Pacific

Standard Time in the reporting system.

Please see the

Dates and Times in P4 topic for more information.

Data Entry Features

For those that don’t need to have unique information for each record, there are tools available to fill in the fields

that will have the same values across all records. Repeating Values allow you to set the values that will go in

each record as it is created, or can be used to complete information post-data collection.

The Data Entry Form in P4 can be customized by creating a custom

Data Entry Layout . Fields can be added

or removed to the data entry form and/or rearranged as needed.

Customizable User Interface

Different themes can be applied to P4 to change the colors of backgrounds, text, and other user interface

elements. Data Entry, Record Management, and Query all support dockable panels , which allows the elements

to be minimized, closed, and rearranged to suit your requirements.

Project Defined Fields

While P3 included a single field (Additional Positional) that could be used for storing project specific data, P4 allows the creation of up to 10 session-level and 10 record-level

Project Defined Fields . These fields will not be

loaded into PTAGIS, and will only be available in the P4 installation in which they are created. If multiple computers need to use the same fields, they can be exported to a file which can be imported into other entered into them.

While P3 included a single field (Additional Positional) that could be used for storing project specific data, P4 allows the creation of up to 10 session-level and 10 record-level Project Defined Fields . These fields will not be loaded into PTAGIS, and will only be available in the P4 installation in which they are created. If multiple computers need to use the same fields, they can be

exported to a file which can be

imported into other

computers. Project defined fields include a field definition and method for restricting the type of data that can be entered into them.

Enhanced Validation Tools

P4 includes powerful real-time validation which always runs in the background while data is being collected to

check the validity of tag codes and ensure the minimum required fields are being completed. This standard

real-time validation can be augmented by the user by setting up customizable Validation Constraints based on

species-run-rear type.

Post-data collection validation

has been enhanced significantly in P4. Whenever a Session is validated, field requirements and domain limits will be checked. Any validation failures will be reported in detail to allow the user to more easily locate and correct potential errors.

Custom Validation routines can also be created by the

user to enhance the standard PTAGIS validation checks.

Data Management Tools

Robust data management tools are available in P4 for post-data collection editing. Most of these are available

in Record Management , where Sessions can be opened into a tabular view and records can be edited

individually or in groups. Some of the editing tools available in Record Management are

Find and Replace ,

Fill

Records

, Adjust Date/Time

, and

Dot Out Records

.

There are also tools for editing records across multiple Sessions, though these should be used with caution. It is possible to

dot out records across Sessions using a tag list ,

update records across Sessions using the values in a different Session , and

update records across Sessions that are the result of a Query . Before

performing large editing tasks such as these, you may want to backup the P4 database so that it can be restored in the case of any mistakes.

In addition to the powerful editing tools, P4 includes a flexible

Query tool that allows complex queries of all data

in the P4 database to be constructed and saved for future use. The query results can be exported to Excel or delimited file formats.

6 of 134

Event Types

The Event Type field must be completed for each record in a session and is required to be completed during data entry before the record can be saved. Records with different Event Types have different requirements for what makes a complete record. Please see the MRR Field Definitions and Requirements table for a complete list of P4 data fields and their requirements by each Event Type. Alternatively, you can view the requirements for each event type by following the hyperlinks in the table below.

Mark

Recapture

Recovery

Passive Recapture

Tally

The event during which a fish is initially marked with a PIT tag and released (or planned to be released). Only one mark event is allowed for each PIT tag code. If additional mark events are submitted for the same PIT tag code, they will be categorized as Mark Duplicates during the loading process.

The event during which a previously PIT-tagged fish is recaptured, scanned by hand, handled and released (or planned to be released). Multiple recapture events are allowed for each PIT tag code as long as the Event Dates are different. If an additional recapture is reported with the same Event Date of a previously reported recapture for the same tag, it will be categorized as a Recapture Duplicate during the loading process..

The event during which a previously released PIT tag is recovered from or detected in a dead fish, or is recovered or detected as a bare tag, or is removed from the possibility of being recaptured or detected in the future. Multiple recovery events are allowed for each PIT tag code as some PIT tags, while obviously no longer in a living fish, may be detected multiple times without a physical recovery

(e.g. carcass surveys, avian nesting sites). A recovery event that is reported for the same PIT tag with the same Event Date as a previously reported recovery event will be classified as a Recovery Duplicate during the loading process.

The event during which a previously PIT-tagged fish is detected by unattended or remotely operated detection equipment at a location other than an interrogation site and is not handled. It differs from a Recapture event in that the fish is not handled, only detected. It differs from an interrogation record in that the detection occurs opportunistically in a location that is not a registered interrogation site. Multiple passive recapture events are allowed for each PIT tag code as long as the Event

Dates are not the same.

The event during which an un-tagged fish is sampled or counted without being marked with a PIT tag. Tally events must have 10 dots as the PIT tag code and will be ignored when submitted to PTAGIS for loading.

7 of 134

Dates and Times in P4

An example of how the date time offset values are stored is below:

2016-09-20T17:00:00-07:00

The date is in YYYY-MM-DD format and is separated from the time by the letter T. The time is in 24 hour format and is followed by the time zone offset value. Here the offset is -07:00, which indicates that it is 7 hours behind

Coordinated Universal Time (UTC), and was collected in either Pacific Daylight Time or Mountain Standard

Time.

Time zone offset values in the Columbia Basin region are:

Time Zone Name

Pacific Standard Time

Pacific Daylight Time

Mountain Standard Time

Mountain Daylight Time

Abbreviation Offset

PST

PDT

MST

MDT

-08:00

-07:00

-07:00

-06:00

All timestamps entered and displayed within P4 use this date time offset structure to promote more accurate reporting of when a certain event occurred regardless of where. A user in the field can simply enter the local date and time into P4 and not have to think about the local time zone or if Daylight Savings is in effect.

Timestamps can be automatically input during data entry with the local system time if enabled in the Repeating

Values feature. Regardless, these local timestamps will eventually be converted to Pacific Standard Time

(PST) when P4 data is submitted to PTAGIS as is standard for reporting.

The convenience of using the date time offset to store local timestamps can present some complications because P4 displays them relative to the current system time zone settings which may be different from when the data was first collected. For example, a field user in an eastern county within Idaho enters an Event Date for a mark record with a local timestamp of 2016-11-01T13:00:00-06:00 which represents Mountain

Daylight Time (MDT). P4 displays the local time of this event as 11/01/2016 13:00:00. Viewing this Event

Date a month later when the same system is now operating under Mountain Standard Time (MST) P4 will display it as 11/01/2016 12:00:00. This relative time shift is also observed when exporting and importing sessions between different P4 instances running on computers operating under different time zones. The original timestamps are preserved using the date time offset structure but appear to be different local times when viewed simultaneously on two computers operating under different time zones.

The

Record Management feature allows users to optionally display event/release dates standardized to PST if

the local time is not desired. The

Query feature standardizes and displays all dates as PST to allow filtering of

these values across sessions that have timestamps collected under different time zones. The column header indicates where a date/time value is displayed in local or PST as shown below:

8 of 134

NOTE: it is recognized that not all research can or needs to capture and report timestamps accurate to the hour, minute or second. In this case, enter a time value of 12:00:00 (noon) and not 00:00:00 (midnight) to prevent time zone adjustments from impacting the correct date value.

9 of 134

Dockable Panels

Dockable panels can be moved or un-docked by clicking and dragging on the panel title bar. When a panel is dragged in this way, docking elements will appear (two are highlighted in yellow in the screenshot below).

These are used to specify where to dock the panel. Panels can also be left undocked, in which case they will float over the other elements on the screen, unpinned or closed.

10 of 134

Contact PTAGIS

For questions or comments, please feel free to contact us using one of the options below:

P4 Web Page

Email Support

503-595-3100

11 of 134

Dashboard

This is the P4 home screen and contains navigation tiles that are grouped into three main feature categories:

Collect, Manage, and Configure. In the top-right corner is an application-wide tool bar with buttons to access the help system, to view PTAGIS contact information, to change display themes, and to view notifications.

Version

Displays the installed version of P4

Notifications

Used to display notifications from PTAGIS. The number next to the flag indicates the number of notification messages present.

not been dismissed.

A red flag indicates that there is at least one high priority notification that has

A black flag indicates that there are regular notifications that have not been dismissed.

A white flag indicates that there are no notifications.

Theme Changer

Used to select the display theme. Different themes use different background and text colors. Those with the word Touch in the name are intended to be used with Windows tablet devices.

12 of 134

Contact PTAGIS

Used to display methods for contacting PTAGIS for support with using P4.

Help

Used to open the help system.

Collect

Contains features related to collecting and importing PIT tag data.

Manage

Contains features related to managing and submitting data to PTAGIS along with database and layout utilities.

Configure

Contains features related to setting up P4 and transferring those settings to other computers.

13 of 134

Notifications

When P4 is running on a computer that is connected to the internet, it has the capability to receive notifications from PTAGIS. These notifications will be used to let P4 users know when a new version is available, and may be used to disseminate other information that would be useful to the community. Notifications in red indicate a high priority message that should be acted upon when it is received. Messages will remain in the notification window until dismissed. Once a message has been dismissed, it will disappear from this window and cannot be viewed again.

14 of 134

Configure

Although P4 can be used without configuration tools, for the most part, creating them allows P4 to be tailored to specific project needs and will increase data collection efficiency and accuracy. To make this easier, an Import feature is available to transfer settings from P3 and P4, as well as an Export feature to transfer setting to other

P4 installations.

If you moving from P3 to P4, we recommend importing the profiles, templates and digitizer maps used in P3 to get a head start on configuring P4.

Configuration Tools

Used to set up tools that define how P4 operates and connects to devices.

Validation Codes

Used to view and download PTAGIS validation codes, and to add custom codes.

Import Configuration

Used to import configuration settings from P3 database files and P4 configuration files.

Export Configuration

Used to export P4 configuration files for transfer to a different computer.

15 of 134

Configuration Tools

Using the tools located in this section, P4 can be customized to suit many different data collection scenarios.

Profiles

A Profile specifies which configuration tools and defaults to use during a data collection session (e.g. peripheral devices, default values, tag actions, validation constraints, audible alerts, duplicate record handling, auto accept, tag mask validation).

Repeating Values

Similar to templates and repeating comments in P3, Repeating Values contain values that are automatically entered into new records during data collection. They can also be used for post-data collection editing.

Data Entry Layouts

Data Entry Layouts are used to customize the data entry screen by adding, removing, and/or rearranging fields on the data entry form.

Tag Actions

Tag Actions are used to configure P4 to perform an action when specific tags are scanned during data entry. The action can include displaying a message and/or entering values into the current record.

Tag Lists

Tag Lists contain tag codes and are used with Tag Actions and Dot Out Records

. They can be created by importing text files, downloading from a reader device, from sessions and from queries.

16 of 134

Peripheral Devices

Used to configure and test P4 connections to peripheral devices (readers, balances, digitizer tablets).

Digitizer Maps

Used to create and maintain digitizer tablet command maps for data entry.

Project-Defined Fields

Project-Defined Fields are used to collect project-specific data that is outside the scope of PTAGIS.

Values entered into project-defined fields are not loaded into PTAGIS, but are stored in and can be exported from P4 along with the standard PTAGIS fields.

Custom Validation

Used to create custom validation rules to perform extra error checking on data before submission to

PTAGIS.

New

Used to create a new configuration tool of the same type as the active tab.

Edit

Used to edit the selected configuration tool on the active tab. Tools can also be opened for editing by double-clicking.

Copy

Used to copy the selected configuration tool on the active tab and open it for editing.

Delete

Used to delete the selected configuration tool on the active tab. A selected tool can also be deleted by pressing the Delete key on the keyboard. If the selected tool is a component of another tool, it cannot be deleted until the dependent tool is edited or deleted.

17 of 134

Profiles

It is recommended that a Profile be set up to tailor P4 to the specific needs of the project. If peripheral devices will be used with P4, creating a Profile is required.

General Settings

Specify profile name, duplicate record handling, auto accept mode, reject record confirmation, and

Genetic ID/Scale ID increment settings.

Default Property Values for New Sessions

Specify default values and session properties to use when a new session is created with this profile.

Active Tag Actions

Enable the tag actions to use during a data collection session.

Validation Constraints

Specify real-time validation constraints to use during a data collection session.

Audible Alerts

Enable audible alerts to sound during specific data collection events.

18 of 134

Filtered Validation Codes

Specify a subset of validation codes to use during data entry.

Active Peripheral Devices

Select the peripheral devices to use during a data collection session.

Digitizer Settings

Select the digitizer tablet, map, and nose stop to use during data entry, if applicable.

19 of 134

General Settings

Profile Name

Specify a name for this profile.

Created

Date the profile was created.

Modified

Date the profile was last modified.

Handle Mark Duplicates

Specify what P4 should do when a duplicate record is entered during data collection.

·

·

·

·

·

Accept: automatically accept the duplicate record

Dot Out: automatically dot out the duplicate record, leaving the original record as is

Reject: automatically reject the duplicate record

Replace: automatically replace the original record with the data collected in the duplicate record

(the data entry form will scroll back to the location of the original record)

Prompt: prompt the user to select one of the four above options

Auto Accept Mode

This setting is only useful if you are using a PIT tag reader to scan tag codes directly into P4.

When enabled (On), the current record will be automatically accepted when a new PIT tag is scanned, as long as the minimum required fields (PIT Tag, SRR Code, and Event Type) are completed. If they

are not completed, the newly scanned code will be placed in the P4 Tag Code Buffer

.

When disabled (Off), the current record must be manually accepted before a new tag is scanned. If a new tag is scanned before the current record is accepted, the newly scanned code will be placed in

the P4 Tag Code Buffer

.

20 of 134

Tag Mask Validation

When enabled (On), PIT tag codes will be checked against the PTAGIS list of known tag masks. If the tag mask (e.g.3D9.1C2C) is not on that list, a warning message will be displayed. A record with an unknown tag mask can still be entered into P4 and submitted to PTAGIS, however the file will be loaded with Provisional status and the record will not be available in the reporting system . See this

PTAGIS news item for more information about tag mask validation.

Confirm Reject Record

When enabled (On), user will be prompted to confirm whenever the a new record is Rejected during data entry.

Increment Genetic ID

When enabled the Genetic ID field will be incremented by one for each new record created during data entry. User must enter the first Genetic ID value, and the incremented value can be overwritten at any time in the case of a break in the sequence.

Increment Scale ID

When enabled the Scale ID field will be incremented by one for each new record created during data entry. User must enter the first Scale ID value, and the incremented value can be overwritten at any time in the case of a break in the sequence.

21 of 134

Active Peripheral Devices

New in version 1.15: Multiple peripheral devices of each type, except Digitizer Tablet, can be used during

data collection. Also See the Peripheral Devices

topic for more information.

Select Reader/Input Devices

Select one or more reader devices to enable scanning PIT tags directly into P4 during data entry.

Select one or more input devices (such as a digital balance) to enable sending values directly to P4 during data entry.

Digitizer Settings

To enable data entry and length measurements using a digitizer tablet, select the previously configured device and map here. To measure fish larger than the available area on the digitizer tablet, set up a physical nose stop off the digitizer tablet and enter the distance in millimeters to the 0 line on the digitizer ruler.

22 of 134

Default Property Values for New Sessions

This section of the Profile is used to specify the default values to enter when a new Session is created in data entry or by importing data. Session properties, such Repeating Values, Data Entry Layout and the folder in which to save the Session can also be specified.

Project Code

Select the default MRR Project code (this used to be known as the Coordinator ID) to use for new

Sessions. A Session can only contain data from one MRR project.

File UDF

Enter 1 to 3 characters to use by default as the User Defined Field (UDF) portion of the P4 File name.

Every session that is created with this profile will use this same UDF in the file name, which could lead to multiple sessions with the same file name if they are created on the same day.

If this field is left blank, the UDF portion of the file name will be incremented for each new session created on the same day.

Session Message

Enter the default Session Message to use for new sessions. The Session Message is a brief description of the purpose and/or scope of the tagging project and is a required field in P4.

Session Note

Enter the default Session Note to use for new sessions. Session Note is a large comment field that can be used to record ad hoc information about the tag session as a whole.

New in P4: this field is now loaded into the PTAGIS database and will be available through the reporting system.

Folder

Select the default P4 folder in which the session will be saved. This can be changed before the session is created and while the session is open for data collection.

23 of 134

Repeating Values

Select the default set of Repeating Values

to use when a new session is created. This can be changed before the session is created and while the session is open for data collection.

Data Entry Layout

Select the default Data Entry Layout

to use when a new session is created. This can be changed before the session is created and while the session is open for data collection.

Project Defined Session Field Defaults

Enter default values for any session level Project Defined Fields

that have been created. For the sample profile shown here, two session-level project defined fields have been created: Weather and

RPM.

24 of 134

Active Tag Actions

Enable or disable the

Tag Actions to use during data collection for the sessions that are associated with this

profile. To enable, check the box in the Enabled column. Tag actions can be edited from this screen by double-clicking on the tag action Name.

25 of 134

Validation Constraints

Validation constraints are values that are checked in real-time during data entry. Specify minimum and maximum values for length, weight, and/or condition factor, per species/run/rear type. You may specify a value for one or all of the possible constraint fields. If a value is entered for that species during data entry which is outside the specified range, a warning will be displayed to the user; data entry can proceed after the dialog is acknowledged.

Species Run Rear Type Warning

When enabled (On), a warning will be displayed if a species/run/rear type value is selected during data entry that is not in this table.

Min/Max Length

Enter values for minimum and/or maximum fork length in millimeters. If a value above the maximum or below the minimum is entered for a record with the specified Species/Run/Rear Type during data entry, the user will be warned when the record is Accepted. The user can choose to Accept the record as is, or go back and enter a different value.

Min/Max Weight

Enter values for minimum and/or maximum weight in grams. If a value above the maximum or below the minimum is entered for a record with the specified Species/Run/Rear Type during data entry, the user will be warned when the record is Accepted. The user can choose to Accept the record as is, or go back and enter a different value.

Min/Max Condition Factor

Enter values for minimum and/or maximum condition factor. Condition factor is calculated automatically using the length and weight values entered in the current record, and should only be used when both values will be collected for each fish. If the calculated condition factor is above the maximum or below the minimum for a record with the specified Species/Run/Rear Type during data entry, the user will be warned when the record is Accepted. The user can choose to Accept the record as is, or go back and enter a different length and/or weight value.

The formula used to calculate condition factor is:

(Weight÷Length 3 ) × (10 5 )

Warn on Empty Length/Weight

Check the appropriate box to warn the user if a record is Accepted with an empty length or weight. The user can choose to Accept the record as is, or go back and enter a value into the field that is empty.

26 of 134

Audible Alerts

Enable or disable audible alerts to play a sound when specific actions are detected during data collection. P4 installs with a default sound for each of these alerts, but any WAV file located on the local hard drive of the computer can be selected instead of the default sound.

Accept Record

Plays when the current record is accepted.

Action Event

Plays when a Tag Action

has been initiated.

Constraint Violation

Plays when a Validation Constraint

is violated.

Duplicate Tag

Plays when a duplicate record is encountered.

Error

Plays when any error occurs.

External Command

Plays when an external command is received from a digitizer tablet or other data entry device.

Length Input

Plays when length is entered via digitizer tablet or other device.

Reject Record

Plays when a record is rejected.

Tag Buffered

Plays when a tag is scanned before the current record is accepted, placing the newly scanned tag code in the data entry buffer.

27 of 134

Tag Code Input

Plays when a tag is scanned and entered into the current record.

Weight Input

Plays when weight is entered into the current record via balance or other device.

28 of 134

Filtered Validation Codes

Validation code lists can now be filtered to show only a subset of values during data entry. To filter a set of validation codes, such as SRR Code, check the codes that should be visible to the user during data entry. The list of codes shown to the user during data entry will include all codes selected in this section of the profile, plus any additional codes already contained within the session or within the set of Repeating Values attached to that session.

For example, if a Session is opened using the settings below, but it already contains some records with a species code of 00U, the drop down list for the SRR Code field will include 00U, 11H, 11U, and 11W.

29 of 134

Repeating Values

Each record in a Session may now have its own value for most of the standard PTAGIS data fields. Repeating

Values can be used to specify the default values to enter into the fields that will have the same value across all records in a Session.They can be used during data collection, when importing data from a CSV file or reader, or post-data collection.

Sort by Category

Click this icon to group and sort the list of fields by the following categories:

·

·

·

·

·

·

Event Detail: Fields that were included in the Detail part of a P3 record.

Event Header: Fields that were included in the Header part of a P3 record.

Location: Latitude, longitude, and lat/long source for the location of the event. For Mark and

Recapture events location is associated with the Release Site; for Passive Recapture and

Recovery events, location is associated with the Event Site.

Release Information: Fields specifying the release date, site, temperature and river kilometer extension.

Other Marks: Fields for specifying other mark identifiers.

Project Defined: Project defined fields that have been created in this installation of P4.

Sort Alphabetically

Click this icon to sort the list of fields alphabetically instead of grouping them into categories.

30 of 134

Use System Timestamp for Event Date

When enabled, the computer's date and time will be entered into the Event Date field during data entry.

New in P4:

dates and times in P4

are time zone aware, so the computer can remain set to the local time zone and use Daylight Saving Time. When data from P4 is loaded into PTAGIS, all times will be converted to Pacific Standard Time.

Use System Timestamp for Release Date

When enabled, the computer's date and time will be entered into the Release Date field during data entry.

Use Reader GPS for Lat/Long

When enabled, latitude and longitude coordinates will be used for the location fields if you are using a

GPS enabled reader and no coordinate values have already been entered into the current record by

Repeating Value or keyboard.

31 of 134

Data Entry Layouts

Newly available in P4, the data entry form can be customized for each specific project and data collection scenario. Fields can be added, removed and rearranged as needed. Similar to P3, the data entry form will scale to fit based upon the layout, screen resolution and available space.

Layout Name

Specify the name of the data entry layout.

Font Size

Specify the font size to use for values entered into the data entry layout.

Customization

When enabled, the form is editable - fields can be added/removed/edited.

Initial Field

Specify the field which should receive focus after a PIT tag is scanned.

Sample Data

When set to Show, this switch will populate the data entry layout form with sample data to show what it will look like with values entered into the fields.

32 of 134

Add Fields to Form

Hover over this menu icon to see a list of fields that are available to add to the form. To add a field, drag it from the list and drop it into the desired location on the form.

Resize Field

To specify a fixed field width or height, click on the border of a field and drag it to the desired measurement. If a width or height is set using this method, the field will not grow to fit to the contents entered into it.

Width

These controls specify the horizontal alignment of the field on the form. The top three buttons will set the alignment to Left, Center, and Right, respectively. The bottom button will set the field to justify with other fields on the form, and will also allow the field to grow to fit the contents entered into it.

Height

These controls specify the vertical alignment of the field on the form. The three buttons on the left will set the alignment to Top, Center, and Bottom, respectively. The bottom button will set the field to justify with other fields on the form, and will also allow the field to grow to fit the contents entered into it.

Move Field

This button will move the selected field up or down on the data entry layout form.

Delete Field

This button will remove the selected field from the data entry layout form.

Change Field Label

This button allows the field label to be changed. It does not change the label anywhere else in P4, it only affects the label on the data entry layout form.

Group Fields

This button temporarily groups two or more fields so they can be moved as a unit using the Move Field button.

33 of 134

Group Fields

This button temporarily groups two or more fields so they can be moved as a unit using the Move Field button.

34 of 134

Tag Actions

Tag Actions can be used during data entry to:

·

filter out (ignore) test tags

·

·

notify the tagger when a specific tag code is encountered

notify the tagger when an unexpected tag code is encountered

Multiple tag actions can be enabled for a Session during data entry. In addition, Tag Actions can automatically enter or update values in the current record when fired.

Tag Lists or saved

Queries

can be used to specify the tag codes to be used in the Tag Action. Multiple Tag

Lists and/or Queries can be used in one Tag Action. If a Query is used in a Tag Action, it is run when the

Session is first opened and the resulting set of tags at that time is used.

35 of 134

Activation

Select the type of activation for this Tag Action:

·

Inclusive: Activates if the scanned tag IS included in the associated Tag Lists. Use this activation type to be notified and/or automatically enter values when specific tags are encountered during a data collection session.

·

Exclusive: Activates if the scanned tag IS NOT included in the associated Tag Lists. Use this activation type to be notified and/or automatically enter values if a tag is scanned that is not expected, indicating a mis-read or a recapture of a fish previously tagged by other researchers, for example.

·

Filter: Activates if the scanned tag IS included in the associated Tag Lists. This is different from the

Inclusive action in that it ignores the tag and does not create a record for it. Use this activation type to ignore test tags that are used to test reader operation.

Prompt

Enter the message to be displayed when the Tag Action is activated. If left blank, the tag action will be

activated silently and no message box will be displayed. A log entry will be recorded in the Output panel

when a Tag Action is fired.

Tag Lists

Select one or more Tag Lists

to use for this Tag Action.

Field Values

Specify values to be automatically entered into the current record when the Tag Action is activated. For example, you may set up a Tag Action change the Event Type value to Recapture when fish that were released upstream for trap efficiency trials are encountered.

Profiles

Use this tab to enable the Tag Action in one or more Profiles. Tag Actions can also be

enabled/disabled in the Active Tag Actions

section of the Profile.

36 of 134

Tag Lists

Tag Lists are static sets of PIT tag codes that can be associated with Tag Actions

and used in other data management features. They can be created from Sessions, Queries, text files, and

imported from peripheral reader devices

.

Append from Sessions

Select one or more sessions to add tag codes from.

Append from Queries

Select one or more saved queries to add tag codes from. Tag Lists can also be created from within

Query Management

.

Append from File

Select a file on the local computer to add tag codes from.

Clear All

Delete all tags from the list.

37 of 134

Other Commands

Keyboard commands can also be used to edit individual tag codes in this tag list.

·

·

·

·

CTRL-F: Search the Tag List for a partial or whole tag code

CTRL-C: Copy selected tag code(s)

CTRL-V: Paste one or more tag codes into the list

DEL: Delete selected tag code(s) from the list

38 of 134

Peripheral Devices

Peripheral devices can be configured to send data directly to P4 during data entry to eliminate the need to enter values by hand. In addition PIT tag readers can download stored tag codes and timestamps from internal memory into a new session.

Peripherals are configured by device and connection type:

Device Type

Reader (Serial)

Reader (HPR USB)

Digitizer (Serial)

Digitizer (USB)

Input Device (Serial)

Generic (Serial)

Description

This should be used for any reader that communicates through a hardware or virtual serial port. This would include the Destron-Fearing FS1001F, the Biomark

HPR connected via Bluetooth, and the Biomark 601.

This should be used only with the Biomark HPR reader when it is connected as a

native HID or USB device. No other native USB readers are compatible with P4 at this time.

This should be used for any digitizer tablet that communicates through a hardware or virtual serial port without a WinTab driver.

This should be used for any digitizer tablet that uses a native USB connection, or that uses a serial port with a WinTab driver.

This should be used for any device that communicates through a hardware or virtual serial port. This would include devices such as electronic balances or

calipers. Any device that can send a value via serial port can be configured to send that value to a field in P4.

This device type was developed to emulate a digitizer tablet to control and enter data into P4. If you have developed or are interested in developing a custom control device, contact PTAGIS for more information.

39 of 134

PIT Tag Readers

Name

Specify a name to distinguish the reader from other devices or readers in P4.

Serial Port Name

If applicable, specify the COM port through which the reader will be connecting. If using the HPR in native USB mode, this is not necessary and will not be available.

40 of 134

Serial Connection Settings

Select from the list of predefined connection settings for devices with serial connections. To specify custom settings, click the edit button (pencil icon) to open the Customize Serial Connection Settings dialog and specify the baud rate, parity, data bits, stop bits, handshake, and RTS signal.

Timestamp Format

Specify the format in which the reader stores the timestamp. If the reader does not store a timestamp, select None.

Serial Start-Up Command

This setting is used to specify a command to be sent to the device when P4 connects to it. For example, if you want to send a command to a Destron-Fearing 2001F reader to start scanning when a session is opened, then enter ra1 in this field.

Test Terminal

To test that communication settings are correct for the reader, slide the Connection switch to the On position, then either send a command or scan a tag code. Check the Raw Data window to see the data as it is received by P4. Check the Captured Data window to verify that P4 correctly parses the tag code, timestamp, and lat/long coordinates (if applicable).

41 of 134

Input Devices

For P4 to correctly parse weight values from a balance, the device must be configured to send values in grams, with 1 digit after the decimal point, and the unit identifier (g) included.

Name

Specify a name to distinguish the device from other devices and readers in P4.

Serial Port Name

Specify the COM port through which the device will be communicating with P4.

42 of 134

Serial Connection Settings

Select from the list of predefined connection settings for devices with serial connections. To specify custom settings, click the edit button (pencil icon) to open the Customize Serial Connection Settings dialog and specify the baud rate, parity, data bits, stop bits, handshake, and RTS signal.

Input Type

If the device is a balance, select Weight. If the device is a caliper or some other device that sends a length measurement, select Length. If it is any other type of device, select General, and the value sent from the device will be captured by P4 as is.

Input Field

Select the field into which the capture data from the device should be entered.

Serial Start-Up Command

Enter a command to send to the device when the port is opened to begin communications with P4.

Test Terminal

To test that communication settings are correct for the device, slide the Connection switch to the On position, then either send a command to the device that will return output, or cause the device to send a value to the computer. Check the Raw Data window to see the data sent from the device as it is received by P4. Check the Captured Data window to verify that P4 parses the data correctly.

43 of 134

Digitizer Tablets

Name

Specify a name to distinguish the digitizer tablet from other devices in P4.

Coordinate Transmit Mode

Specify the coordinate transmit mode as Point or Continuous. If coordinates stream continuously in the Raw Data terminal window when the digitizer pen is near or on the tablet surface, then select

Continuous. If coordinates only appear in the Raw Data terminal window when the pen is clicked on tablet, select Point.

Test Terminal

To test that communication settings are correct for the tablet, slide the Connection switch to the On position, then click the digitizer pen anywhere on the surface of the tablet. If one X/Y coordinate appears in the Captured Data terminal window for each click, then it is configured correctly.

44 of 134

Digitizer Maps

Create digitizer maps in order to use a digitizer tablet in place of a mouse and keyboard during data entry.

Available Commands

This list contains the digitizer commands

that can be placed on a digitizer map. Drag a command from this list to a cell on the map to add that command to the map. Identical commands placed in adjacent squares will automatically merge to create a larger command area.

Merge Down

Used to merge the currently selected map cell with the cell immediately below.

Merge Right

Used to merge the currently selected map cell with the cell immediately to the right.

Clear

Used to clear the cell of all command and property details.

UnMerge

Used to un-merge a merged cell.

Default Font

Used to change the font type, weight, and size for all cells on the map. Once set, new cells will be created with these default font settings.

45 of 134

Map Name and Grid Size

Specify the name of the map and the number of cells in both rows and columns.

Print Settings

Enter width and height in millimeters to specify the size of the printed map. Click the Print button to see a print preview, select a printer, and print a hard copy of the map.

Calibrate and Test

After the map has been printed and attached to the digitizer tablet, along with the ruler, it needs to be calibrated before it can be used. Connect the digitizer to the computer, and click this button to open the

Calibrate and Test

dialog. The dialog helps to align the map on the digitizer tablet's active area, and determines the correct divisor to use for length measurements.

Command Details

Use this panel to specify what the command should do, which field it targets (if applicable) and how it looks on the printed map.

·

Background: Select the background color for the command square.

·

·

Description: Specify the text to display on the command square.

Font: Select the font style for the command square text.

·

·

·

·

Font Size: Enter the font size for the command square text.

Font Weight: Select the font weight for the command square text.

Foreground: Select the color for the command square text.

Command Type

: Select the type of command to perform when the command square is tapped during data entry. Depending on the command type, you may need to specify additional details, such as field and value and whether to append or overwrite values.

46 of 134

Calibrate Digitizer Map

After the digitizer map and ruler have been attached to the digitizer tablet, use this dialog to calibrate and test them. The digitizer tablet must be powered on and connected to P4.

After selecting the correct digitizer tablet, the dialog will first ask for the coordinates of the bottom-left corner of the digitizer map. Tap this corner with the stylus, and then do the same for the upper-right corner when prompted. This action tells P4 where the map is located on the digitizer tablet, as well as its exact size.

Next, the dialog will ask for the X coordinate of the 5cm line on the ruler, followed by the 15cm line. From those two locations, P4 will determine ruler-zero and the correct divisor to use for accurate length measurements.

Ruler-zero can be anywhere on the digitizer tablet's active area (it does not need to be at the very edge of the active area).

Finally, use the Test Output section to confirm the map and ruler are properly calibrated.

Digitizer Tablet

Select the digitizer tablet device which will be used with this map. It must be powered on, connected to the computer, and correctly configured in P4 in order to continue.

47 of 134

Bottom Left Coordinates

Use the stylus to tap the location of the bottom left corner of the digitizer map.

Top Right Coordinates

Use the stylus to tap the location of the top right corner of the digitizer map.

Ruler 5cm Coordinate

Use the stylus to tap the location of the 5cm line on the ruler.

Ruler 15cm Coordinate

Use the stylus to tap the location of the 15cm line on the ruler. Once both the 5 and 15 cm marks have been mapped, P4 will automatically calculate the correct divisor to use when determining length.

Test Output

After the four sets of coordinates have been specified, use this area to test the map and ruler output.

Tapping on the ruler will display the length that will be sent to P4. Tapping on a command square will display the command that will be sent to P4.

48 of 134

Digitizer Command Types

Command Name

OK

Accept

Cancel

Reject

Replace Duplicate

Tag

First

Previous

Next

Last

New

Next Buffered Tag

Clear Tag Buffer

Dot PIT Tag

Undo Dot PIT Tag

Toggle Nose Stop

Toggle Panel

Peripheral

Select Repeating

Toggle Repeating

Apply Repeating

Select & Apply

Repeating

Use Current as

Repeating

Clear Temporary

Repeating

Definition

Click OK button on dialog forms

Parameters

None

Accept the current record and save it to the database

Click Cancel button on dialog forms

Reject the current record reverting any changes that have been made

Replace the previous record with the current record's values. Will scroll the data entry form back to the previous record that is being replaced

Go to the first record in the session

Go to the previous record

None

None

None

None

Go to the Next record in the session

Go to the Last record in the session

Create and go to a new record

Create a new record using the next tag in the P4 data entry tag buffer

Delete all tags from the P4 data entry tag buffer

None

None

None

None

None

None

None

Dot out the PIT tag code in the current record None

Restore the PIT tag code if it has been dotted-out and the record has not yet been Accepted.

Click to disable or enable nose stop for measuring fish fork length. The nose stop is set in the profile that is currently active for the open tag session.

Click to show/hide a panel in the data entry screen

None

None

Send a command to a connected peripheral device

Select the panel to toggle

Select the device type and enter the command to send

Select a saved Repeating Value to use with the open session. The values will be applied to the next new record.

Click to temporarily disable or enable the selected

Repeating Value. A disabled Repeating Value is not applied to new records.

Select the name of the saved Repeating

Value

None

Applies the active Repeating Value to the current record. None

Select a saved Repeating Value set to use for the open session, and apply those values to the current record.

Select the name of the saved Repeating

Value set

Set the values in the current record to a temporary

Repeating Value that will only be in use while the current session is open.

None

None session and go back to using the Repeating Value set that was in use when the session was opened.

Select & Apply

Repeating

Use Current as

Repeating

Clear Temporary

Repeating

Set Field

Clear Field

Set Multiple Fields

Tally

Export Session

Select a saved Repeating Value set to use for the open session, and apply those values to the current record.

Select the name of the saved Repeating

Value set

Set the values in the current record to a temporary

Repeating Value that will only be in use while the current session is open.

None

None Clear the temporary Repeating Value set from the open session and go back to using the Repeating Value set that was in use when the session was opened.

Set a field value in the current record.

Clear a field value in the current record.

Select the field and value to set

Select the field to clear

Set multiple field values in the current record.

Select or enter the values to be set in each field. Check the box if the values should be appended rather than overwrite existing values.

None Sets the PIT tag code field to 10-dots (dot-out) and

Event Type field to Tally

Exports the current Session to the folder specified in

Utilities.

None

50 of 134

Project Defined Fields

Configure both session and detail fields to be used for project specific data. User can specify a field definition and a mask for the appropriate data type. Data entered into these fields will be exported into P4 data files, but will not be loaded into the PTAGIS database. Data can be exported to CSV or Excel files along with regular P4 data fields.

Scope

Select the scope of the field - session or detail. Session-level fields allow entry of one value per session. Detail-level fields allow entry of one value per record.

Field Label

Enter the label to display for this field.

Field Definition

Enter the definition for this field.

Database Column

Select the database column to use for this field. By default the next available column will be selected.

Session-level fields use database columns named SPDV1-SPDV10. Detail-level fields use

PDV1-PDV10.

51 of 134

Edit Mask

Enter a regular expression to control the data entry mask for the field; or edit one of the predefined masks.

Predefined Masks

Select a mask to control data entry options for this field. The regular expression from the selected mask can be edited to suit specific needs.

Test Input

Used to test the regular expression data entry mask.

52 of 134

Custom Validation

Define custom validation rules to perform extra error checking on data before submission to PTAGIS. For example, a validation rule can look for records where the SRR Code has a rear type of Wild and the

Conditional Comments field contains a flag code for adipose clip (AD). Any records that meet these criteria will be marked and displayed to the user for further review prior to submission to PTAGIS.

Enabled

When enabled (On), the custom validation rule will be checked whenever one or more sessions are

validated in Session Management

or Record Management.

Result Type

Select the type of validation result to report when the criteria in the Validation Editor are true:

·

·

Error: If a session has a validation error, it cannot be submitted to PTAGIS. Select this result type if records that fail this rule should not be submitted to PTAGIS.

Warning: If a session has a validation warning, the user is notified about the condition, but the session can still be submitted to PTAGIS. Select this result type if records that fail this rule can be submitted to PTAGIS.

53 of 134

Prompt

Enter the text to display for each record that fails this validation rule.

Field to Correct

Select the field that should be highlighted in Record Management for each record that fails this validation rule.

Validation Editor

Add the validation criteria here. Records will be identified with the selected Result Type and Prompt

when these criteria evaluate to true. See the Filter Editor

for more information about how to build the validation criteria.

54 of 134

Validation Codes

Many fields in PTAGIS are limited to a controlled set of values called Validation Codes, and those codes are appended to as the need arises. To keep P4's copy of the Validation Codes current, it is necessary to update them by either downloading them directly from P4 or by importing them from a file.

User-defined Validation Codes can be added to P4 if a new code has been requested but has not yet been implemented by PTAGIS, or if P4 is used to collect data that will not be submitted to PTAGIS. Sessions which contain records with user defined validation codes cannot be submitted to PTAGIS. An exception is made for

Sessions with tally records, which are ignored by PTAGIS.

Type of Code

Select the type of Validation Code to the list of values:

·

·

·

·

·

·

·

·

·

Capture Method

Conditional Comments

Hatchery

MRR Site (used for both Event Site and Release Site)

Organization

SRR Verbose

Project Code

Tag Mask

Mark Method

55 of 134

Modified Date

Displays the last modified date of the Validation Codes that are in the local P4 database.

Download

Click this button to download the most recent set of validation codes from PTAGIS. Access to the internet is required for this feature.

Import from File

Click this button to import a file containing the PTAGIS validation codes, which can be downloaded from the P4 page . This feature can be used to update validation codes on remote computers with no internet access.

Export to File

Export the local copy of validation codes to a file. This can be used to export custom validation codes along with the standard PTAGIS validation codes for use in another installation of P4.

Add User Defined Code

Click this button to add a custom code of the type that is selected in the Type of Code list. Custom validation codes are available to select during data entry or editing, however data with custom codes cannot be submitted to PTAGIS, with one exception: Tally records can use custom SRR codes.

Edit User Defined Code

Click this button to edit the description of the selected custom validation code. The code itself cannot be edited. If the code needs to be changed, it is recommended that you add the new code first, use the

Update Query Results

feature to change all existing records from the old code value to the new code value, and then delete the old code.

Delete User Defined Code

Click this button to delete the selected custom validation code.

Deleting a custom code will also remove it from any records where it has been selected as a value.

56 of 134

Add/Edit User Defined Capture Method

Capture method codes are used to record the method by which the fish were captured.

Code

A custom Capture Method code can be up to 6 characters long.

Description

Enter the description for the custom Capture Method code.

57 of 134

Add/Edit User Defined Conditional Flag

Flag codes are used to record fish condition and other key criteria in the Conditional Comments field.

Code

Custom conditional flag codes can be a maximum of 2 characters.

Description

Enter the description of the custom flag code here.

58 of 134

Add/Edit User Defined Hatchery

Hatchery codes are used to record the hatchery where the fish were reared.

Code

A custom hatchery code can be a maximum of 4 characters.

Description

Enter the description or name for the custom hatchery code.

59 of 134

Add/Edit User Defined MRR Site

MRR Site codes are used to record where fish are tagged, released, recaptured, or recovered. They can be used in both the Event Site and Release Site fields, and consist of point locations and stream (or stream segment) locations. If a MRR site will be used as a release location, it also needs to have a Release River KM value associated with it.

Site Code

The Site Code can be a maximum of 6 characters.

Site Name

Enter a name for the site here (maximum 125 characters).

Release Site

If the MRR site will be use as a Release Site, check this box. If it will only be used as a mark site, leave it unchecked.

Release River KM

Enter the kilometers from the mouth of the Columbia River to the location of the site according to the

Release River KM standards.

Point Release Site

If the MRR site is a point release check this box, if it is a stream site, leave it unchecked.

60 of 134

Add/Edit User Defined Organization

Organization codes are used to record the entity responsible for data collection.

Code

A custom organization code can be a maximum of 6 characters.

Description

Enter the name of the custom organization here.

61 of 134

Add/Edit User Defined SRR Verbose

SRR verbose codes are used to record the species, run, and rear type of the fish.

Code

Select from a list of commonly used species codes or enter a completely new code to use as a custom SRR Code.

Description

Enter the name of the species represented by the custom SRR Code.

62 of 134

Add/Edit User Defined Tag Coordinator

Tag coordinator codes represent the person or long-term project (MRR Project) responsible for the tagging operation, data collection and data management.

Code

The Tag Coordinator code, now referred to as the MRR Project Code, has a maximum length of three characters.

Description

Enter the name of the tagging project here.

63 of 134

Add/Edit User Defined Tag Mask

Tag Mask codes are used to check that the PIT tag code being entered is valid and a tag known to be used in the Columbia River basin. If you are tagging outside the CRB, or are using tags that are new to the CRB, you may need to add custom tag masks. You may also considering

turning tag mask validation off in the profile you

plan to use when tagging. If you plan to submit these records to PTAGIS in the future, you will need to request that any custom codes also be added to the PTAGIS set of validation codes.

Code

The tag mask code consists of the 3-character manufacturer code, a period, and the next four characters.

Description

Enter the name of the tag manufacturer here.

64 of 134

Add/Edit User Defined Tagging Method

Tagging Method codes are used to record the method used to inject PIT tags into the fish. If the record event type is not Mark, then the tagging method should be recorded as None.

Code

The Tagging Method code can be a maximum of four characters long.

Description

Enter a description of the new tagging method.

65 of 134

Import Configuration Dashboard

Configuration settings can be imported from both P3 and P4. After selecting one or more files to import, the configuration tools available for import will be displayed along with the possible import actions (e.g. import as new tool, update an existing tool, or use the existing tool as is).

Import P3 Configuration

When moving from P3 to P4, many of the P3 configuration settings can be imported directly from the P3.mdb database file. They will likely need to be edited before using P4.

Configuration settings that can be imported from P3 include:

·

Profiles

·

·

·

·

·

Templates (will be imported as P4 Repeating Values)

Default Repeating Comments (will be imported as P4 Repeating Values)

Digitizer Maps

Peripherals

Tag Actions

Import P4 Configuration

Exported

P4 configuration files can be imported to easily transfer configuration tools to other computers. All of the P4 configuration tools are available to import and export.

66 of 134

Import Configuration

Available Configuration Tools

This panel shows the configuration tools that are available to import from the selected file(s). Use the checkboxes to select the tools to import.

Some configuration tools can have other tools that are attached or related to them. For example, a profile can have related Peripherals, Repeating Values, Data Entry Layouts, etc. These will be identified with a notation showing the number of related tools that will also be imported. All tools that are related to the tool that is selected for import must also be imported; the related tools are designated with a light-gray check mark that cannot be removed.

Three actions are available when importing configuration tools:

·

Import as New Record

·

·

Use Existing Tool

Replace Existing Tool

Selected Tool

Displays a read-only preview of the tool that is currently highlighted in the Available Configuration Tools panel. If any errors were detected in the file that was selected, they will be displayed in the Import

Errors tab.

Import as New Record

This action will import the tool as a new record and is selected by default when a tool with the same name and type does not exist in the destination installation of P4.

67 of 134

Replace Existing Tool

This action will replace an existing tool with the imported tool. It is selected by default, and is only available, when a tool with the same name and type but different settings already exists in the destination installation of P4.

Use Existing Tool

This action will use an existing tool in place of the imported tool. It is selected by default, and is only available, when a tool with the same name, type and settings already exists in the destination installation of P4.

68 of 134

Export Configuration

All configuration tools can be exported from P4 in order to transfer them to another computer.

Configuration Tools

This panel shows the current list of configuration tools. Use the checkboxes to select which tools to export.

Some configuration tools can have other tools that are attached or related to them. For example, a profile can have related Peripherals, Repeating Values, Data Entry Layouts, etc. These will be identified with a notation showing the number of related tools that will also be exported. All tools that are related to the selected tool must also be exported. The related tools are designated with a light gray check mark that cannot be removed.

Preview of Selected Tool

Displays a read-only preview of the tool that is highlighted in the Configuration Tools panel.

Selected Tool

This Profile is selected for export. Notice that there are 8 related tools, and that each of those related tools are also selected for export.

Related Tool

This Data Entry Layout is related to the Profile that is selected for export and will also be exported, as indicated by the light gray check mark that cannot be removed.

69 of 134

Related Tool

This Data Entry Layout is related to the Profile that is selected for export and will also be exported, as indicated by the light gray check mark that cannot be removed.

70 of 134

Collect

New Session

Click this tile create a new Session.

Open Last Session

Click this tile to open the last Session that was opened in data collection. It will open directly into the

Data Entry

screen.

Open Session

Click this tile to open a previously saved or imported Session.

Import Data

Click this tile to import PIT tag data into P4. Data can be imported from P3 tag files, P3 database, P4 files, or delimited files.

71 of 134

New Session

A Session is the container for a set of MRR records. A Session can only contain records for a single Project

Code, but most other fields can be different for each record in the Session. A Session can be empty or contain thousands of records, encompass one day of marking or several months of marking, however it is not recommended to cross calendar year boundaries in a Session.

Profile

Select the Profile

to associate with the new Session. Existing values in the New Session Defaults

section of the Profile will be used to complete the rest of the form. Settings and devices specified in the selected Profile will be active while the Session is open.

Project Code

Select the Project Code (which used to be known as the Coordinator ID) for the new Session.

72 of 134

File

The File name will be automatically generated based on the Project Code , the current date, and the default value for UDF specified in the selected Profile. If a Project Code has not been selected, the File name will remain blank. If a default value for UDF has not been specified, it will use incremental numbers, starting with 001.

Session

Enter a name for the Session. Defaults to the File name, if it is generated, but can be changed.

Session Folder

Select an existing folder or enter a name to create a new folder into which the Session will be saved. If left blank, the Session will not be placed into a folder.

Repeating Values

Select a Repeating Value

to use with this Session.

Data Entry Layout

Select a custom Data Entry Layout

to use with this Session. If left blank, the default data entry form will be used.

Session Message

Enter a value to be saved in the Session Message field for this Session.

Session Note

Enter a value to be saved in the Session Note field for this Session.

New in P4, Session Notes are now loaded into the PTAGIS database.

Project Defined Session Fields

All session-level Project Defined Fields

will be displayed here. Enter a value to be saved in those fields for this Session.

73 of 134

Open Session

Expand or Collapse Folders

Used to expand or collapse all the folders. Expanding folders shows all the Sessions stored within them. Collapsing hides all the Sessions. Single folders can be expanded by double-clicking the folder name or clicking on the black arrow to the left of the folder icon.

Show Search Panel

Used to open a panel to search for a Session by name.

Create New Folder

Used to create a new folder. The new folder will be created as a sub-folder if an existing folder is selected when the button is clicked.

Open Selected Session

Used to open the selected Session. A Session can also be opened by double-clicking it.

74 of 134

Data Entry

Session Data Entry in P4 is composed of several dockable panels and a tool bar. By default the panels and tool bar will be visible and docked as shown in the screen shot below. Each panel can be hidden, closed, or docked to another location in the data entry screen. The tool bar can also be undocked and/or moved to the sides or top of the data entry screen. P4 will remember the location and visible state of each panel and tool bar between sessions. A hidden or closed panel can be restored to its former position from the

View button

on the

tool bar, or by using the appropriate keyboard shortcut or digitizer command. The tool bar can be restored from

a hidden state by pressing ALT-M on the keyboard.

Data Entry Form Panel

The Data Entry Layout

associated with the Session and the main form for entering data into P4.

Output Panel

Displays a log of events that have occurred since the Session has been opened. A log of all events

from the complete history of the Session can be viewed in Manage Database

.

Statistics Panel

Displays the number of marks, recaptures, recoveries, dot-outs, and tallies by SRR in the Session.

Session Properties Panel

Displays the properties of the Session in read-only mode. Session properties can be edited by clicking

the Session button on the tool bar to open the Update Session Properties

dialog.

75 of 134

Tag Code Buffer Panel

Displays tag codes that have been placed in the P4 buffer. When a tag code is placed in the P4 buffer, this panel will be displayed if it is hidden or closed.

Current Record Values Panel

Displays every field and the values in those fields for the current record.

Tool Bar

Contains buttons that can be used to interact with the current record; show/hide panels; edit properties of the Session; or edit configuration tools associated with the Session. The tool bar can also be undocked, hidden, or moved.

76 of 134

Output Panel

The Output Panel displays events and errors that have been logged during the current data entry session. The

complete log history for a Session is available to view in the Manage Database screen.

Type

Icon showing the type of message: Information, Warning, or Error.

Message

Displays the event or error that has been logged.

Source

Displays where the error came from.

Time

The time the event was recorded.

77 of 134

Statistics Panel

The Statistics Panel shows basic counts of records by SRR code and Event Type. The columns can be resized, moved, or removed from the panel. To restore a column that has been removed, right click on any column and select the Column Chooser.

Marks

Counts records where Event Type = Mark and PIT Tag contains valid tag code

Recaptures

Counts records where Event Type = Recapture and PIT Tag contains valid tag code

Recoveries

Counts records where Event Type = Recovery and PIT tag contains valid tag code

Dot Outs

Counts records where Event Type is Mark, Recapture or Recovery and PIT Tag is dotted out

Tallies

Counts records where Event Type = Tally

78 of 134

Tag Code Buffer Panel

A tag code will be stored in the P4 buffer when one of the following conditions exist:

·

·

A PIT tag is scanned when Auto Accept is disabled in the current Profile AND the current record has not been Accepted or Rejected

A PIT tag is scanned when Auto Accept is enabled in the current Profile AND the current record has a validation error preventing it from being Accepted

When a tag code is placed in the buffer, the Tag Code Buffer Panel will be opened and displayed if it is closed or hidden and a message will be written to the

Output Panel . Tag codes only remain in the buffer as long as the

Session is open. If the Session needs to be closed before all buffered tag codes are addressed, the buffered tag codes can be saved to a text file.

Add Buffered Tag to Record

Used to add the next buffered tag code to the current record and remove it from the buffer. This command is only available if the current record is a new record.

Save Buffered Tags to File

Used to save the buffered tag codes to a text file.

Clear Buffered Tags

Used to clear all the tag codes from the buffer.

79 of 134

Session Properties Panel

This panel displays the Session properties and session-level data fields, including

Project Defined Fields , in a

read-only format. To edit the properties, click the Session button on the

Tool Bar to open the

Update Session

Properties

dialog. The current record must be Accepted (saved) before Session properties can be edited.

80 of 134

Update Session Properties

This dialog is used to change Session properties, such as Repeating Values or Data Entry Layout, or Session data fields, such as Project Code or Session Message, for the current Session.

81 of 134

Current Record Values Panel

This panel provides access to all available data fields in the current record. All fields, including those fields that are on the Data Entry Form, can be viewed or edited from this panel. It is similar in function to the

Repeating

Values configuration tool, except that it directly edits the values in the current record. It is available primarily as

way to ensure that the correct repeating values are being entered into each record, and is not recommended to be the main source of data entry. It is strongly recommended that any fields that will need to be interacted with

during data entry be placed on the Data Entry Layout

.

82 of 134

Batch Update

The Batch Update feature allows the updating of values in multiple records that are grouped by a value in the selected batch field. For example, a recovery container group identifier can be stored in the

Raceway/Transect/Tank field, which can then be used as the Batch Field to update the Release Date field when the group of fish in that container are released post-recovery while still in the tagging session.

Most of the applicable detail record fields can be selected as either the Batch Field or the Field to Update. This

dialog is accessed by clicking the Batch Update button on the data entry

or

record management tool bars.

Batch Field

Select the field that contains the values by which the records should be grouped for updating.

Field to Update

Select the field that will be updated.

Results Grouped by Batch Field

Records will be displayed in this grid grouped by the Batch Field. The Field to Update can be edited directly in this grid to apply the desired value to the desired group of records.

83 of 134

Tool Bar

Accept Record

Used to Accept (save) the record to the database.

Hot Key = ALT-A

Reject Record

Used to undo changes made to the current record since it was last accepted. If used on a new, unsaved record, all values that have been entered (except those from Repeating Values) will be removed.

Hot Key = ALT-R

Dot Out Record

Used to enter 10 dots into the PIT Tag field. If the PIT Tag field is not empty when this command is used, the value will be replaced by the dots.

Hot Key = ALT-D

Undo Dot Out

Used to undo the dot-out command in cases where the existing tag should not have been overwritten.

Hot Key = ALT-U

Tally

Used to enter 10 dots into the PIT tag field and change the Event Type to Tally. This is a new feature in

P4 intended to facilitate data collection on fish that will not be marked with a PIT tag.

Hot Key = ALT-T

Scroll Records

Used to scroll to the first, previous, next, last or new records in the current Session. Click the record counter to go to a specified record number.

Hot Keys:

Function Key Combination

Go To Specified Record # CTRL-G

First Record

Previous Record

CTRL-Home

CTRL-Page Up

Next Record

Last Record

New Record

CTRL-Page Down

CTRL-End

CTRL-Insert

84 of 134

View Panels / Restore Layout

Used to show panels that have been hidden or closed, and to restore the Session Data Entry panels to the last used layout or the default layout.

Hot Keys:

Function Key Combination

Show main tool bar

Show Data Entry Form

Show Session Properties Panel

Show Tag Code Buffer

Show Statistics Panel

Show Current Record Values Panel F5

Show Output Panel F6

Restore the last-used layout of panels F7

ALT-M

F1

F2

F3

F4

Edit Repeating Values

Used to edit the set of Repeating Values

associated with the current Session.

Edit Session Properties

Used to edit the properties and session-level field values of the current Session.

Edit Profile

Used to edit the Profile

that is associated with the current Session.

Manage Records

Used to open the Session in Record Management

, where it can be validated, reviewed, edited, and/or exported.

Reset Devices

Used to reconnect all devices specified in the Profile associated with the current Session. This is useful if the Session was opened before all devices were powered on or connected to the computer.

Align Map

Used to open the Test and Calibrate

dialog for the Digitizer Map.

Batch Update

Used to edit multiple records in the current session based on a value in a batch field. For example, if fish from specific recovery containers get released at different times, the Raceway\Transect\Tank field can be used to group these records and the release time can be entered while the session is open for data entry.

Export

Used to export the current session in P4 XML file format. A default export folder can be set in Utilities

.

85 of 134

Keyboard Shortcuts

Most of the commands available from the Tool Bar

can also be used with a keyboard shortcut.

Command

Accept Record

Reject Record

Dot Out Tag Code

Undo Dot Out

Tally

Go to specified Record

Scroll to First Record

Scroll to Previous Record

Scroll to Next Record

Scroll to Last Record

Scroll to New Record

Show main tool bar

Show Data Entry Form Panel

Show Session Properties Panel

Show Tag Code Buffer Panel

Show Statistics Panel

Show Current Record Values Panel

Show Output Panel

Restore Layout to previous state

Edit Repeating Values

Edit Session Properties

Edit Profile

Reset Devices

Align Digitizer Map

Batch Update

Export to XML

Shortcut

ALT-A

ALT-R

ALT-D

ALT-U

ALT-T

ALT-G

CTRL-Home

CTRL-Page Up

CTRL-Page Down

CTRL-End

F3

F4

F5

F6

CTRL-Insert

ALT-M

F1

F2

F7

F8

F9

F10

F11

F12

CTRL-B

ALT-E

86 of 134

Import Data

Data can be imported into P4 from a variety of sources, including P3 files and database, delimited files, and

PIT tag readers.

Import P3 or P4 Files

Used to import PIT tag data from P3 tagging files, P3 database files, or P4 tagging files.

Import Delimited Files

Used to import PIT tag data from CSV or other delimited files.

Download Reader Files

Used to download and import PIT tag codes and associated timestamps directly from reader devices.

Import Reader Files

Used to import text files containing raw reader data that has been downloaded using another communications utility.

87 of 134

Import P3 or P4 Files

To import data from P3 or P4 formatted files, navigate to the directory where they are located and select one or more files to import. They will be parsed and displayed in the

Import Data Preview screen for your review.

To import data from P3 database files, navigate to the directory where P3 is installed (usually C:\Program

Files\PTAGIS\P3

) and select the P3.mdb file. Before doing this, ensure that the file secured.mdw also

exists in that directory. If the database file appears to contain no sessions, please check the Windows Virtual

Store

.

88 of 134

Windows Virtual Store

The Windows Virtual Store is a feature of Microsoft Windows that allows software developed before modern computer security practices were put in place to function as normal. When P3 was originally developed, it was best practice to keep the database in the installation directory (C:\Program Files\PTAGIS\P3). Now, computer security policies often make it impossible for non-administrator accounts to write to files in this directory. To solve this problem, Windows makes a copy of the file that needs to be written to (in this case,

P3.mdb) and places it in a directory where non-admin accounts do have permissions to write. To find the

Virtual Store location copy and paste this into the File Explorer: %localappdata%\VirtualStore.

89 of 134

Import Delimited Files

This screen is used specify import parameters for delimited files. After completing the Destination, Parse

Options and Column Mapping sections, click the Continue button to

preview the data and finalize the import

process.

Profile

Optionally select a profile to apply the Default Property Values for New Sessions

to the session that will be created from the imported delimited file.

Session Name

Enter or edit the name for the new Session that will be created.

Repeating Value

Optionally select a set of Repeating Values

to apply to the records as they are created from the imported data. Values in the selected Repeating Value will only be entered if the source file contains no values for that field.

Parse Options

Specify whether the first row in the CSV file contains column headers and the field separator.

Checking the Auto-Map Columns box will automatically map any columns in the CSV that have the same header as P4 fields.

Column Mapping

This section is used to map the field names from the file being imported to P4 field names.

90 of 134

File Column Name

This row displays the column names found in the file being imported. If no headers exist in the file, the columns will be numbered from left to right.

P4 Field Name

Select the appropriate P4 field into which the file column above should be imported. If the column should not be imported, select (skip) instead.

91 of 134

Download Reader Files

Use this form to download tag codes directly from a connected reader into a new Session or Tag List. A Profile and/or a set of Repeating Values can optionally be specified to apply those values to the new session and the records in that session. If the reader stores timestamps, those timestamps can be applied to the Event Date,

Release Date, or ignored. Once the reader files have completed downloading, click the Continue button to

preview the imported records and finalize the import process.

Import As

Used to select whether to import the reader file as a new Session or as a Tag List

.

Profile

Optionally select a Profile to apply the Default Property Values for New Session

to the Session that will be created.

Session Name

Enter or edit the name for the Session or Tag List that will be created.

Repeating Values

Used to select a set of Repeating Values

to apply to each record that is created from imported reader files.

92 of 134

Use Timestamp As

Used to specify which field the reader timestamp should be imported into: Event Date or Release

Date. If the timestamp should not be imported or the reader does not store timestamps, Ignore should be selected.

Reader Timezone Offset

Used to specify the timezone offset for reader timestamps. Defaults to the timezone offset of the local

computer, and only needs to be changed if the reader is using a different timezone offset. See Dates and Times in P4

for more information.

Duplicate Check

Select whether to check for and filter out duplicate tag codes:

·

·

·

None: All tag codes will be imported, including duplicates

Files: Duplicate tag codes in the selected reader files will be ignored. Only one record will be created for each distinct tag code.

Files and Sessions: Duplicate tag codes in the selected reader files will be ignored, as well as tag codes that are already in the P4 database. Only one record will be created for each distinct tag code.

Select Reader

Used to select a previously configured reader Peripheral Device

from which to import tag codes. The reader must be powered on and connected to the computer.

Connection

Used to open a connection to the selected reader.

Send Command

Used to send a command to the reader to download tags. This can also be initiated from the reader itself.

93 of 134

Import Reader Files

Used to import raw output from a reader that has been saved to a text file. Any text file that contains data with a tag code, timestamp, and/or lat/long coordinates on the same line can be imported using this tool.

Profile

Optionally select a Profile to apply the New Session Default

values to the session that will be created.

Session Name

Enter or edit the name for the Session or Tag List that will be created.

Repeating Values

Used to select a set of Repeating Values

to apply to each record that is created from imported reader data.

Timestamp Format

Specify the format of the timestamp, if there is one, in the selected files. All files must have the same date format.

Use Timestamp As

Specify which field the timestamp should be imported into: Event Date or Release Date. If the timestamp should not be imported along with the tag code, Ignore should be selected.

Selected Files

Used to show the list of files selected to import. Click on a file to view its contents and the parsed data in the windows to the right.

File Contents

Displays the raw data as it is formatted in the selected file.

Parsed Data

Displays the data as it has been parsed from the selected file.

94 of 134

Duplicate Check

Select whether to check for and filter out duplicate tag codes:

·

·

·

None: All tag codes will be imported, including duplicates

Files: Duplicate tag codes in the selected reader files will be ignored. Only one record will be created for each distinct tag code.

Files and Sessions: Duplicate tag codes in the selected reader files will be ignored, as well as tag codes that are already in the P4 database. Only one record will be created for each distinct tag code.

95 of 134

Import Data Preview

This screen displays a preview of the sessions that can be imported

Session Options

Optionally select or create a folder into which the Sessions will be saved. If planning to open the imported Sessions in data entry, it may be useful to select a Profile, Data Entry Layout and/or

Repeating Value to associate with the Sessions.

Available Sessions

This displays the Sessions that were found in the selected file(s). Use the checkboxes to select the

Sessions to be imported. Sessions with import errors will be displayed in red. Some import errors prevent Session from being imported; these will need to be edited outside of P4 before then can be imported.

Preview

This displays a preview of how the data will look when it is imported. The Session Name can be edited here.

Import Errors

This tab is used to display details about errors encountered during the import process. Select

(highlight) the Session with the error and click this tab to see the details.

96 of 134

Manage

Manage Sessions

Validate and submit Sessions to PTAGIS and perform other operations on multiple Sessions at one time, such as copying, exporting or joining.

Query

Create custom queries across all Sessions in the local P4 installation.

Manage Records

View and edit the records in individual Sessions.

Update Records From Another Session

Used to update values in one Session using the values stored in another Session.

Dot Out Records

Used to dot out records from multiple Sessions using a single Tag List.

Database Log

View the database log, which retains a history of actions taken within the application since it was first installed. Actions such as upgrading P4, importing and collecting data into Sessions,are recorded.

Utilities

A collection of utilities for exporting/importing P4 layout settings and managing the P4 database

(backup, restore, clear, and shrink).

97 of 134

98 of 134

Session Management

Session Management is used to submit data to PTAGIS and to perform operations on multiple Sessions at one time.

Expand All Folders

Expands all folders, showing the Sessions in them.

Search

Opens the search panel and allows searching for Sessions by name.

Collapse All Folders

Closes all folders and hides the Sessions in them.

New Folder

Creates a new folder.

Check Selection

Used to check or uncheck selected (highlighted) Sessions or all Sessions.

Manage Records

Used to open the checked Sessions in Record Management.

Copy

Used to create a copy of each checked Session.

Join Sessions

Used to join two or more checked Sessions into one new Session.

Delete

Used to delete all checked Sessions.

Validate

Used to validate

all checked Sessions. Validation results will be shown in a panel that opens at the bottom of the screen.

99 of 134

Customize Validation

Used to enable/disable the Custom Validation

routines to run when validating Sessions.

View Duplicate Records

Used to search for duplicate records of the selected Session(s) across the entire local P4 database.

Check one or more Sessions and click this button to begin. If any duplicate records are found in the

selected Sessions, the Duplicate Records

screen will open.

Export

Used to export each checked Session to the specified format.

Upload

Used to submit all checked Sessions to PTAGIS for loading.

Refresh Status

Used to refresh the file load status of submitted Sessions.

Get Upload History

Used to open a report in the default browser that shows the complete upload history for all checked

Sessions. Access to the internet is required for this feature.

100 of 134

Validation Results Summary

Validation in Session Management can be performed on multiple Sessions at once. The validation results are summarized per Session, displaying the number of records per validation failure.

Session

Name of the Session with validation failures.

Error

A validation error is marked with a red X icon and indicates an error that must be corrected before the file can be submitted to PTAGIS for loading

Warning

A validation warning is marked with a yellow exclamation point icon and indicates an error that should be reviewed, but won't prevent the file from being submitted to PTAGIS. Validation Constraints will also be displayed as a warning.

Duplicate

Duplicate records are marked with this icon, and indicate that two records exist in the Session with the same PIT tag code and an event type of Mark. Multiple records with the same PIT tag code are allowed in a Session, as long as the Event Types of the records make sense, i.e. only one mark event exists for that PIT tag code.

101 of 134

Number of Records

Number of records with that particular validation failure in the Session.

102 of 134

Upload Sessions to PTAGIS

Authorized Data Submitter

Enter the email address and name of person submitting the Sessions to PTAGIS. That person must be an authorized data submitter for the Project Codes used in the Sessions.

Operation

Specify the operation that should be performed for each Session. To set the operation for each

Session individually, click into the field and select the appropriate operation from the list. To set the same operation for multiple Sessions at once, highlight them and right-click to select the appropriate operation.

·

·

·

Load: Used to submit a file containing new, previously unloaded records.

Correct: Used to correct the previously loaded version of this file.

Ignore: Used if a Session has been checked by mistake and should not be processed.

103 of 134

Join Sessions

Join Sessions is used to combine two or more checked Sessions into one newly created Session. It copies the records from each of the checked sessions into a newly created Session, including any duplicate records.

New Session as Copy Of

Select the Session that will be used to populate the session-level fields of the new Session that will contain all the records.

Detail Records to Join

Displays the number of records that will be in the new Session.

Duplicate Records

Displays the number of those records that are duplicates.

104 of 134

Duplicate Records

Results screen after initiating a duplicate search from Session Management shows duplicate records across of the selected Sessions across the entire local P4 database. Records are grouped by PIT Tag to enable comparing the duplicates side-by-side. To reconcile duplicate records, either change the Event Type of individual records directly or select one or more records to dot-out.

Select Tags To Dot Out

Used to automatically dot out all duplicates of each tag code except for the first record or the last record. Individual records can also be selected for dotting out by checking the box in the grid next to the record that should be dotted out.

Apply Dot Out

Used to dot out the selected records and display the a preview of the results in the grid. If the results are satisfactory, the Save button will write those changes to the database. If the results should not be saved to the database, use the Reset button.

Save

Used to save the applied dot-outs preview to the database. Once this button is clicked, the dot-outs cannot be undone.

Reset

Used to undo the applied dot-outs preview and cancel the dot-out operations. Can only be used if the

Save button has not been clicked.

Export Results

Used to export the duplicate search results to Excel.

105 of 134

Append Dot Out Tag Code To Text Comments

Used to specify that the dotted-out tag codes should be written to the Text Comments field when applied.

Duplicate Search Results

Provides a summary of the number of sessions searched, number of sessions with duplicate records, total number of duplicate records found, and number selected for dotting out.

106 of 134

Record Management

Record Management is used to view, validate and edit Sessions in a tabular view. Multiple Sessions can be opened at one time into tabbed documents, which are also dockable into horizontal or vertical views.

Active Session

A table view of all the records in a Session. Records can be edited individually, filtered, and sorted

(right-click on column header). Column layout can be customized and will be saved for each Session separately.

Group Panel

Used to group event records by one or more columns.

Filter Rules/Filter Values

Left click the filter icon in any column to filter by selecting values or by specifying rules. This feature is

also available in Query Management

and can be used to create a query rather than the filter editor

.

Right-Click Menu

Right-clicking any column header will bring up this context menu, which offers the following functions:

·

·

·

·

·

·

·

·

·

Sort Ascending: sort records by the selected column in ascending order

Sort Descending: sort records by the selected column in descending order

Clear sorting: clear sorting on the current column

Group By This Column: groups records by the values in the selected column

Show Group Panel: shows the columns being grouped on and offers access to the Group

Summary Editor

Show Column Chooser: shows a list of columns not displayed on the active session in order to add them to the grid

Best Fit: resizes the width of the selected column based on the lengths of the values in that column

Best Fit (all columns): resizes all columns based on the lengths of the values in them

Filter Editor: opens the filter editor

to allow filtering on records in the active Session

107 of 134

Session Explorer

Used to open the Session Explorer to select Session(s) to open.

Close All Sessions

Used to close all open Sessions.

Save Session

Saves the active Session.

Save All Sessions

Saves all open Sessions that have unsaved changes.

Reject Changes

Undoes all changes that have been made to the active Session since the last time it was saved.

Validate

Validates the active session and opens a panel at the bottom of the screen showing the validation results

.

Customize Validation

Enable or disable Custom Validation

routines to run when a session is validated.

Manage Open Sessions

Used to navigate to Session Management

and select the Sessions currently open in Record

Management.

Export

Export the active Session to Excel, CSV, or P4 file.

Print

Print the active Session.

New Record

Add a new record to the active Session.

Delete Record

Deletes selected records in the active Session.

Go To Record

Used to move the grid view to the specified record number. The keyboard shortcut of ALT-G will also perform this task.

Find and Replace

Used to search for a specific value in one field/column in the active Session and replace it with another value.

Fill Records

Used to set, overwrite, or append to multiple fields/columns in the active Session.

Batch Update

Used to edit multiple records in the current session based on a value in a batch field. For example, if fish from specific raceways were released in different locations or at different times, the Raceway field can be used to group these records and the release information can be updated based on those groups.

108 of 134

Adjust Dates

Used to replace or adjust a part of a date/time value.

Resequence Records

Used to renumber the records in the session using the current sort order.

Dot Out

Dot out selected or all records in the active Session.

Column Layout

·

·

·

Save the current column layout as the default layout to use for newly opened Sessions.

Reset the column layout of the active Session to the default layout.

Open the column chooser to add columns to the active Session.

Session Properties

Edit session-level values, such as Session Message, Session Note, Session name, Project Code, and

File Name. View other session properties, such as created and modified dates.

Reset File Name

Used to change the File Name to match the earliest Event Date in the active Session.

109 of 134

Validation Results

Validation in Record Management is performed on one Session at a time and shows validation failures on a per-record basis.

Duplicates

Records with the same PIT Tag and Event Type values are marked as Duplicates during validation.

Multiple records with the same PIT tag are allowed in a single Session, as long as the Event Types make sense: there can only be one record with a Mark event type, but there could be multiple records with Recapture event types.

Errors

Validation failures that prevent the Session from being submitted to PTAGIS are marked as Errors during validation. These errors will need to be corrected before the Session can be submitted to

PTAGIS for loading.

Warnings

Validation failures that do not prevent the Session from being submitted to PTAGIS are marked as

Warnings during validation. Validation Constraints will also be marked as warnings.

Show/Hide Validation Failure Types

These tabs are used to toggle between showing and hiding the validation failures of each type.

Field to Correct

Shows the field that needs to be edited to correct the validation failure. Click the field name to be taken directly to the cell that needs to be edited.

110 of 134

Export to CSV

Used to export the validation results to a CSV file.

Close Validation Results

Used to close the Validation Results panel.

111 of 134

Find and Replace

Find and Replace is a dockable panel that can be used to search for values within a specified field and optionally replace them. It can also be used to find blank fields and to insert a value into them. It can be accessed by clicking the binoculars icon on the Record Management tool bar or by hitting CTRL-F on the keyboard.

Field to Search

Select the field in which to search for values. If a field in the active Session is selected when Find and

Replace is opened, it will also be selected here.

Find What

Select or enter the value to search for, or leave blank to search for blank values. If a cell in the active

Session is selected when Find and Replace is opened, the value in that cell will also be selected here.

Replace With

Select or enter the value that should replace the searched for value when the Replace All button is clicked. If this field is left blank, the searched for value will be cleared when the Replace All button is clicked.

Find Options

These options are only available for text fields and the Conditional Comments field. By default, Find and Replace will search for partial values in these fields. If the entire value should be matched, check the Match whole field box. If the case matters for the value to be replaced, check the Match case box.

Find All

Use this button to find all records in the active Session where the Field to Search and the Find What value match. A message box will display the number of matching records found. All matching records will be highlighted and the grid will be scrolled down to the first matching record.

Find Next

Use this button to find the next matching record. The matching cell will be highlighted and the grid will be scrolled down to the first matching record.

112 of 134

Replace

Use this button to replace the currently highlighted matching Find value with the Replace value.

Replace All

Use this button to replace all matching Find values with the Replace value. When the operation has completed a message box will display th number of records that were edited.

113 of 134

Fill Records

The Fill Records feature can be used to insert, overwrite, or append values to multiple fields in a Session at one time. Saved

Repeating Values can be used as a source of the update values.

Update Strategy

Select the strategy to use when updating values:

·

Append: append the update value to current value if the field is a free text field; if the field has a

·

· select list or data type that does not support appending, the update value will overwrite the current value

Blank: insert the update value only where the current value is blank, empty or null

Overwrite: insert the update value always, regardless of current value

Select Repeating Value

Optional - select a saved set of Repeating Values to fill in the update values. Update values can be edited by user prior to applying them to the Session.

Update Values

Enter values into the fields that need to be updated. Only the fields that contain an update value will be edited according to the update strategy when applied.

114 of 134

Adjust Dates

Adjust Date is a dockable panel that allows the user to add a value to, subtract a value from, or replace any part of a date/time field. In the example in the screenshot below, all the Event Date values in the active Session will be updated by adding 2 to the hour. This will change the Event Date from 10/19/2013 11:00:00 to

10/19/2013 13:00:00.

Field to Update

Select the date field to be updated. The column must be on the active Session grid to be included in the drop-down list.

Records to Update

Select to update all records in the Session or only the selected records.

Component

Select the date or time component to update. Choices are Year, Month, Day, Hour, Minute or Second.

Operation

Select the operation to perform on the selected component. Choices are Replace, Add or Subtract.

Value

Enter the value with which to complete the operation.

115 of 134

Query Management

The Query feature is used to query the P4 database. Simple and complex filter statements can be built using

the Filter Editor

and the results set can be exported, used to create a Tag List

, or

updated

. Filter statements

can also be used to create Custom Validations .

Query Properties

The name, description, created date, and modified date of the Query.

Group By Panel

Displays the group by fields for the Query and gives access to the Group Summary Editor

and other

group by properties via a right-click context menu

.

Filter Editor

Used to build the statements that define the Query.

New Query

Used to create a new Query.

Open Query

Used to open a previously saved Query.

Save Query

Save the active Query.

Save All Queries

Save all open Queries.

116 of 134

Reset Query

Undo any changes made to the active Query since the last time it was saved.

Update Query Results

Used to update the records returned by a query.

Export Results

Used to export query results to CSV or Excel file.

Custom Validation

Used to create or update a Custom Validation

tool from the definition of the active Query.

Create Tag List

Used to create a Tag List

from the results of a Query.

Print Results

Print the results of a Query.

Show Column Chooser

Used to add available columns to the Query results set.

Show Query Editor

Shows the Filter Editor

, which is used to build the statements that define the Query.

Clear Query

Clears all statements from the Filter Editor

.

Disable Filter

Uncheck this box to temporarily disable the filter, but not clear it. Check the box to enable it again.

Filter Details

Displays the Query definition.

Edit Filter

Opens the Filter Editor

for the active Query.

Clear Filter

Clears all statements from the Filter Editor

.

Group Panel Right-click Context Menu

117 of 134

Group Panel Right-click Context Menu

Full Expand / Collapse

Expand (show all records) or collapse (hide records) all groups in the Query results.

Sorting

Sort records in ascending or descending order using the group by field. If summary values have been enabled, the Sort by Summary option allows sorting by those values.

Ungroup / Hide Group Panel

Select Ungroup to remove the group by field. Select Hide Group Panel to hide the panel from view. The group by will still be in effect if the panel is hidden.

Column Chooser / Best Fit

Open the column chooser to add available columns to the Query results. Select Best Fit to make all column widths fit the contents of the fields.

Group Summary Editor

Opens the Group Summary Editor.

Filter Editor

Opens the Filter Editor.

118 of 134

Filter Editor

The Filter Editor can be used to build complex statements to filter records from a single Session (in Record

Management ) or across Sessions (in

Query Management ). It displays the criteria in a tree structure where the

nodes are the logical operators linking the conditions under them.

A single condition still appears under a node. The query criteria in this image will return all records where the

SRR Code contains the letter W.

If another condition is added underneath the And node, the filter criteria will return records where both the conditions are true:

[Conditional Comments] contains 'AD'

AND

[SRR Code] contains 'W'

For more complex filtering criteria, there can be multiple groups of conditions, each with its own logical operator node. This filter criteria will return records that match the following expression:

([SRR Code] contains 'W' and [Conditional Comments] contains 'AD')

OR

119 of 134

([SRR Code] contains '3' and [Length] < 60)

A context menu can be accessed by clicking on any of the logical operator nodes, which gives access to change the operator, remove the group, add a new group, or add a new condition. Other elements of the Filter

Editor interface are labeled in the image below.

120 of 134

Group Summary Editor

The Group Summary Editor is used to display aggregate values (minimum, maximum, average, sum) and row counts in Query Management and Record Management. Queries are grouped by the Session field by default, as seen in the screenshot below. The Group Summary Editor can be opened from the context menu that is displayed when the group by field is right-clicked. It shows a list of the fields available. In the example below, minimum and maximum length values will be shown for each group, along with a row count. Since the group by field is Session, the group summaries show the minimum length, maximum length, and number of records per Session.

121 of 134

Update Query Results

The results set of a Query can be updated using this tool, allowing updates of records in multiple Sessions to

be made in one step, rather than opening each individual Session in Record Management

and updating records a Session at a time. This feature can be used to dot out records, replace a whole value with another value, replace part of comment with a new value, clear a field, append to a text field, or fill in empty values.

Event and Release dates cannot be edited with this feature and must be edited in Record Management.

Create Update Specification

This is used to build the statements that will update the query results set. Follow these steps to add one or more update specifications:

1.

Select the field to update.

2.

Select the operation that will be applied to that field. The options available here depend on the field selected in step 1.

3.

4.

Complete the details as required for each operation. For example, if the selected operation is

Overwrite, then specify the value that will replace (overwrite) the current value in that field.

Click the Add button to add the statement to the Update Specifications window.

Update Specifications

Displays the list of statements that will be used to update the Query results. To remove a statement, click to select it and then click the Remove button.

Backup Database

Check this box to make a backup

of the P4 database before applying the update specifications to the

Query results. Having a backup would allow for restoration of the original records in the event that an update specification is applied in error.

122 of 134

Dot Out Records

Available Tag Lists

Check one or more Tag Lists

to use for the dot out process. The tag codes in the checked lists will be displayed to the right in the Selected Tag Codes for Dotting Out table.

Search Sessions

Click this button to search all Sessions saved in the local P4 application for records containing the tag codes from the checked Tag Lists.

Search Results

Matching records will be displayed in the Search Results, grouped by Session name. When the dot outs are applied, the results will be displayed here as well.

Select Records to Dot Out

Check the Sessions or individual records, which can be accessed by expanding the Session grouping, to dot out.

Apply Repeating Values

Optionally select or create a Repeating Value

to set field values in the dotted out records. For example, text could be entered into the Detail Note field explaining the reason for dotting out the records.

Append When Possible

Check this box to append the selected Repeating Values, where possible, rather than to overwrite existing values.

123 of 134

Append Tag Code

When enabled (On) the dotted out tag code will be appended to the Text Comment field, if possible.

Apply Dot Out

Click this button to dot out the selected Sessions/records (also applying Repeating Values and/or appending tag codes to Text Comments, as specified) and view a preview of the results.

Save

Click this button to save the dot outs permanently.

Reset

Click this button to undo the dot outs and start over.

124 of 134

Update From Session

Update from Session is used to update values in one session using value in another session. For example, if a reader was set up to capture the timestamp of fish exiting a facility during a volitional release, this feature could be used to update the original tagging file with those release times. To accomplish this, reader file from the release monitoring would be imported into P4 as a session containing only the tag code and Release Date.

Then that session would be used to update all other sessions that contained those tag codes with the timestamp from the reader as the Release Date.

Session to Search By

Select the Session that contains the tag codes to search by and the values that will be used to update the resulting records.

Match Records By

Select to match records by Tag Code only or by Tag Code and Event Type.

Search

Click the Search button to find all matching records.

Select Records to Update

Records with tag codes that match those in the Session to Search By will be displayed here, grouped by Session. Check the Sessions and/or records to be updated.

125 of 134

Select Fields to be Updated

Put a check mark in the box next to the fields to be updated by the values from the Session to Search

By

Update Strategy

Select the update strategy to use:

·

·

·

Append: Append the update values, if possible, otherwise overwrite. Append only works on comment fields such as Text Comment and Conditional Comment; all other fields will be overwritten.

Blank: Only update the target field if it is blank, if it is not blank ignore it.

Overwrite: Always overwrite the target field with the update value.

Apply

Click this button to apply the update to the selected Sessions and/or records. Results of applying the update will be shown in the Select Records to Update grid.

Save

Click this button to permanently save the updated records.

Reset

Click this button to undo the changes to the updated records.

126 of 134

Database Log

The database log contains a history of actions recorded by P4 during the lifetime of the database that is currently in use. Actions such as application install or upgrade, importing data, opening and collection data into a Session, and updating records in a Session are recorded into the log.

Records to Display

Select the number of records in the database log to display. Default value is 500.

Group Panel

Used to group by a column in the database log. This is particularly useful for viewing all the actions that

have been performed on a Session. See the Group Panel

right-click context menu for more information.

127 of 134

Utilities

Database Name

Displays the location and name of the P4 database.

Backup Database

Creates a backup of the P4 database.

Restore Database

Used to restore a previous P4 backup. The backup file must match the P4 version into which it is being restored or P4 may become inoperable. Each backup file has a default name format that includes the version of P4 it was backed up from and the date and time on which the backup occurred.

For example,

P4 v1.06 Backup 2016-08-23-16-36-43.bak

, was backed up from version 1.06 on

August 23, 2016, at 16:36:43.

Open Backup Folder

Opens the folder in which the P4 database backup files are stored.

128 of 134

Send Database to PTAGIS

Used to send a backup file of the P4 database to PTAGIS for troubleshooting.

Export Layout

Used to export layout settings, which include the theme

, panel placement

and column arrangement

in

Record Management, to a file for transfer to another computer.

Import Layout

Used to import layout settings from a file.

Reset Layout

Used to reset layout settings to default.

Clear Database

Used to delete all data and configuration tools in the P4 database. As a precaution, the database will be backed up before this command is run.

Shrink Database

Used to shrink the size of the database files.

Set Password

Used to set a password to restrict access to Management and Configuration features. In order for a user to enter any of the features in these categories the password will need to be entered. If a set password is forgotten, contact PTAGIS for help with resetting it.

Set Folder

Used to set a default folder to which Sessions can be exported during data entry.

129 of 134

Send Database to PTAGIS

If asked to send a backup of the P4 database to PTAGIS, complete this form and click Send. Once the operation has completed, inform PTAGIS that the database has been sent.

130 of 134

Validation

Two types of validation checks are performed in P4: real time and post-data collection. Real time validation occurs when values are entered while a Session is open for data entry. Post-data collection validation can be performed in both Record and Session Management by user request, and is always performed when a

Session is submitted to PTAGIS.

Real-time Validation

By default P4 performs the following real-time validation checks during data entry:

·

·

Before a record can be Accepted, there must be a value in the PIT Tag, SRR Code, and Event Type fields.

Duplicate records within the open Session based on PIT Tag and Event Type.

·

PIT Tags are checked against the PTAGIS tag mask validation codes

Some real-time validation settings can be changed by the user in the

Profile .

·

Tag Mask Validation controls whether tag codes scanned or entered during data entry are checked against

· the PTAGIS tag mask validation codes.

Handle Duplicates controls what P4 will do when duplicate records are encountered.

·

Validation Constraints can be added to ensure that the Length and/or Weight values and/or Condition

Factor are within specified bounds.

Post-data Collection Validation

Validation of a Session can be initiated manually in both

Record Management and

Session Management , and it

runs automatically whenever a Session is submitted to PTAGIS. If any validation errors exist, the Session cannot be uploaded to PTAGIS until they are corrected. Post-data collection validation checks that all required fields have been completed, that date values are within expected ranges, warns if any records exist that fail

Validation Constraints , and runs any

Custom Validation routines that are enabled.

131 of 134

A

Adjust Dates, 115, 8, 107

Audible Alerts, 18, 27

Authorized Data Submitter, 103

Auto Accept Mode, 18, 20

B

Backup Database, 127

Batch Update, 83, 107, 84

Buffered Tag, 79

C

Collect, 12, 71

Column Chooser, 107, 116

Configuration Tools, 15, 16, 66, 69

Configure, 12, 15, 66, 69

Contact Information, 11, 12

Copy Sessions, 99

Current Record Values Panel, 75, 82

Custom Validation, 16, 53, 107, 116, 131

D

Data Entry, 75

Data Entry Layout, 16, 18, 23, 32, 72, 80

Database Log, 127

Date Time Offset, 8

Digitizer Map, 16, 22, 45, 47, 49, 84

Align, 45, 47, 84

Calibrate, 45, 47, 84

Digitizer Commands, 45, 49

Dot Out Records, 107, 123, 84, 97

Duplicate Handling, 18, 20

Duplicate Records, 131

E

Event Type, 7

Mark, 7

Passive Recapture, 7

Recapture, 7

Recovery, 7

Tally, 7, 78, 84

Export Configuration, 15, 69

Export Data, 99, 107, 116

F

File UDF, 18, 23

Fill Records, 107, 114

Filter Editor, 107, 116, 119

Find and Replace, 107, 112

Folder, 18, 23, 72, 74, 99

Index

132 of 134

G

Group By, 107, 116, 121

H

Hot Keys, 84, 86

I

Import Configuration, 15, 66, 67

Import CSV Data, 87, 90

Import Data, 71, 87, 94

Import Errors, 96

Import from Reader, 87, 92, 94

Import P3 Data, 87, 88

J

Join Sessions, 99, 104

K

Keyboard Shortcuts, 84, 86

M

Manage, 12, 97

Manage Database, 97, 127

Manage Records, 97, 107

Manage Sessions, 97, 99

N

New Session Defaults, 18, 23, 72

Nose Stop, 22

Notifications, 12, 14

O

Output Panel, 75, 77

P

Peripheral Device, 16, 18, 22, 40

Digitizer Tablet, 44, 22, 40

Input Device, 22

Reader, 22, 40

Profile, 16, 18, 23, 22, 20, 84, 80, 72

Project Defined Fields, 16, 18, 23, 51, 72, 80

Mask, 51

PDV, 51

Scope, 51

SPDV, 51

Q

Query, 116, 8, 97

R

Record Management, 8, 97, 107

Reject Record, 18, 20

Repeating Values, 16, 18, 23, 30, 80, 123, 84, 114, 92

Resequence, 107

133 of 134

Restore Database, 127

S

Send Database to PTAGIS, 127, 130

Session, 71, 72, 74, 75, 80, 107, 123

Session Log, 127

Session Management, 97, 99

Session Properties, 75, 80, 84, 107

Statistics Panel, 75, 78

Submit Data, 99, 103

T

Tag Action, 16, 18, 25, 35, 37

Tag Code Buffer Panel, 75, 79

Tag List, 16, 35, 37, 92, 116, 123

Tag Mask Validation, 18, 20, 55

Themes, 12

Timestamps, 107, 115, 8, 30

Tool Bar, 75, 84, 86

U

Update Query Results, 116, 122

Update Records from Session, 97, 125

Upload Data, 99, 103

Upload Operation, 103

V

Validation, 53, 99, 107, 131

Validation Codes, 15, 55

User Defined Validation Code, 55, 57, 58, 59, 60, 61, 62, 63, 64, 65

Validation Constraints, 18, 26

Condition Factor, 26

134 of 134

Appendix A - MRR Field Definitions and Requirements

MRR Session Fields

This table lists the fields available in P4 along with their definitions and expected domain values. Different Event Types may require different fields be completed before the data can be submitted to PTAGIS. If a field is listed as

Required than it must have a value. An Optional field can have a value, but does not need one. Both required and optional fields will be validated against the domain listed in this table. If a field is listed as Ignored, it may still contain a value but it will not be validated against the domain and it will not be loaded into PTAGIS if the record is submitted. All ignored fields will have a null value in PTAGIS for that event type.

Session fields, for which values will be the same for all records in a file, are listed on this page.

Event fields, which can have different values for each record in a file, are listed on the following pages.

P4 Display Name Definition Mark Recapture Recovery

Passive

Recapture

Notes

File

Legacy File

Name of the XML file submitted to

PTAGIS for loading.

Domain

PID-YYYY-DOY-UDF.xml

PID = Project Code

YYYY = 4-digit year of first Event Date in file

DOY = Day of year of first Event Date in file

UDF = User-defined

P3 file name format

Required

Required if correcting P3 file with P4 file

Required Required Required

Required if correcting P3 file with P4 file

Required if correcting P3 file with P4 file

Required if correcting P3 file with P4 file

If PID <> Project Code, the file will be loaded with Provisional status. If

Year does not match the year of the earliest Event Date in the file, the file will be rejected. If the Day of Year does not match the earliest Event

Date in the file, the file will be loaded with Provisional status.

Generated automatically when P3 file imported into P4. Cannot be changed.

Once a P3 file is corrected by a P4 file, the P3 file cannot be loaded again. Any additional corrections must be by P4 file.

Project Code

Session

Session Message

Session Note

Name of the P3 file that was imported into P4 to create the current session, if applicable.

Identifies the individual or long term research program responsible for the data collection event.

Name of the session in P4.

Brief description or summary of the purpose and/or scope of the MRR project.

Ad hoc annotations pertaining to the session as a whole.

MRR Project Validation Codes

Free text up to 50 characters

Free text up to 200 characters

Free text up to 4000 characters

Required

Required

Required

Optional

Required

Required

Required

Optional

Required

Required

Required

Optional

Required

Required

Required

Optional

Session name is required to create a session in P4. If XML file is created outside P4, use the File name as the Session name.

This has been required in the Spec Doc, but was not enforced in P3.

P4 Display Name

Acoustic Tag

Brood Year

Capture Method

Coded-Wire Tag

Conditional Comments

Detail Note

Event Date

Event Site

Event Type

Genetic ID

Hatchery

Hold Temp

Lat/Long Source

Latitude

Length

Life Stage

Longitude

Mark Method

Mark Temp

Migration Year

Organization

Other Tag

PIT Tag

MRR Event Fields

Definition

Acoustic tag code, if applicable.

Domain

Free text up to 50 characters

Mark

Optional

Calendar year when hatchery stock were spawned.

Method used to capture or collect fish.

Coded Wire Tag code, if applicable.

4-digit valid year between (Event Year - 3) and

Event Year

Capture Method Validation Codes

Free text up to 50 characters

Optional

Required

Optional

Flag codes to record fish condition, morphological and environmental factors, and other situational conditions.

Ad hoc annotations pertaining to the current record.

Local date and time the data collection event occurred.

Site identifier where the data collection event occurred.

The data collection event type represented by the record.

Unique identifier for genetic material taken from this fish.

Flag Validation Codes, space separated, max

17 codes allowed per record

Free text up to 200 characters

Date Time Offset between 1/1/1986 and current date

MRR Site Codes

Mark

Recapture

Recovery

Passive Recapture

Tally

Free text up to 50 characters

Optional

Optional

Required

Required

Required

Optional

Recapture

Optional

Ignored

Required

Optional

Optional

Optional

Required

Required

Recovery

Optional

Ignored

Required

Optional

Optional

Optional

Required

Required

Passive

Recapture

Ignored

Ignored

Required

Ignored

Optional

Optional

Required

Required

Notes

Ignored indicates that if data exists in that field in a record with that event type, it will be ignored when validating and loading the data into

PTAGIS.

Required

Optional

Required

Optional

Required

Ignored

Hatchery where fish was reared.

Method by which PIT tag was inserted into the fish.

Hatchery Validation Codes

Temperature (Cº) of water in the posttagging holding facilities.

Source for latitude and longitude coordinates:

If EventType is Mark or Recapture, this is the latitude of the release location. If

Event Type is Recovery or

PassiveRecapture, this is the latitude of the recovery or detection location.

Fork length of fish in millimeters. Precise

0-25.0 degrees Celsius. 25.0 is used to indicate temperature was not collected

GPS - collected with GPS

DIG - derived using digital map source

UNK - unknown

Decimal degrees between 40 and 50

The general life stage of the fish at the time of the event. Use Conditional

Comments to indicate more specific stages.

If Event Type is Mark or Recapture, this is the longitude of the release location. If

EventType is Recovery or

PassiveRecapture, this is the longitude of the recovery or detection location.

> 0

Adult

Juvenile

Unknown

Decimal degrees between -125 and -110

Optional

Required if

Latitude/

Longitude completed

Required if

Longitude completed

Optional

Required

Required if

Latitude completed

Tag Method Validation Codes

Optional

Required

Temperature (Cº) of tagging bath during marking operation.

Earliest possible calendar year when juvenile anadromous fish will out-migrate.

If tagging adult fish, this is the current calendar year.

Agency or entity responsible for the data collection event.

Identifier for any other tag or mark on this fish not captured elsewhere.

Unique 10 or 14-character code of the embedded PIT tag in hexadecimal format.

0-25.0 degrees Celsius. 25.0 is used to indicate temperature was not collected

4-digit year between (Event Date year) and

(Event Date year + 1)

Organization Validation Codes

Free text up to 50 characters

Tag Mask validation

Required

Required

Required

Optional

Required

Ignored

Optional

Required if

Latitude/

Longitude completed

Required if

Longitude completed

Optional

Required

Required if

Latitude completed

Ignored

Required

Required

Required

Optional

Required

Ignored Ignored

Ignored

Required if

Latitude/

Longitude completed

Optional

Required if

Latitude/

Longitude completed

Required if

Longitude completed

Optional

Required if

Longitude completed

Ignored

Required Optional

Required if

Latitude completed

Required if

Latitude completed

Ignored

Ignored

Ignored

Required

Optional

Required

Ignored

Ignored

Required

Required

Ignored

Required

Ignored indicates that if data exists in that field in a record with that event type, it will be ignored when validating and loading the data into

PTAGIS.

Ignored indicates that if data exists in that field in a record with that event type, it will be ignored when validating and loading the data into

PTAGIS.

Ignored indicates that if data exists in that field in a record with that event type, it will be ignored when validating and loading the data into

PTAGIS.

Ignored indicates that if data exists in that field in a record with that event type, it will be ignored when validating and loading the data into

PTAGIS.

Ignored indicates that if data exists in that field in a record with that event type, it will be ignored when validating and loading the data into

PTAGIS.

Records with Tally event type can only have dot-out as PIT tag code

P4 Display Name

Raceway/Transect/Tank

Radio Tag

Record #

Release Date

Release Site

Release Temp

RKM Ext

RKM Mask

Scale ID

Second PIT Tag

Spawn Year

SRR Code

Stock

Tagger

Text Comments

Weight

MRR Event Fields

Definition

Abbreviated description of the sampling location.

Radio tag code, if present.

Number of the record in the session.

Local date and time of release of marked or recaptured fish.

Site identifier for release location of marked or recaptured fish.

Temperature (Cº) of water the tagged fish were released into.

The distance in kilometers from the mouth of the stream location to the release or recovery location.

The RKM address from the mouth of the

Columbia River to the mouth of the stream location.

Unique identifier for scale sample taken from this fish.

Second PIT tag code if fish is double-

Use only when marking adult fish.

Calendar year when fish is expected to spawn.

Three-character code that identifies the species, run, and rear type of fish.

Brief descriptor of the brood stock of the fish.

Person responsible for marking operation.

Free text field for ad hoc comments unique to this fish.

Weight precise to a tenth of a gram at event date.

Domain

Free text up to 30 characters

Free text up to 50 characters

Integer > 0, unique within session

Date Time Offset between Event Date and current date

RKM Mask of MRR Site Code in Release Site

Free text up to 50 characters

Valid 10 or 14 character tag code in hexadecimal format

4-digit valid year between Event Year and

Event Year +1

SRR Verbose Validation Codes

Free text up to 15 characters

LastName FirstIntial (e.g. SMITH J) with maximum of 30 characters

Free text up to 100 characters

> 0

Mark

Optional

Optional

Required

Required if

Release Fields completed

MRR Site Codes not mark site only

0-25.0 degrees Celsius. 25.0 is used to indicate temperature was not collected

Integer

Required if

Release Fields completed

Required if

Release Fields completed

Optional only if

Release Site is selected and it is a stream location.

Display/Lookup field only

Optional

Optional

Optional

Required

Optional

Required

Optional

Optional

Recapture Recovery

Passive

Recapture

Notes

Optional

Optional

Required

Required if

Release Fields completed

Optional

Optional

Required

Ignored

Optional

Ignored

Required

Required if

Release Fields completed

Generated automatically in P4 and cannot be changed.

Release fields = Release Date, Release Site and Release Temp.

Release fields = Release Date, Release Site and Release Temp.

Required if

Release Fields completed

Required if

Release Fields completed

Optional only if

Release Site is selected and it is a stream location.

Optional

Ignored

Optional only if

Release Site is selected and it is a stream location.

Required if

Release Fields completed

Required if

Release Fields completed

Optional only if

Release Site is selected and it is a stream location.

For Recovery events, specify Release Site only if an RKM Ext. value needs to be specified.

Release fields = Release Date, Release Site and Release Temp

Must select Release Site in order to enter an RKM Ext. value.

Display/Lookup field only

Display/Lookup field only

Display/Lookup field only

Optional

Optional

Optional

Required

Optional

Required

Optional

Optional

Optional

Optional

Optional

Required

Optional

Ignored

Optional

Optional

Ignored

Optional

Optional

Required

Optional

Ignored

Optional

Ignored

In P4, the RKM Mask of the currently selected Release Site will be displayed.

Ignored indicates that if data exists in that field in a record with that event type, it will be ignored when validating and loading the data into

PTAGIS.

Mark Event

The event during which a fish is initially marked with a PIT tag and released (or planned to be released). Only one mark event is allowed for each PIT tag code. If additional mark events are submitted for the same PIT tag code, they will be categorized as Mark

Duplicates during the loading process.

Required Fields

All of these fields must be completed before the data can be submitted to PTAGIS.

Display Name Definition Domain

Mark

Event Type* The data collection event type represented by the record.

PIT Tag*

SRR Code*

Capture Method

Unique 10 or 14-character code of the embedded PIT tag in hexadecimal format.

Three-character code that identifies the species, run, and rear type of fish.

Method used to capture or collect fish.

Valid 10 or 14 character tag code in hexadecimal format. Tag Mask Validation

Codes.

Event Date

Event Site

Life Stage

Mark Method

Mark Temp

Local date and time the data collection event occurred.

Site identifier where the data collection event occurred.

The general life stage of the fish at the time of the event. Use

Conditional Comments to indicate more specific stages.

Method by which PIT tag was inserted into the fish.

Temperature (Cº) of tagging bath during marking operation.

SRR Verbose Validation Codes

Capture Method Validation Codes

Date Time Offset between 1/1/1986 and current date

MRR Site Codes

Adult

Juvenile

Unknown

Tag Method Validation Codes

0-25.0 degrees Celsius.

25.0 is used to indicate temperature was not collected

Migration Year

Organization

Record #

Tagger

Earliest possible calendar year when juvenile anadromous fish will out-migrate. If tagging adult fish, this is the current calendar year.

4-digit year between (Event Date year) and

(Event Date year + 1)

Agency or entity responsible for the data collection event.

Number of the record in the session.

Person responsible for marking operation.

* Minimum required fields to save a record during data entry.

Organization Validation Codes

Integer > 0, unique within session

LastName FirstIntial (e.g. SMITH J) with maximum of 30 characters

Mark Event

Mark Event

Conditionally Required Fields

If the fish will be held for a time before release, data can be submitted to PTAGIS without release information. When the fish have been released, an updated file with complete release information should be submitted. All release fields must be completed at that time.

Display Name

Release Date

Release Site

Release Temp

Definition

Local date and time of release of marked or recaptured fish.

Site identifier for release location of marked or recaptured fish.

Temperature (Cº) of water the tagged fish were released into.

Domain

Date Time Offset between Event Date and current date

MRR Site Codes not mark site only

0-25.0 degrees Celsius.

25.0 is used to indicate temperature was not collected

Mark Event

Mark Event

Optional Fields

Data can optionally be recorded in these fields.

Display Name

Acoustic Tag

Brood Year

Coded-Wire Tag

Conditional Comments

Detail Note

Genetic ID

Hatchery

Hold Temp

Latitude^

Longitude^

Definition

Acoustic tag code, if applicable.

Calendar year when hatchery stock were spawned.

Coded Wire Tag code, if applicable.

Flag codes to record fish condition, morphological and environmental factors, and other situational conditions.

Ad hoc annotations pertaining to the current record.

Unique identifier for genetic material taken from this fish.

Hatchery where fish was reared.

Temperature (Cº) of water in the post-tagging holding facilities.

Latitude coordinate of the Release Site

Longitude coordinate of the Release Site

Domain

Free text up to 50 characters

4-digit valid year between (Event Year - 3) and

Event Year

Free text up to 50 characters

Flag Validation Codes, space separated, max

17 codes allowed per record

Free text up to 200 characters

Free text up to 50 characters

Hatchery Validation Codes

0-25.0 degrees Celsius.

25.0 is used to indicate temperature was not collected

Decimal degrees between 40 and 50

Decimal degrees between -125 and -110

GPS - collected with GPS

DIG - derived using digital map source

UNK - unknown

> 0

Lat/Long Source^

Length

Other Tag

Raceway/Transect/Tank

Radio Tag

RKM Ext

Scale ID

Second PIT Tag

Spawn Year

Stock

Text Comments

Weight

Source for latitude and longitude coordinates:

Fork length of fish in millimeters. Precise to 1 millimeter.

Identifier for any other tag or mark on this fish not captured elsewhere.

Abbreviated description of the sampling location.

Radio tag code, if present.

The distance in kilometers from the mouth of the stream location to the release or recovery location.

Unique identifier for scale sample taken from this fish.

Second PIT tag code if fish is double-tagged.

Use only when marking adult fish. Calendar year when fish is expected to spawn.

Brief descriptor of the brood stock of the fish.

Free text field for ad hoc comments unique to this fish.

Weight precise to a tenth of a gram at event date.

^ If any of these fields are completed, all must be completed

Free text up to 50 characters

Free text up to 30 characters

Free text up to 50 characters

Integer

Free text up to 50 characters

Valid 10 or 14 character tag code in hexadecimal format

4-digit valid year between Event Year and

Event Year +1

Free text up to 15 characters

Free text up to 100 characters

> 0

Mark Event

Recapture Event

The event during which a previously PIT-tagged fish is recaptured, scanned by hand, handled and released (or planned to be released). Multiple recapture events are allowed for each PIT tag code as long as the Event Dates are different. If an additional recapture is reported with the same Event Date of a previously reported recapture for the same tag, it will be categorized as a

Recapture Duplicate during the loading process.

Required Fields

All of these fields must be completed before the data can be submitted to PTAGIS.

Display Name Definition

Event Type*

PIT Tag*

SRR Code*

Capture Method

The data collection event type represented by the record.

Unique 10 or 14-character code of the embedded PIT tag in hexadecimal format.

Three-character code that identifies the species, run, and rear type of fish.

Method used to capture or collect fish.

Event Date

Event Site

Life Stage

Mark Temp

Local date and time the data collection event occurred.

Site identifier where the data collection event occurred.

The general life stage of the fish at the time of the event. Use

Conditional Comments to indicate more specific stages.

Temperature (Cº) of tagging bath during marking operation.

Domain

Recapture

Tag Mask validation

SRR Verbose Validation Codes

Capture Method Validation Codes

Date Time Offset between 1/1/1986 and current date

MRR Site Codes

Adult

Juvenile

Unknown

0-25.0 degrees Celsius. 25.0 is used to indicate temperature was not collected

Migration Year

Organization

Record #

Tagger

Earliest possible calendar year when juvenile anadromous fish will out-migrate. If tagging adult fish, this is the current calendar year.

4-digit year between (Event Date year) and

(Event Date year + 1)

Agency or entity responsible for the data collection event.

Number of the record in the session.

Person responsible for marking operation.

* Minimum required fields to save a record during data entry.

Organization Validation Codes

Integer > 0, unique within session

LastName FirstIntial (e.g. SMITH J) with maximum of 30 characters

Recapture Event

Conditionally Required Fields

If the fish will be held for a time before release, data can be submitted to PTAGIS without release information. When the fish have been released, an updated file with complete release information should be submitted. All release fields must be completed at that time.

Display Name

Release Date

Release Site

Release Temp

Definition

Local date and time of release of marked or recaptured fish.

Site identifier for release location of marked or recaptured fish.

Temperature (Cº) of water the tagged fish were released into.

Domain

Date Time Offset between Event Date and current date

MRR Site Codes not mark site only

0-25.0 degrees Celsius. 25.0 is used to indicate temperature was not collected

Recapture Event

Optional Fields

Data can optionally be recorded in these fields.

Display Name

Acoustic Tag

Coded-Wire Tag

Conditional Comments

Detail Note

Genetic ID

Hold Temp

Latitude^

Longitude^

Definition

Acoustic tag code, if applicable.

Coded Wire Tag code, if applicable.

Flag codes to record fish condition, morphological and environmental factors, and other situational conditions.

Ad hoc annotations pertaining to the current record.

Unique identifier for genetic material taken from this fish.

Temperature (Cº) of water in the post-tagging holding facilities.

Latitude coordinate of the Release Site

Longitude coordinate of the Release Site

Domain

Free text up to 50 characters

Free text up to 50 characters

Flag Validation Codes, space separated, max

17 codes allowed per record

Free text up to 200 characters

Free text up to 50 characters

0-25.0 degrees Celsius. 25.0 is used to indicate temperature was not collected

Decimal degrees between 40 and 50

Decimal degrees between -125 and -110

GPS - collected with GPS

DIG - derived using digital map source

UNK - unknown

> 0

Lat/Long Source^

Length

Other Tag

Raceway/Transect/Tank

Radio Tag

RKM Ext

Scale ID

Second PIT Tag

Spawn Year

Stock

Text Comments

Weight

Source for latitude and longitude coordinates:

Fork length of fish in millimeters. Precise to 1 millimeter.

Identifier for any other tag or mark on this fish not captured elsewhere.

Abbreviated description of the sampling location.

Radio tag code, if present.

The distance in kilometers from the mouth of the stream location to the release or recovery location.

Unique identifier for scale sample taken from this fish.

Second PIT tag code if fish is double-tagged.

Use only when marking adult fish. Calendar year when fish is expected to spawn.

Brief descriptor of the brood stock of the fish.

Free text field for ad hoc comments unique to this fish.

Weight precise to a tenth of a gram at event date.

^ If any of these fields are completed, all must be completed

Free text up to 50 characters

Free text up to 30 characters

Free text up to 50 characters

Integer

Free text up to 50 characters

Valid 10 or 14 character tag code in hexadecimal format

4-digit valid year between Event Year and

Event Year +1

Free text up to 15 characters

Free text up to 100 characters

> 0

Recapture Event

Ignored Fields

Data in these fields will be ignored for Recapture events. No validation checks will be performed on these fields and if data exists

Display Name

Brood Year

Hatchery

Mark Method

Definition

Calendar year when hatchery stock were spawned.

Hatchery where fish was reared.

Method by which PIT tag was inserted into the fish.

Domain

4-digit valid year between (Event Year - 2) and

Event Year

Hatchery Validation Codes

Tag Method Validation Codes

Recovery Event

The event during which a previously released PIT tag is recovered from or detected in a dead fish, or is recovered or detected as a bare tag, or is removed from the possibility of being recaptured or detected in the future. Multiple recovery events are allowed for each PIT tag code as some PIT tags, while obviously no longer in a living fish, may be detected multiple times without a physical recovery (e.g. carcass surveys, avian nesting sites). A recovery event that is reported for the same PIT tag with the same

Event Date as a previously reported recovery event will be classified as a Recovery Duplicate during the loading process.

Required Fields

All of these fields must be completed before the data can be submitted to PTAGIS.

Display Name Definition

Event Type*

PIT Tag*

SRR Code*

Capture Method

The data collection event type represented by the record.

Unique 10 or 14-character code of the embedded PIT tag in hexadecimal format.

Three-character code that identifies the species, run, and rear type of fish.

Method used to capture or collect fish.

Event Date

Event Site

Local date and time the data collection event occurred.

Site identifier where the data collection event occurred.

Life Stage

Organization

Record #

The general life stage of the fish at the time of the event. Use

Conditional Comments to indicate more specific stages.

Agency or entity responsible for the data collection event.

Number of the record in the session.

* Minimum required fields to save a record during data entry.

Domain

Recovery

Tag Mask validation

SRR Verbose Validation Codes

Capture Method Validation Codes

Date Time Offset between 1/1/1986 and current date

MRR Site Codes

Adult

Juvenile

Unknown

Organization Validation Codes

Integer > 0, unique within session

Recovery Event

Optional Fields

Data can optionally be recorded in these fields.

Display Name

Acoustic Tag

Coded-Wire Tag

Conditional Comments

Detail Note

Genetic ID

Latitude^

Longitude^

Definition

Acoustic tag code, if applicable.

Coded Wire Tag code, if applicable.

Flag codes to record fish condition, morphological and environmental factors, and other situational conditions.

Ad hoc annotations pertaining to the current record.

Unique identifier for genetic material taken from this fish.

Latitude coordinate of the Release Site

Longitude coordinate of the Release Site

Domain

Free text up to 50 characters

Free text up to 50 characters

Flag Validation Codes, space separated, max

17 codes allowed per record

Free text up to 200 characters

Free text up to 50 characters

Decimal degrees between 40 and 50

Decimal degrees between -125 and -110

GPS - collected with GPS

DIG - derived using digital map source

UNK - unknown

> 0

Lat/Long Source^

Length

Other Tag

Raceway/Transect/Tank

Radio Tag

Source for latitude and longitude coordinates:

Fork length of fish in millimeters. Precise to 1 millimeter.

Identifier for any other tag or mark on this fish not captured elsewhere.

Abbreviated description of the sampling location.

Radio tag code, if present.

Free text up to 50 characters

Free text up to 30 characters

Free text up to 50 characters

Release Site

RKM Ext

Scale ID

Second PIT Tag

Spawn Year

Stock

Text Comments

Weight

Site identifier for recovery location of fish or tag. Only use this if an RKM extension needs to be specified for the recovery location. MRR Site Codes not mark site only

The distance in kilometers from the mouth of the stream location to the recovery location.

Integer

Unique identifier for scale sample taken from this fish.

Second PIT tag code if fish is double-tagged.

Use only when marking adult fish. Calendar year when fish is expected to spawn.

Free text up to 50 characters

Valid 10 or 14 character tag code in hexadecimal format

4-digit valid year between Event Year and

Event Year +1

Brief descriptor of the brood stock of the fish.

Free text field for ad hoc comments unique to this fish.

Weight precise to a tenth of a gram at event date.

^ If any of these fields are completed, all must be completed

Free text up to 15 characters

Free text up to 100 characters

> 0

Recovery Event

Ignored Fields

Data in these fields will be ignored for Recapture events. No validation checks will be performed on these fields and if data exists

Display Name

Brood Year

Hatchery

Hold Temp

Mark Method

Mark Temp

Definition

Calendar year when hatchery stock were spawned.

Hatchery where fish was reared.

Temperature (Cº) of water in the post-tagging holding facilities.

Method by which PIT tag was inserted into the fish.

Temperature (Cº) of tagging bath during marking operation.

Domain

4-digit valid year between (Event Year - 2) and

Event Year

Hatchery Validation Codes

0-25.0 degrees Celsius. 25.0 is used to indicate temperature was not collected

Tag Method Validation Codes

0-25.0 degrees Celsius. 25.0 is used to indicate temperature was not collected

Migration Year

Release Date

Release Temp

Tagger

Earliest possible calendar year when juvenile anadromous fish will out-migrate. If tagging adult fish, this is the current calendar year.

Local date and time of release of marked or recaptured fish.

Temperature (Cº) of water the tagged fish were released into.

Person responsible for marking operation.

4-digit year between (Event Date year) and

(Event Date year + 1)

Date Time Offset between Event Date and current date

0-25.0 degrees Celsius. 25.0 is used to indicate temperature was not collected

LastName FirstIntial (e.g. SMITH J) with maximum of 30 characters

Passive Recapture Event

The event during which a previously PIT-tagged fish is detected by unattended or remotely operated detection equipment at a location other than an interrogation site and is not handled. It differs from a Recapture event in that the fish is not handled, only detected. It differs from an interrogation record in that the detection occurs opportunistically in a location that is not a registered interrogation site. Multiple passive recapture events are allowed for each PIT tag code as long as the Event Dates are not the same.

Required Fields

All of these fields must be completed before the data can be submitted to PTAGIS.

Display Name Definition

Event Type*

PIT Tag*

SRR Code*

Capture Method

The data collection event type represented by the record.

Unique 10 or 14-character code of the embedded PIT tag in hexadecimal format.

Three-character code that identifies the species, run, and rear type of fish.

Method used to capture or collect fish.

Event Date

Event Site

Local date and time the data collection event occurred.

Site identifier where the data collection event occurred.

Domain

Passive Recapture

Tag Mask validation

SRR Verbose Validation Codes

Use 00U for Unknown (fish not observed)

Capture Method Validation Codes

Date Time Offset between 1/1/1986 and current date

MRR Site Codes

Migration Year

Organization

Record #

Earliest possible calendar year when juvenile anadromous fish will out-migrate. If tagging adult fish, this is the current calendar year.

Agency or entity responsible for the data collection event.

Number of the record in the session.

* Minimum required fields to save a record during data entry.

4-digit year between (Event Date year) and

(Event Date year + 1)

Organization Validation Codes

Integer > 0, unique within session

Passive Recapture Event

Conditionally Required Fields

If the fish will be held for a time before release, data can be submitted to PTAGIS without release information. When the fish have been released, an updated file with complete release information should be submitted. All release fields must be completed at that time.

Display Name Definition

Release Date

Release Site

Release Temp

Local date and time of release of marked or recaptured fish.

Site identifier for release location of marked or recaptured fish.

Temperature (Cº) of water the tagged fish were released into.

Domain

Date Time Offset between Event Date and current date

MRR Site Codes not mark site only

0-25.0 degrees Celsius. 25.0 is used to indicate temperature was not collected

Passive Recapture Event

Optional Fields

Data can optionally be recorded in these fields.

Display Name

Conditional Comments

Detail Note

Life Stage

Latitude^

Longitude^

Definition

Flag codes to record fish condition, morphological and environmental factors, and other situational conditions.

Ad hoc annotations pertaining to the current record.

The general life stage of the fish at the time of the event. Use

Conditional Comments to indicate more specific stages.

Latitude coordinate of the Release Site

Longitude coordinate of the Release Site

Domain

Flag Validation Codes, space separated, max

17 codes allowed per record

Free text up to 200 characters

Adult

Juvenile

Unknown

Decimal degrees between 40 and 50

Decimal degrees between -125 and -110

GPS - collected with GPS

DIG - derived using digital map source

UNK - unknown

Free text up to 30 characters

Free text up to 50 characters

Lat/Long Source^

Raceway/Transect/Tank

Radio Tag

RKM Ext

Second PIT Tag

Spawn Year

Stock

Text Comments

Source for latitude and longitude coordinates:

Abbreviated description of the sampling location.

Radio tag code, if present.

The distance in kilometers from the mouth of the stream location to the recovery location.

Second PIT tag code if fish is double-tagged.

Use only when marking adult fish. Calendar year when fish is expected to spawn.

Brief descriptor of the brood stock of the fish.

Free text field for ad hoc comments unique to this fish.

^ If any of these fields are completed, all must be completed

Integer

Valid 10 or 14 character tag code in hexadecimal format

4-digit valid year between Event Year and

Event Year +1

Free text up to 15 characters

Free text up to 100 characters

Ignored Fields

Passive Recapture Event

Data in these fields will be ignored for Recapture events. No validation checks will be performed on these fields and if data exists

Display Name

Acoustic Tag

Brood Year

Coded-Wire Tag

Genetic ID

Hatchery

Hold Temp

Length

Mark Method

Mark Temp

Other Tag

Scale ID

Tagger

Weight

Definition

Acoustic tag code, if applicable.

Calendar year when hatchery stock were spawned.

Coded Wire Tag code, if applicable.

Unique identifier for genetic material taken from this fish.

Hatchery where fish was reared.

Temperature (Cº) of water in the post-tagging holding facilities.

Fork length of fish in millimeters. Precise to 1 millimeter.

Method by which PIT tag was inserted into the fish.

Temperature (Cº) of tagging bath during marking operation.

Identifier for any other tag or mark on this fish not captured elsewhere.

Unique identifier for scale sample taken from this fish.

Person responsible for marking operation.

Weight precise to a tenth of a gram at event date.

Domain

Free text up to 50 characters

4-digit valid year between (Event Year - 2) and

Event Year

Free text up to 50 characters

Free text up to 50 characters

Hatchery Validation Codes

0-25.0 degrees Celsius. 25.0 is used to indicate temperature was not collected

> 0

Tag Method Validation Codes

0-25.0 degrees Celsius. 25.0 is used to indicate temperature was not collected

Free text up to 50 characters

Free text up to 50 characters

LastName FirstIntial (e.g. SMITH J) with maximum of 30 characters

> 0

Tally Event

The event during which an un-tagged fish is sampled or counted without being marked with a PIT tag. Tally events must have 10 dots as the PIT tag code and will be ignored when submitted to PTAGIS for loading.

User defined validation codes can be used in Tally event records. Tally events can be included in files with data that will be submitted to PTAGIS. The records will be exported along with regular PIT tag data, but will be ignored when the file is loaded. The only exception if if a Tally record contains a valid PIT tag code, the file will be rejected. Any records with valid PIT tag codes must be one of the other four Event Types.

advertisement

Was this manual useful for you? Yes No
Thank you for your participation!

* Your assessment is very important for improving the workof artificial intelligence, which forms the content of this project

Related manuals

Download PDF

advertisement

Table of contents