wiki:SIS/UI/Tutorial-v1.0/StationSummary

Version 3 (modified by skientz, 5 years ago) (diff)

--


                          This Page Under Construction 

SIS Tutorial: Station Summary Page

Introduction

Create New Station

Station Summary Page Contents

Station Header

Station Hardware and Channels

Links and Feeds

Station Links

User Links

Feed: Recent Email Updates

Feed: Taskzilla Open Tickets

User Actions

Send Email

Update Station Instruments

  1. Install a new logger and its sensor(s)
  2. Add a Sensor to an existing Logger
  3. Sensor/Logger swap
  4. Sensor/Logger temporary removal
  5. Sensor/Logger reinstall
  6. Sensor removal to end channels
  7. Terminate Station

Create New Station Log

Update Power Devices

  1. Install a new device
  2. Swap a device
  3. Remove a device

Update Telemetry Devices

  1. Install a new device
  2. Swap a device
  3. Remove a device

Power Installations

Create Historical Power Installation Epoch

Edit Existing Power Installation Epoch

Telemetry Installations

Create Historical Telemetry Installation Epoch

Edit Existing Telemetry Installation Epoch

Introduction

This document describes how to use the Station Summary Page to manage an individual station’s metadata. The Station Summary page displays information specific to the station. For authenticated users, the station summary page shows links to modify the station metadata.

Conventions

The date format YYYY-MM-DD is used in this form and other forms in the UI. The date 3000/01/01 is used in SIS to indicate an ‘active’ epoch for stations/channels/etc.

Form Tip: If you do not want to submit the form, then click the Back button on your browser to return to the page you were at previously. You can do this for virtually all forms in the SIS UI. Exceptions will be noted as needed.

Create New Station

From the SIS Home Page, click the ‘Jump to Station’ link to get to the form.

Select the netcode from the Network drop-down menu, and enter the station code in the Station code text box (your entry for the station code) is converted to uppercase before being processed by the database). Click the button to submit the form.

Figure 1: Jump to Station form

The (netcode, stationcode) uniquely identifies a station in the SIS database.

If the submitted netcode and stationcode matches a station in the database, you are re-directed to the station’s summary page, else you are re-directed to the Station Form:

Figure 2. Station Form

The Station Form displays the fields of the station header (required fields are in bold).

Enter the values and submit the form to create a new station in the database. If there are no errors in the submitted data, you are re-directed to the new station’s summary page.

Station Summary Page Contents

The Station Summary Page consists of several modules. Many of the modules display links to other pages in SIS. The modules are:

Station Header

The station header module displays the fields of the station header, along with a mini JumptoStation form to navigate to another station:

Figure 3. Station Header module in the Summary page (example for station CI.XX1)

Authenticated users see the link ‘Edit’ adjacent to the Station header last-modified timestamp.

To edit the station header, click on the Edit link which takes you to the Station Form where you can edit the information and submit the form to update the database.

Station Last Log

A station can have one or more log entries. If the station has log entries, the most recent log entry is displayed below the station header module. (See the User Actions section below on how to create a log entry).

Station Hardware and Channels

This section contains the following modules:

Instruments

The current datalogger(s) and sensor(s) are displayed. Click on the 'serialnumber' link of an instrument to get to its summary page. The last instrument activity shows the latest epoch on/offdate and the reason. (See the Channel Manager for more information about the channels epochs and reason).

For stations whose metadata is imported (i.e., SCSN is not the authoritative source):

  • The imported station’s channel responses are not linked with any instruments from the SIS inventory.
  • The reason for the latest epoch is IMPORT SEED.

The information in the Instruments module can be manipulated via the Update Station Instruments action, or via the Channel Manager.

Power Devices

The current power devices are displayed. Click on the device link to get to its summary page. The information in this module can be manipulated via the ‘Update Power devices’ action.

Telemetry Devices

The current power devices are displayed. Click on the device link to get to its summary page. The information in this module can be manipulated via the ‘Update Telemetry devices’ action.

Telemetry Connections

The current telemetry connections are displayed (under development).

Current Channels

