User's Guide

PRODEDIT

Edit the table of standing orders.

Function:

Edits the table of standing orders for AVHRR data. A standing order may be placed for a customer that is ordering data for a specified period of time that meets a set of criteria. All AVHRR data matching these criteria will have a product automatically produced as it is processed through the AVHRR Data Acquisition and Processing System (ADAPS).

Parameters:

Subcommand -ADD:
Add a standing order for an area that does not cross a pole.

ACCOUNT
Account number. Account number assigned to the customer.

SDATE
Start date. The first acquisition date for which the customer would like to receive data. See User Note 1.

EDATE
Ending date. The last acquisition date for which the customer would like to receive data. See User Note 1.

AGE
Data age. A product should be produced if an image is processed within AGE days of its acquisition date and meets all of the other requirements. Zero indicates that the image must be processed on the day of acquisition. 9999 indicates that any "age" data will be processed. This is included because data may be aquired and then processed 2-3 months later.

STATION
Station id. A product will be produced if an image is acquired from the station specified in the 3 character station id code. (See User Note 3.)

SATNUM
Satellite number. The number of the satellite from which the customer would like to receive data.

   =  9: NOAA  9
   = 10: NOAA 10
   = 11: NOAA 11
   = 12: NOAA 12
   = 14: NOAA 14
   = 15: NOAA 15
   = 16: NOAA 16
   = 17: NOAA 17
   = 18: NOAA 18
   = 19: NOAA 19

DAYOPT
Day option. Indicates if the customer is ordering daytime data, nighttime data, or both.

   = DAY:   Daytime data only
   = NIGHT: Nighttime data only
   = BOTH:  Both day and night

DTYPE
Data type. Indicates if the customer is ordering Global Area Coverage (GAC) data or High Resolution Picture Transmission (HRPT) data. HRPT includes all Local Area Coverage (LAC) data.

   = GAC:  Global Area Coverage
   = HRPT: High Resolution
           Picture Transmission
           and Local Area
           Coverage

NORTHLAT
Northern latitude. Northernmost latitude of the area of interest. See User Note 2.

SOUTHLAT
Southern latitude. Southernmost latitude of the area of interest. See User Note 2.

WESTLONG
Western longitude. Westernmost longitude of the area of interest. See User Note 2.

EASTLONG
Eastern longitude. Easternmost longitude of the area of interest. See User Note 2.

MINLINES
Minimum number of lines. The minimum number of lines that an image must contain in order to be sent to the customer.

WINDOW(N)
Option to select only lines in area of interest (NOTE: this option has not been implmented yet.)

   = Y: To select only lines in area of interest
   = N: To select entire image

PRODUCT
Product code. The code used by PRODGEN to specify the product ordered by the customer.

   = 0: Copy to the silo for temporary archive
   = 1: Level 0 archive to nsidc@edcftp
   = 2: Level 0 archive to nsidc@edcdaacftp
   = 3: Level 0 archive to /daac/avhrr/stage
   = 4: Level 1b archive to /daac/avhrr/stage
   = 5: Level 1b archive to /sgs4/km1/opsavhrr/emery/
   = 300: Level 0 archive to user specified directory
   = 301: Level 1b archive to user specified directory
   = 500: Level 1b tape (9-trck)
   = 501: Level 1b tape (3480)
   = 502: Level 1b tape (4mm)
   = 503: Level 1b tape (8mm LD)
   = 504: Level 1b tape (8mm HD)

DESCRPT
Description. Short description of the standing order.

BANDS(1,2,3,4,5)
Band numbers. The bands of data that the customer is ordering.
Subcommand -POLE:
Add a standing order for an area that crosses a pole.

ACCOUNT
Account number. Account number assigned to the customer.

SDATE
Start date. The first acquisition date for which the customer would like to receive data. See User Note 1.

EDATE
Ending date. The last acquisition date for which the customer would like to receive data. See User Note 1.

AGE
Data age. A product should be produced if an image is processed within AGE days of its acquisition date and meets all of the other requirements. Zero indicates that the image must be processed on the day of acquisition. 9999 indicates that any "age" data will be processed. This is included because data may be aquired and then processed 2-3 months later.

STATION
Station id. A product will be produced if an image is acquired from the station specified in the 3 character station id code. (See User Note 3.)

SATNUM
Satellite number. The number of the satellite from which the customer would like to receive data.

   =  9: NOAA  9
   = 10: NOAA 10
   = 11: NOAA 11
   = 12: NOAA 12
   = 14: NOAA 14
   = 15: NOAA 15
   = 16: NOAA 16
   = 17: NOAA 17
   = 18: NOAA 18
   = 19: NOAA 19