The active channels are listed along with select fields of their active configuration epoch. See the Channel Manager section for more details.

Links and Feeds

This section contains links, and depending on the station, some feed displays from web services.

Channel/Response
  1. Instrument history by date: report of the logger and sensor installation history at this station.
  2. Channel configuration epochs: report of select fields of the station’s channel configuration epochs.
  3. Instrument history by channel: report of the logger and sensor installation history by channel. (The instrument-history-by-fate report is an aggregate view that collapses the channel information.)
  4. Channel Manager: This section allows the user to view and modify the metadata of individual channels. (See the Channel Manager section for more details.)
Installations/Logs
  1. Station Logs: shows all the log entries for the station. Click on the subject to see the full entry. For authenticated users, there is a link to create a new log entry. (See User Actions for instructions).
  2. Power installations: shows all the Power device installations at the station (historical epochs and current).
  3. Telemetry installations: shows all the Telemetry device installations at the station (historical epochs and current).
  1. SCSN Operators list email archive for the station
  2. SCSN Operators Contact information for the station

Links for authenticated users. See the User Actions section for more detail.

Feed: Recent Email Updates

This is an SCSN-specific module that relies on a web service from the SCSN Email updates archive. The service provides the subject, date, and sender-email of the last 5 email updates for this station. Click on the subject link to see its entry in the email archive. Note: The email archive requires additional authentication if viewed from outside of Caltech.

Feed: Taskzilla Open Tickets

This is an SCSN-specific module that relies on a web service from the SCSN Taskzilla (Bugzilla) software. The service provides the description, product and last-modified fields of the open issues in Taskzilla for this station. Click on the description to see its Taskzilla entry.

Note: The Taskzilla software requires additional authentication if viewed from outside of Caltech.

Requirement: The task subject must contain the station code in order for the web service to identify the task as being associated with the station.

User Actions

This module contains links for authenticated users.

Send Email

This form is to send an email concerning the station. It can be used to report any actions that have been recorded for this station in SIS.

Figure 4. Station Email Form

The form fields are:

Check the numbering here and fix
  1. From: initialized with the user’s email address.
  2. Recipient:
  1. Production site: the field is initialized with the SCSN Operators list email address.
  2. Test site: the field is initialized with the user’s email address.
  3. You may enter a comma-separated list of valid email addresses.
  1. Subject: initialized with the station code
  2. Message: initialized with a template commonly used by SCSN operators to report field work. It includes a short description of any user actions recorded via the UI.
  1. Note: the station contact URL is an SCSN-specific link
  2. Log email: Check this box to automatically create a station log entry in the database from the subject and message fields of the email form.

Edit the template as needed and click the ‘Send email’ button to send the email to listed recipient(s).

Update Station Instruments

This form is used to update the station’s current channel response using a set of pre-defined ‘field actions’. Each ‘field action’ encapsulates the requisite database changes required for common actions such as installing instruments, replacing, and removing them. Limitation: This form cannot be used to record historic changes, that is, the action must apply to the instruments currently installed at the station, or to install new current instruments at the station.

For more fine-grained control over the channel response, please see the Channel Manager section in this document.

First, the user must select the field action to be done, and specify the GMT datetime of the action.

  1. Install a new logger and its sensor(s)

This action is used for:

  1. A new station with no instruments
  2. Adding an additional datalogger at a station with its own sensor(s).

Click on the drop-down menu for ‘Station actions’ in the form:

Figure 5. Update Station Instruments Form: select Station action

Note the Tips section below the form on the page. It describes the station-actions which are:

  • Add a new logger and its sensor(s)
  • Select this action to install a new logger and one or more sensors at a locationcode.
  • Terminate Station
  • This removes all online instruments, end all online channels, and set the station offdate.

Enter the GMT datetime of the installation in either the YYYY-MM-DD format or YYYY-JJJ format where JJJ is the 3-digit ordinal date (1 - 366). The time format is HH:MM:SS. Click Continue.

Reminder: You can press the back button on your browser to navigate away from the page without making any changes.

The next step is to select the logger and sensor(s) from the inventory:

Figure 6. Install new logger and sensor(s) form

The install date submitted from the previous form is displayed in the page. (If it is incorrect, navigate back to the previous page to correct the date and re-submit the form).

The fields for this form are:

  1. Loggertype: Select the logger model of the logger to be installed from the loggertype dropdown.
  2. Logger !S/N: The !S/N dropdown is then populated with the available loggers of the selected loggertype.
  1. ONLY loggers having inventory status=INVENTORY are displayed in the dropdown.
  2. Select the serialnumber of the logger to be installed.
  1. Configuration: The Channel configuration dropdown is populated with the available channelset(s) for the selected loggertype. The default selection is the most common use for SCSN stations.
  2. Sensortype: select the sensor model of the first sensor from the sensortype dropdown.
  3. Sensor !S/N: The !S/N dropdown is then populated with the available sensors of the selected sensortype.
  1. ONLY sensors have inventory status=INVENTORY are displayed in the dropdown.
  2. Select the serialnumber of the sensor to be installed.
  1. Depth: the sensor emplacement depth (units of meters) in the Depth textbox (default=0).
  2. Channels: The Channel configuration dropdown is populated with the available channelset(s) for the selected sensortype. The default selection is the most common for SCSN stations.
  3. Locationcode: The default locationcode for SCSN stations is 2 blank characters: ‘ ‘. The convention is to accept 2 dashes ‘--’ as equivalent to the default locationcode. If the sensor is using another locationcode (e.g. 00, 01, etc), then edit the value in the Loc textbox.
  4. If the logger has another sensor, click the ‘Add another Sensor’ button which updates the form with a new set of dropdowns for a next sensor. Repeat Items #4-8 for the next sensor.

Below the form is a ‘preview’ of the expected channels that will be produced once the form has been submitted. It displays:

  1. A diagram of the logger’s boards and modules and shows how its sensitivity response is assigned to which channels.
  2. A diagram of each sensor’s components and shows how its sensitivity response is assigned to which channels. Within the sensor’s diagram are textboxes for the azimuth and dip of each sensor component. The textboxes are initialized with the most commonly used defaults. You may edit them here, or use the Channel Manager (see the Channel Manager document for more information).

Finally, click Submit to update the database. At this time, the following database updates are done:

  1. A set of active channel epochs will be created whose epoch ondate is the GMT datetime specified earlier, and whose epoch offdate is active (3000/01/01 is the SIS convention for active offdate). The set of channels created is determined from the submitted logger Configuration entry and the sensor Channels entry.
  2. The channel epochs will be linked to the instrument response of the selected logger and sensor(s), and their simpleresponse is calculated.
  3. The inventory status of the selected logger and sensor(s) is changed to INSTALLED.

If there are no errors in the above steps, you are re-directed back to the Station Summary page. The Instruments module displays the instruments you just installed. The link on the instrument serialnumber takes you to the instrument’s summary page.

The active channels are displayed in the Current Channels module.

Note: To correct or delete the update you just made, you need to use the Channel Manager (see the Channel Manager document for more information).

  1. Add a Sensor to an existing Logger

This action is used for the case of:

  1. A sensor was installed at a later time to an existing logger,
  2. You only installed one sensor in the ‘Install a logger and its sensor(s)’ action and you wish to install another.

From the Station Summary page, Click on the ‘Update Station Instruments’ link in the User links module. The form now displays the currently installed loggers and sensors with an Action dropdown menu next to each instrument:

Figure 7. Update Station Instruments: select action for existing instrument

From the Action menu of the logger, select the ‘Add a sensor’ option. Enter the GMT datetime of the action and click Continue. The next step is to select the sensor from the inventory:

Figure 8. Update Station Instruments: Add a sensor to an existing logger