DAYOPT
Day option. Indicates if the customer is ordering daytime data, nighttime data, or both.

   = DAY:   Daytime data only
   = NIGHT: Nighttime data only
   = BOTH:  Both day and night

DTYPE
Data type. Indicates if the customer is ordering Global Area Coverage (GAC) data or High Resolution Picture Transmission (HRPT) data. HRPT includes all Local Area Coverage (LAC) data.

   = GAC:  Global Area Coverage
   = HRPT: High Resolution
           Picture Transmission
           and Local Area
           Coverage

POLE
Pole. Indicates which pole the standing order crosses. See User Note 4.

   = NORTH: North pole
   = SOUTH: South pole

LAT
Latitude. Latitude that specifies the area of interest around the given pole. Every image that lies between LAT and POLE will be processed for the customer. See User Note 2.

MINLINES
Minimum number of lines. The minimum number of lines that an image must contain in order to be sent to the customer.

WINDOW(N)
Option to select only lines in area of interest (NOTE: this option has not been implmented yet.)

   = Y: To select only lines in area of interest
   = N: To select entire image

PRODUCT
Product code. The code used by PRODGEN to specify the product ordered by the customer.

   = 0: Copy to the silo for temporary archive
   = 1: Level 0 archive to nsidc@edcftp
   = 2: Level 0 archive to nsidc@edcdaacftp
   = 3: Level 0 archive to /daac/avhrr/stage
   = 4: Level 1b archive to /daac/avhrr/stage
   = 5: Level 1b archive to /sgs4/km1/opsavhrr/emery/
   = 300: Level 0 archive to user specified directory
   = 301: Level 1b archive to user specified directory
   = 500: Level 1b tape (9-trck)
   = 501: Level 1b tape (3480)
   = 502: Level 1b tape (4mm)
   = 503: Level 1b tape (8mm LD)
   = 504: Level 1b tape (8mm HD)

DESCRPT
Description. Short description of the standing order.

BANDS(1,2,3,4,5)
Band numbers. The bands of data that the customer is ordering.
Subcommand -DEL:
Delete a standing order.

ACCOUNT
Account number. Account number assigned to the customer.

ORDER
Order number. Sequential number assigned to the standing orders for a customer. If the customer has several standing orders, they are numbered sequentially so that PRODEDIT can differentiate between them. Run PRODEDIT-LIST to find the correct number. See User Note 5.
Subcommand -LIST:
Print the standing order table to the terminal, a printer, or a file.

PRINT(TERM)
Output destination. Output destination for the standing orders table.

   = TERM:     Terminal.  Output is sent
               to the user's terminal.
   = LP:       Line printer.  Output is sent to
               the printer defined by $PRINTER.
   = Filename: User-supplied file name.  The table 
               is copied to the specified file.

Examples:

  1. LAS> prodedit-add account=13796 sdate=8/1/1992 edate=8/31/1992 age=14 station = *** satnum=11 dayopt=day dtype=hrpt northlat=500000 southlat=333300 westlong=-1300000 eastlong=-600000 minlines=250 window = n product = 502 descrpt="example product" output = "--"

    A standing order is entered in the table for account 13796. The standing order covers all daytime LAC and HRPT data that was acquired by NOAA-11 from August 1, 1992 through August 31, 1992. A product will be automatically generated if the data is processed through the ADAPS system within 14 days of its acquisition. These images must partially cover the area of interest that extends from North 50 degrees, 0 minutes, 0 seconds to North 33 degrees, 33 minutes, 0 seconds and from West 130 degrees, 0 minutes, 0 seconds to West 60 degrees, 0 minutes, 0 seconds. A product will not be generated unless the image contains at least 250 lines in the area of interest. The requested product is a Level 1b formatted image on a 4mm tape. By default, all five bands are included. Data from all the stations will be accepted, with the exception of the stitched orbit data. It has a "station id" of KM* (KM1, KME, etc.) and is not covered by ***. For stitched orbit data to be processed, a new order must be entered with KM* as a station ID (KM1 for example). The WINDOW option has not been implemented yet. The output directory is set to a flag that says it is not needed for this product.

  2. LAS> prodedit-pole account=14800 sdate=10/1/1992 edate=4/30/1993 age=0 station = tk2 satnum=12 dayopt=day dtype=hrpt pole=south lat=-600000 minlines=500 product=301 descrpt="south pole exampl" bands=(1 2) output = "/sg2/temp/"

    A standing order is entered in the table for account 14800. The standing order covers all daytime LAC and HRPT data that was acquired by NOAA-12 from October 1, 1992 through April 30, 1993. A product will be automatically generated if the data is processed through the ADAPS system on the day of acquisition. These images must lie partially within the area of interest that extends from South 60 degrees, 0 minutes, 0 seconds to South 90 degrees. A product will not be generated unless the image contains at least 500 lines in the area of interest and is data from the University of Tokyo (station id = TK2). The requested product is a Level 1b formatted image on a 3480 cartridge tape. Only bands one and two will be included. The output will be put in the directory /sg2/temp.

  3. LAS> prodedit-del account=22180 order=2

    The user has specified that the second standing order for account 22180 be deleted from the standing order table.

  4. LAS> prodedit-list print=lp

    The standing order table is sent to the printer specified by the LAS global variable $PRINTER.