The install date submitted from the previous form is displayed in the page. (If it is incorrect, return to the previous page to re-submit the form). The fields for this form are:

  1. Locationcode: The default is 2 blank characters (displayed as 2 dashes in the form).
  2. If the channels of this sensor are not using the default loccode, then edit the textbox.
  3. Sensortype: Select the sensor model of the sensor to be installed from the dropdown.
  4. Serialnumber: Select the serialnumber of the sensor to be installed from the dropdown.
  5. Only sensors having inventory status=INVENTORY appear in the dropdown.
  6. Channels: The channelset to use for the sensor. The default selection is the most common.
  7. Logger configuration: The channelset to use for the logger. The default selection is the most common for SCSN stations.
  8. Latitude, Longitude, Elevation: The textboxes are initialized with the station’s coordinates.
  9. If the sensor has different coordinates, then edit the textboxes with the values to use for the channels belonging to that sensor.
  10. Emplacement depth: Positive downward value in meters. Defaults to 0.

Enter the values and click Submit to update the database. At this time, new active channel epochs are created and the sensor’s inventory status is changed to INSTALLED in the database. If there are no errors in the above steps, you are re-directed back to the Station Summary page where you should see the new sensor displayed in the Instruments module.

  1. Sensor/Logger swap

This action is used when:

  1. A sensor currently installed at the station is swapped out with another sensor that is currently in the inventory. The new sensor may be of a different model than the old one.
  2. A logger currently installed at the station is swapped out with another sensor that is currently in the inventory. The new logger may be of a different model than the old one.

Limitation: You cannot use the Swap action to replace an accelerometer with a velocity-transducer or barometer (or vice versa). The new sensor must be of the same category (i.e. an Accelerometer is swapped for another, a Velocity-Transducer is swapped for another).

From the Station Summary page, Click on the ‘Update Station Instruments’ link in the User links module.

  1. From the Action menu of the instrument to be replaced, select the ‘Swap’ option. Enter the GMT datetime of the swap action and click Continue.
  2. The next step is to select the new instrument from the inventory. Select the model and serialnumber of the new instrument and submit the form to update the database.
  3. Only instruments having inventory status=INVENTORY appear in the dropdown.
  4. At this time, the following database changes are made:
  5. The channel epochs belonging to the old instrument are ended (their offdate is set to the swap date).
  6. New active channel epochs are created whose ondate is equal to the swap date. Their response stages use the new instrument’s response.
  7. The old instrument’s inventory status is set to INVENTORY.
  8. The new instrument’s inventory status is set to INSTALLED.

If there are no errors in the above steps, you are re-directed back to the Station Summary page where you should see the new instrument in the Instruments module. If multiple instruments were swapped at the same time, return to the Update Station Instruments form and use the same swap date to swap out another instrument.

  1. Sensor/Logger temporary removal

This action is used when the instrument at the station is temporarily un-installed with the intention of re-installing it at a later date. From the Station Summary page, Click on the ‘Update Station Instruments’ link in the User links module. From the Action menu of the instrument to be temporarily removed, select the ‘Remove to reinstall later’ option.

Enter the GMT datetime of the removal and submit the form. At this time, the following database changes are made:

  1. The current active channel epochs belonging to the removed instrument are ended (their offdate is set to the removal date).
  2. New active channel epochs are created whose ondate is the removal date, with a flag indicating that they have no instrument gain for this epoch.
  3. The removed instrument’s inventory status is set to REPAIR.

If there are no errors in the above steps, you are re-directed back to the station summary page. The last instrument activity should display the reason ‘SENSOR REMOVED’ if you removed a sensor or ‘LOGGER REMOVED’ if you removed a logger. The removed instrument appears in the Instruments module with the words ‘Not currently installed’ next to it. The channels belonging to the removed instrument appear in the Current Channels module, but with no gain for their current epoch.

  1. Sensor/Logger reinstall

This is the reverse action of the ‘Sensor/Logger temporary removal’ action.

Note: this action is to re-install the SAME instrument at the station; if the same instrument is not re-installed, you need to use the Swap action to install a different instrument.

From the Station Summary page, Click on the ‘Update Station Instruments’ link in the User links module. From the Action menu of the instrument that is temporarily removed, select the ‘Reinstall’ option:

Figure 9. Update Station Instruments - select reinstall option

Enter the GMT datetime of the re-install and submit the form. At this time, the following database changes are made:

  1. The current active channel epochs belonging to the instrument are ended (their offdate is set to the reinstall date). Reminder: these channel epochs have no instrument gain.
  2. New active channel epochs are created whose ondate is the reinstall date and their simplereponse is calculated.
  3. The instrument’s inventory status is set to INSTALLED.

If there are no errors in the above steps, you are re-directed back to the station summary page. The last instrument activity should display the reason ‘SENSOR REINSTALL’ if you reinstalled a sensor or ‘LOGGER REINSTALL’ if you reinstalled a logger.

  1. Sensor removal to end channels

This action is used to permanently remove a sensor and set the offdate of the channels belonging to the sensor. From the Station Summary page, Click on the ‘Update Station Instruments’ link in the User links module. From the Action menu of the sensor to be permanently removed, select the ‘Terminate (remove + end its channels)’ option.

Enter the GMT datetime of the action and submit the form. At this time, the following database changes are made:

  1. The current active channel epochs belonging to the offlined sensor are ended (their offdate is set to the remove date).
  2. The channel header offdate for each of those channels is ended (their offdate is set to the remove date) to indicate there will be no further epochs for this channel.

If there are no errors in the above steps, you are re-directed back to the station summary page. The Current Channels module should no longer display the ended channels of the offlined sensor. However, the channel headers and their epochs still exist in the database, and can be modified via the Channel Manager.

  1. Terminate Station

From the Station Summary page, Click on the ‘Update Station Instruments’ link. From the Station action dropdown menu: select the ‘Terminate Station’ option. Enter the GMT datetime to use for the station offdate and submit the form. At this time, the following database changes are made:

  1. Remove all instruments from the station and return them to the inventory
  2. Set the offdate of all currently active channel epochs at the station to the submitted offdate
  3. Set the channel header offdate of all currently active channels at the station to the submitted offdate.
  4. Set the station header offdate to the submitted offdate.

If there are no errors in the above steps, you are re-directed back to the Station Summary Page which should now display the word ‘inactive’ next to the Station name. To edit the station offdate, use the Edit link in the Station Header module. To edit the channel and channel epoch offdates, use the Channel Manager.

Create New Station Log

This form is for creating a new station log entry. It is used to record notes about the station.

Figure 10. !Station/Location Log entry form

Fill out the form and submit it to create a new log entry. If there are no errors, you are re-directed to the detail page of the entry. For authenticated users, the detail page contains links to:

  1. Edit the entry (return to the log entry form to edit the fields)
  2. Delete the entry (it asks for confirmation before deleting the record)

The Station Summary Page displays the most recent log entry, if one exists, in the Last Log Entry module. The complete list of the station’s logs is accessible by the ‘Station logs’ action in the Station links module.

Update Power Devices

This form is to update the current power devices at the location. It allows the user to install a new power device at the location, and to swap or un-install the current existing power devices at the station.

Note the Tips section below the form on the page:

  1. Location actions:
  2. Install New: Install a new device. Select the devicetype and devicemodel to continue.
  3. Device actions:
  4. Swap: Swap the selected device with another of the same devicetype.
  5. Uninstall: End the active installation epoch of the device on the specified offdate. The device will no longer be installed at this location.

Note: Devicetypes can be inventoriable (its devices are tracked by unique serialnumber) or non-inventoriable (its devices are not tracked by a unique serialnumber). Since most POWER devicetypes are non-inventoriable, the examples shown here are for non-inventoriable power devices.

  1. Install a new device

Select the desired devicetype from the first dropdown adjacent to the ‘Install new’ label. The next dropdown is then populated with the available devicemodels for the selected devicetype. Select the desired devicemodel from the second dropdown.

Figure 11. Update current Power Devices: select action

Enter the GMT datetime of the install, and click Continue to continue. In this example, we select the CHARGER devicetype, and then a charger model. The next step is to specify the attributes of the device to be installed (a Charger in this example):

Figure 12. Update current Power Devices: install new device (charger)

Enter the values and submit the form. At this time, the following database changes are made:

  1. If the selected devicetype is:
    1. inventoriable (devices tracked by unique serialnumber):
      • The device serialnumber selected by the user is identified in the inventory pool and its inventory status is set to INSTALLED.
    2. non-inventoriable (devices are not tracked by unique serialnumber):
      • A new device is automatically created in the database
      • A new active installation epoch is created that links the device to the location. The epoch’s ondate is the submitted install date.