Description/Algorithm:

PRODEDIT is used to update the standing order table for AVHRR data. The file "PRODGEN.TABLE" in ADAPSTABLES is first locked, the specified standing order is added or deleted, and the table is unlocked, allowing other applications to access the table.

Nonfatal Error Messages:

  1. [prodedit-none] Standing order not found

    The specified standing order was not found in the table. This order could not be deleted.

  2. [prodedit-unlock] Error unlocking table

    The standing order table was not unlocked properly. All functions will be unable to access the table until the file is unlocked. Run LOCKFIL-UNLOCK on "PRODGEN.TABLE" in ADAPSTABLES.

Fatal Error Messages:

  1. [prodedit-date] Invalid date format

    The starting or ending date was entered improperly. See User Note 1 for the required format. Correct any mistakes in SDATE or EDATE.

  2. [prodedit-dates] Starting date after ending date

    The starting date is after the ending date. Respecify SDATE and EDATE.

  3. [prodedit-dms] Invalid specification of <xxxxx>

    Parameter <xxxxx> was entered improperly. See User Note 2 for the correct format.

  4. [prodedit-env] Error retrieving <xxxxx>

    PRODEDIT was unable to retrieve the value of the environment variable <xxxxx>. Ensure the variable is set to the correct value.

  5. [prodedit-fatal] Fatal error encountered

    A fatal error was encountered. The error message displayed prior to this one is the specific error encountered.

  6. [prodedit-nolock] Unable to lock table

    PRODEDIT was unable to lock the standing order table, indicating it is already in use. Rerun PRODEDIT.

  7. [prodedit-queue] Error accessing queue

    An error occurred accessing the queue of standing orders. Contact the system administrator.

  8. [prodedit-read] Error reading the standing order table

    An error occurred reading the standing order table. Contact the system administrator.

  9. [prodedit-write] Error writing the standing order table

    An error occurred writing the standing order table. Contact the system administrator.

User Notes:

  1. Dates must be entered in the MM/DD/YYYY form. The year must be a four digit year. Slashes must separate the month, day, and year fields.

  2. Latitude and longitude values are entered in DDMMSS and DDDMMSS format respectively. A leading sign is optional for northern latitudes and eastern longitudes while a leading minus sign is required for southern latitudes and western longitudes. Leading zeros may be omitted, but care must be taken not to omit trailing zeros. For example, -10 specifies a negative 10 seconds while -100000 specifies a negative 10 degrees.

  3. If the station is ***, all station ids except ids designating stitched orbit data (KM1, KME, etc.), will be used. If the user wants all stations including the stitched orbit data, there must be separate orders placed, one with a station id of *** and another for each specific stitched orbit id (KM1, for example).

  4. The OUTPUT parameter may be "--", a flag to not scpecify the output directory. The "--" is NOT the NULL character. OUTPUT may not be "--" for products 300 and 301, because they rely on OUTPUT to tell them where to put the archive data.
  5. When using the -POLE subcommand to enter an area of interest that crosses a pole, care must be taken when specifying the latitude. If an area of interest over the North pole is being entered and a negative latitude is specified then the area of interest will extend from north 90 degrees to the specified southern latitude. Likewise, when entering an area of interest that crosses the South pole, a positive latitude will result in an area that extends from south 90 degrees to the specified northern latitude. Both cases will result in an area of interest that covers over one half of the earth.

    Standing orders cannot be placed for areas of interest that cross both poles.

  6. The order number used by PRODGEN-DEL is an internal order number only used by PRODGEN and PRODEDIT. This number is used to differentiate between multiple standing orders for the same account. If an account has one of its multiple orders deleted, all of the remaining orders are assigned new order numbers so that they remain sequential.

  7. When using the -LIST option to print the table of standing orders, the LAS global variable $PRINTER should be set to a printer that uses the landscape mode.

  8. An associated function is PRODGEN.