If there are no errors in the above steps, you are re-directed back to the Summary page where you should see the new power device in the Power Devices module. To install another power device, click the Update Power devices link and repeat the procedure. To view and correct the power installation epochs, refer to the ‘Power Installations’ section in this document.

  1. Swap a device

This is to swap a current power device with another of the same devicetype (e.g. one Charger for another). From the action menu of the device to be swapped, select the ‘Swap’ action. In this example, we select swap on the Charger installed in Part 1 above:

Figure 13. Update current Power Devices: select Swap action

Enter the GMT datetime of the swap, and click Continue to continue. The next step is to specify the attributes of the new device to be installed. Note: the Swap action preserves the devicetype across the swap, but you can select another devicemodel for the new device. Enter the values for the new device and submit the form. At this time, the following database changes are made:

  1. The installation epoch belonging to the old device is ended (its offdate is set to the swap date).
  2. If the devicetype is:
  3. inventoriable:
  4. The inventory status of the old device is set to INVENTORY.
  5. The new device serialnumber is selected by the user and its inventory status is set to INSTALLED.
  6. Non-inventoriable:
  7. A new device is automatically created
  8. A new active installation epoch is created that links the device to the location. The epoch’s ondate is the submitted swap date.

If there are no errors in the above steps, you are re-directed back to the Summary page where you should see the new device in the Power devices module. To swap another device, click the Update Power devices link and repeat the procedure. To view and correct the power installation epochs, refer to the Power Installations section in this document.

  1. Remove a device

This is to uninstall a power device that is currently installed at the location.

From the action menu of the device to be swapped, select the ‘Uninstall’ action.

Enter the GMT datetime of the removal, and submit the form. At this time, the following database changes are made:

  1. The installation epoch belonging to the device is ended (its offdate is set to the remove date).
  2. If the devicetype is inventoriable: the removed device’s inventory status is set to INVENTORY.

If there are no errors in the above steps, you are re-directed back to the Summary page.

To view and edit the existing power installation epochs, click the ‘Power installations’ link in the Links module. See the Power Installations section of this document for more information.

Update Telemetry Devices

This form is to update the current telemetry devices at the location. It allows the user to install a new telemetry device at the location, and to swap or un-install the current existing telemetry devices at the location. Note: Devicetypes can be inventoriable (its devices are tracked by unique serialnumber) or non-inventoriable (its devices are not tracked by a unique serialnumber). Since most Telemetry devicetypes are inventoriable, the examples shown here are for inventoriable telemetry devices.

  1. Install a new device

Select the desired devicetype from the first dropdown adjacent to the ‘Install new’ label. The next dropdown is then populated with the available devicemodels for the selected devicetype. Select the desired devicemodel from the second dropdown. In this example, we select the DIGITAL-RECORDER devicetype.

Figure 14. Update current Telemetry Devices: Select Install new

Enter the GMT datetime of the install, and click Continue to continue. The next step is to select the device to be installed (a Kinemetrics BalerPB44 in this example):

Figure 15. Update Telemetry Devices: install new device

Since the DIGITAL-RECORDER devicetype is inventoriable:

  1. The available devices whose inventory status=INVENTORY of the selected devicemodel are displayed in the Serialnumber dropdown menu.
  2. Select the serialnumber of the device to install from the Serialnumber dropdown menu

Submit the form. At this time the database is updated (refer to the database changes outlined in the section ‘Update Power Devices: Install new device’). If there are no errors in the above steps, you are re-directed back to the Summary page where you should see the new device in the Telemetry devices module. To install another telemetry device, click the ‘Update Telemetry devices’ link and repeat the procedure. To view and correct the telemetry installation epochs, refer to the ‘Telemetry Installations’ section in this document.

  1. Swap a device

This is to swap a current telemetry device with another of the same devicetype. From the action menu of the device to be swapped, select the ‘Swap’ action. In this example, we select swap on the Baler-PB44 digital recorder installed in Part 1:

Figure 16. Update current Telemetry Devices: select Swap action

Enter the GMT datetime of the swap (the swap date must be posterior to the device’s install date), and click Continue. The next step is to select the new device to be installed. Note: the Swap action preserves the devicetype across the swap, but you can select another devicemodel for the new device. Since the DIGITAL-RECORDER devicetype is inventoriable:

  1. The available devices whose inventory status=INVENTORY of the selected devicemodel are displayed in the Serialnumber dropdown menu.
  2. Select the serialnumber of the device to install from the Serialnumber dropdown menu

Submit the form. At this time the database is updated (refer to the database changes outlined in the section ‘Update Power Devices: Swap a device’). If there are no errors in the above steps, you are re-directed back to the Summary page where you should see the new device in the Telemetry devices module. To swap another telemetry device, click the ‘Update Telemetry devices’ link and repeat the procedure. To view and correct the telemetry installation epochs, refer to the ‘Telemetry Installations’ section in this document.

  1. Remove a device

This is to un-install a telemetry device that is currently installed at the location. From the action menu of the device to be swapped, select the ‘Uninstall’ action. Enter the GMT datetime of the removal (the removal date must be posterior to the device’s install date), and submit the form. At this time, the following database changes are made:

  1. The installation epoch belonging to the device is ended (its offdate is set to the remove date).
  2. If the devicetype is inventoriable: the removed device’s inventory status is set to INVENTORY.

If there are no errors in the above steps, you are re-directed back to the Summary page.

To view and edit the existing telemetry installation epochs, click the ‘Telemetry installations’ link in the Links module. See the Telemetry Installations section of this document for more information.

Power Installations

From the Summary page, click the ‘Power installations’ link in the Links module. It displays the existing power installation epochs at the location, and enables authenticated users to create historical installation epochs and correct existing ones.

Create Historical Power Installation Epoch

Click the ‘Create historical installation epoch’ link which takes you to a form:

Figure 17. Create Power Installation epoch

This form allows you to specify both an ondate and offdate. Note: If you enter an offdate of 3000-01-01 (i.e. an active installation epoch), then this form is equivalent to using the Update Power Devices form to install a new power device. Select the devicetype from the first dropdown menu, and then the devicemodel from the second dropdown menu. (In this example, we select the Battery devicetype). Enter the epoch ondatetime, and offdatetime in the accepted format, and click Continue.

The next step is to specify the device for the installation epoch:

Figure 18. Create Power Installation Epoch - Install Battery

Since the Battery devicetype is non-inventoriable in SIS, the device serialnumber is optional. Enter the values for the device and submit the form. At this time, a new installation epoch is created that links the device to the location for the given ondate and offdate. If there are no errors in the above steps, you are re-directed to the detail page of the newly created epoch.

Edit Existing Power Installation Epoch

Note: Editing an epoch is intended for correcting !typos/errors, not to overwrite accurate historical data.

Click on the ‘Epoch’ link of the installation epoch that needs to be corrected. This takes you to the detail page of the epoch. In this example, we click on the epoch that was created above:

Figure 19. Power Installation Epoch detail

Authenticated users see an ‘Edit’ link next to the fields of the installation epoch, and a link to delete the epoch. Clicking on the Edit link of a field takes you to a form where you can edit the value, submit the form and be re-directed back to the detail page of the installation epoch.

Telemetry Installations

From the Summary page, click the ‘Telemetry installations’ link in the Links module.

It displays the existing telemetry installation epochs at the location, and enables authenticated users to create historical installation epochs and correct existing ones.

Create Historical Telemetry Installation Epoch

Click the ‘Create historical installation epoch’ link which takes you to a form: Submit the form.

Edit Existing Telemetry Installation Epoch

Click on the ‘Epoch’ link of the installation epoch that needs to be corrected. Note: Editing the epoch is intended for correcting !typos/errors, not to overwrite accurate historical data.

This concludes the tutorial on the Station Summary Page. Please refer to the Channel Manager document for a tutorial on how to manage a station’s channel response.

Attachments