Clouds and the Earth\'s Radiant Energy System

(CERES)

Data Management System

CERES Synoptic SARB

(Subsystem 7.2)

Release 4 Test Plan

TRMM Launch

Version 1

**Primary Authors**

*Lisa Coleman, Tom Caldwell*

Science Systems and Applications, Inc. (SSAI)

One Enterprise Parkway, Suite 200

Hampton, VA 23666

NASA Langley Research Center

Climate Science Branch

Science Directorate

21 Langley Boulevard

Hampton, VA 23681-2199

SW Delivered to CM: December 2007

Document Date: December 2007

[]{#__RefHeading___Toc189039609 .anchor}Document Revision Record

The Document Revision Record contains information pertaining to approved
document changes. The table lists the date the Software Configuration
Change Request (SCCR) was approved, the Release and Version Number, the
SCCR number, a short description of the revision, and the revised
sections. The document authors are listed on the cover. The Head of the
CERES Data Management Team approves or disapproves the requested changes
based on recommendations of the Configuration Control Board.

+--------+------+------+------------------------------+--------------+---+
| Do     |      |      |                              |              |   |
| cument |      |      |                              |              |   |
| Re     |      |      |                              |              |   |
| vision |      |      |                              |              |   |
| Record |      |      |                              |              |   |
+--------+------+------+------------------------------+--------------+---+
| >      | > R  | > S  | > Description of Revision    | >            |   |
|  SCCR\ | elea | CCR\ |                              |  Section(s)\ |   |
| > App  | se/\ | > Nu |                              | > Affected   |   |
| roval\ | >    | mber |                              |              |   |
| > Date | Vers |      |                              |              |   |
|        | ion\ |      |                              |              |   |
|        | > Nu |      |                              |              |   |
|        | mber |      |                              |              |   |
+--------+------+------+------------------------------+--------------+---+
| > 06   | >    | >    | -   Initial version of       | > All        |   |
| /19/03 | R3V1 |  445 |     document.                | >            |   |
|        |      |      |                              | > All        |   |
|        |      |      | -   Updated format to comply |              |   |
|        |      |      |     with standards.          |              |   |
+--------+------+------+------------------------------+--------------+---+
| > 08   | >    | >    | -   Updated tar filenames.   | > 2.1        |   |
| /13/04 | R3V2 |  550 |                              | >            |   |
|        |      |      | -   Updated environment      | > 3.1.1.1    |   |
|        |      |      |     variable filename and    | > through    |   |
|        |      |      |     generalized filename     | > 3.1.1.4,   |   |
|        |      |      |     variables.               | > 3.1.2      |   |
|        |      |      |                              | >            |   |
|        |      |      | -   Updated runtime          | > 3.1.1.1.2  |   |
|        |      |      |     information.             | >            |   |
|        |      |      |                              | > 3.2        |   |
|        |      |      | -   Added new section for    | >            |   |
|        |      |      |     Terra test case.         | > Appendix C |   |
|        |      |      |                              | >            |   |
|        |      |      | -   Updated filenames and    | > (Table     |   |
|        |      |      |     added new ones.          | > C3-1)      |   |
|        |      |      |                              | >            |   |
|        |      |      | -   Updated format to comply | > All        |   |
|        |      |      |     with standards.          |              |   |
+--------+------+------+------------------------------+--------------+---+
| > 08   | >    | >    | -   Updated tar filenames.   | > 2.1        |   |
| /11/06 | R3V3 |  634 |                              | >            |   |
|        |      |      | -   Updated section to       | > 2.2        |   |
|        |      |      |     reflect use of new       | >            |   |
|        |      |      |     compilation script.      | > 3.1, 3.2,  |   |
|        |      |      |                              | > App. C     |   |
|        |      |      | -   Changed names of scripts | > (Table     |   |
|        |      |      |     to reflect conversion to | > C1-1)      |   |
|        |      |      |     Perl.                    | >            |   |
|        |      |      |                              | > 3.1.1.1,   |   |
|        |      |      | -   Added use of input data  | > 3.2.1.1    |   |
|        |      |      |     file move script.        | >            |   |
|        |      |      |                              | > 3.1.1.1,   |   |
|        |      |      | -   Updated sections to      | > 3.2.1.1    |   |
|        |      |      |     reflect use of new Perl  | >            |   |
|        |      |      |     scripts.                 | > Table 3-1, |   |
|        |      |      |                              | > Table 3-2  |   |
|        |      |      | -   Updated test summary     | >            |   |
|        |      |      |     information tables.      | > App. C     |   |
|        |      |      |                              | > (Table     |   |
|        |      |      | -   Updated filenames and    | > C3-1)      |   |
|        |      |      |     added new ones.          | >            |   |
|        |      |      |                              | > All        |   |
|        |      |      | -   Updated format to comply |              |   |
|        |      |      |     with standards.          |              |   |
+--------+------+------+------------------------------+--------------+---+
| > 12   | >    | >    | -   Added description of new | > 1.2.1      |   |
| /12/07 | R4V1 |  663 |     SYNs output.             | >            |   |
|        |      |      |                              | > 2.1        |   |
|        |      |      | -   Updated SCCR number in   | >            |   |
|        |      |      |     filenames.               | > 3.2.1.1    |   |
|        |      |      |                              | >            |   |
|        |      |      | -   Updated test case        | > 3.2.1.1.2  |   |
|        |      |      |     information.             | >            |   |
|        |      |      |                              | > 3.3        |   |
|        |      |      | -   Updated test case        | >            |   |
|        |      |      |     summary.                 | > Table C-3  |   |
|        |      |      |                              |              |   |
|        |      |      | -   Added new section for    |              |   |
|        |      |      |     Aqua test case.          |              |   |
|        |      |      |                              |              |   |
|        |      |      | -   Updated filenames and    |              |   |
|        |      |      |     added surface albedo     |              |   |
|        |      |      |     history and site list    |              |   |
|        |      |      |     filenames.               |              |   |
+--------+------+------+------------------------------+--------------+---+

[Document Revision Record ii](#__RefHeading___Toc189039609)

[1.0 Introduction 1](#introduction)

[1.1. Document Overview 1](#document-overview)

[1.2. Subsystem Overview 2](#subsystem-overview)

[1.2.1. CER7.2.1P1: CERES Synoptic SARB Subsystem Main-Processor
2](#cer7.2.1p1-ceres-synoptic-sarb-subsystem-main-processor)

[2.0 Software and Data File Installation Procedures
3](#software-and-data-file-installation-procedures)

[2.1. Installation 3](#installation)

[2.2. Compilation 4](#compilation)

[2.2.1. Compiling PGE 7.2.1P1 4](#compiling-pge-7.2.1p1)

[3.0 Test and Evaluation Procedures 6](#test-and-evaluation-procedures)

[3.1. PGE CER7.2.1P1\--Main-Processor TRMM Test Case
6](#pge-cer7.2.1p1--main-processor-trmm-test-case)

[3.1.1. Stand Alone Test Procedures 6](#stand-alone-test-procedures)

[3.1.1.1. PCF Generation and Execution 6](#pcf-generation-and-execution)

[3.1.1.1.1. Exit Codes 7](#exit-codes)

[3.1.1.1.2. Test Summary 7](#test-summary)

[3.1.1.2. Metadata Evaluation 8](#metadata-evaluation)

[3.1.1.3. Execution of Comparison Software for the Main-Processor
8](#execution-of-comparison-software-for-the-main-processor)

[3.1.1.4. Evaluation of Main-Processor Comparison Software Output
9](#evaluation-of-main-processor-comparison-software-output)

[3.1.2. Solutions to Possible Problems
9](#solutions-to-possible-problems)

[3.2. PGE CER7.2.1P1\--Main-Processor Terra Test Case
9](#pge-cer7.2.1p1--main-processor-terra-test-case)

[3.2.1. Stand Alone Test Procedures 9](#stand-alone-test-procedures-1)

[3.2.1.1. PCF Generation and Execution
10](#pcf-generation-and-execution-1)

[3.2.1.1.1. Exit Codes 11](#exit-codes-1)

[3.2.1.1.2. Test Summary 11](#test-summary-1)

[3.2.1.2. Metadata Evaluation 11](#metadata-evaluation-1)

[3.2.1.3. Execution of Comparison Software for the Main-Processor
12](#execution-of-comparison-software-for-the-main-processor-1)

[3.2.1.4. Evaluation of Main-Processor Comparison Software Output
12](#evaluation-of-main-processor-comparison-software-output-1)

[3.2.2. Solutions to Possible Problems
13](#solutions-to-possible-problems-1)

[3.3. PGE CER7.2.1P1\--Main-Processor Aqua Test Case
13](#pge-cer7.2.1p1--main-processor-aqua-test-case)

[3.3.1. Stand Alone Test Procedures 13](#stand-alone-test-procedures-2)

[3.3.1.1. PCF Generation and Execution
13](#pcf-generation-and-execution-2)

[3.3.1.1.1. Exit Codes 15](#exit-codes-2)

[3.3.1.1.2. Test Summary 15](#test-summary-2)

[3.3.1.2. Metadata Evaluation 15](#metadata-evaluation-2)

[3.3.1.3. Execution of Comparison Software for the Main-Processor
15](#execution-of-comparison-software-for-the-main-processor-2)

[3.3.1.4. Evaluation of Main-Processor Comparison Software Output
16](#evaluation-of-main-processor-comparison-software-output-2)

[3.3.2. Solutions to Possible Problems
16](#solutions-to-possible-problems-2)

[Appendix A - Acronyms and Abbreviations
A-1](#acronyms-and-abbreviations)

[Appendix B - Directory Structure Diagrams
B-1](#directory-structure-diagrams)

[Appendix C - File Description Tables C-1](#file-description-tables)

[C.1. Production Scripts and Executables
C-1](#production-scripts-and-executables)

[C.2. Processing Control Files (PCF), Metadata Control Files (MCF) and
Status\
Message Files (SMF)
C-1](#processing-control-files-pcf-metadata-control-files-mcf-and-status-message-files-smf)

[C.3. Ancillary Input Data C-4](#ancillary-input-data)

[C.4. Output Temporary Data Files (Production Results)
C-5](#output-temporary-data-files-production-results)

[Figure B‑1. Synoptic SARB Directory Structure
B-1](#__RefHeading___Toc189038545)

[Table 3‑1. Test Summary for PGE 7.2.1P1
7](#__RefHeading___Toc189039697)

[Table 3‑2. Test Summary for PGE 7.2.1P1
11](#__RefHeading___Toc189039698)

[Table 3‑3. Test Summary for PGE 7.2.1P1
15](#__RefHeading___Toc189039699)

[Table C.1‑1. Production Scripts C-1](#__RefHeading___Toc189039744)

[Table C.1‑2. Executables C-1](#__RefHeading___Toc189039745)

[Table C.2‑1. Metadata Control Files C-1](#__RefHeading___Toc189039746)

[Table C.2‑2. Process Control Files C-2](#__RefHeading___Toc189039747)

[Table C.2‑3. Status Message Files (SMF)
C-2](#__RefHeading___Toc189039748)

[Table C.3‑1. Ancillary Input Data C-4](#__RefHeading___Toc189039749)

[Table C.4‑1. Output Temporary Data Files
C-5](#__RefHeading___Toc189039750)

# Introduction

The Clouds and the Earth's Radiant Energy System (CERES) is a key
component of the Earth Observing System (EOS). The CERES instrument
provides radiometric measurements of the Earth's atmosphere from three
broadband channels: a shortwave channel (0.3 - 5 μm), a total channel
(0.3 - 200 μm), and an infrared window channel (8 - 12 μm). The CERES
instruments are improved models of the Earth Radiation Budget Experiment
(ERBE) scanner instruments, which operated from 1984 through 1990 on the
National Aeronautics and Space Administration's (NASA) Earth Radiation
Budget Satellite (ERBS) and on the National Oceanic and Atmospheric
Administration's (NOAA) operational weather satellites NOAA-9 and
NOAA-10. The strategy of flying instruments on Sun-synchronous, polar
orbiting satellites, such as NOAA-9 and NOAA-10, simultaneously with
instruments on satellites that have precessing orbits in lower
inclinations, such as ERBS, was successfully developed in ERBE to reduce
time sampling errors. CERES continues that strategy by flying
instruments on the polar orbiting EOS platforms simultaneously with an
instrument on the Tropical Rainfall Measuring Mission (TRMM) spacecraft,
which has an orbital inclination of 35 degrees. In addition, to reduce
the uncertainty in data interpretation and to improve the consistency
between the cloud parameters and the radiation fields, CERES includes
cloud imager data and other atmospheric parameters. The CERES
instruments fly on the TRMM spacecraft, on the EOS-AM platforms and on
the EOS-PM platforms. The TRMM satellite carries one CERES instrument
while the EOS satellites carry two CERES instruments, one operating in a
fixed azimuth scanning mode and the other operating in a rotating
azimuth scanning mode.

## Document Overview

This document, the [CERES Release 3 Delivery Test Plan for the CERES
Synoptic Surface and Atmospheric Radiation Budget (SARB) Subsystem
(Subsystem 7.2)]{.underline}, is part of the CERES Subsystem 7.2 Release
3 delivery package provided to the Langley Atmospheric Sciences Data
Center (ASDC). It provides a description of the CERES Synoptic SARB
Subsystem Release 3 software, and explains the procedures for
installing, executing, and testing the software. A section is also
included on validating the results of executing the software. A
description of acronyms and abbreviations is provided in Appendix A, a
directory structure diagram is contained in Error: Reference source not
found, and a description of the software and data files is contained in
Appendix C.

The document is organized as follows:

Section 1.0 - Introduction

Section 2.0 - Software and Data File Installation Procedures

Section 3.0 - Test and Evaluation Procedures

Appendix A - Acronyms and Abbreviations

Error: Reference source not found - Directory Structure Diagrams

Appendix C - File Description Tables

## Subsystem Overview

### CER7.2.1P1: CERES Synoptic SARB Subsystem Main-Processor

The Product Generation Executive (PGE) CER7.2.1P1 processes the CERES
Synoptic SARB Subsystem. This PGE consists of a Main-Processor only. The
Synoptic SARB Subsystem Main-Processor computes vertical longwave,
shortwave, and window channel flux profiles that span from the surface
to the top of the Earth's atmosphere for each CERES region within a
1-degree latitudinal zone for each hour of the month. The primary output
is the Synoptic Intermediate (SYNI) product, which contains vertical
flux profile data for all CERES regions. A secondary output is the
Synoptic Subset (SYNS) product, which contains the TSIB and SYNI data
for regions selected by Science Team members. An ASCII Quality Control
(QC) report is also produced with each run of the Subsystem.

The SYNI serves as input for CERES Subsystem 8.0, PGE CER8.1P1.

# Software and Data File Installation Procedures

This section describes how to install both the SARB library and the
Subsystem 7.2 Synoptic SARB software in preparation for making the
necessary test runs at the Langley ASDC. The installation procedures
include instructions for uncompressing and untarring the delivered
files, properly defining environmental variables, and compiling the
Synoptic SARB programs.

## Installation

Software/Data File Install Procedure:

1.  The scripts, makefiles, and Process Control Files (PCF) in the
    Subsystem 7.2 delivery package expect the following environment
    variables, found in the **\$CERESENV** script, to be defined:

**PGSDIR - Directory for Toolkit libraries**

**CERESHOME - Top Directory for CERES Software**

**CERESLIB - Directory for CERESlib**

**PGSINC - Pointer to the PGS Include file directory**

**PGSLIB - Directory which contains the SGI 64-bit Toolkit library
file**

**PGSMSG - Directory which contains Toolkit and CERES**

**Status Message Files**

HDFDIR - Pointer to the HDF home directory

> The included makefiles for the Main-Processor (SARBlib and Synoptic
> SARB-only code) redefine the following environment variables:

**FCOMP - Fortran 77 compilation flags (-O2 -c -64)**

**F90COMP - SGI Fortran 90 compilation flags (use the following options:
-w -O2 -c -64)**

2.  Change directory to the directory where you plan to install the SARB
    Subsystems. (The following instructions assume that the directory
    will be **\$CERESHOME.**)

3.  Uncompress and untar the SARB library and Synoptic SARB Subsystem
    files:

**uncompress SynSARB_anc_R4-663.tar.Z**

**tar xf SynSARB_anc_R4-663.tar**

**uncompress SynSARB_src_R4-663.tar.Z**

**tar xf SynSARB_src_R4-663.tar**

**For testing on *warlock:***

**uncompress SynSARB_dataexp_warlock_R4-663.tar.Z**

**tar xf SynSARB_dataexp_warlock_R4-663.tar**

For testing on cluster:

**uncompress SynSARB_dataexp_cluster_R4-663.tar.Z**

**tar xf SynSARB_dataexp_cluster_R4-663.tar**

4.  If the delivery is a full subsystem delivery then the files from
    previous deliveries should be removed using the
    \$CERESHOME/SynSARB_OldFileRemove.csh script before the newly
    untarred files are copied into the /SSIT/CERES directory. This
    script removes all of the old Synoptic SARB files except the ones in
    the \$CERESHOME/sarb/data/\
    ancillary/static/sarbsyn directory and the source code files in the
    \$CERESHOME/sarb/lib/src directory.

## Compilation

Software modules common to more than one SARB PGE are contained in the
SARB library. Since many modules and their associated error messages are
shared between SARB subsystems, all error message files are stored in
one directory. The instructions for compiling these portions of the
subsystem follow. Instructions for generating the executable for PGE CER
7.2.1P1 are contained in Section 2.2.1.

NOTE: For full subsystem deliveries, use the following commands to
compile all the software:

**cd \$CERESHOME/sarb/bin/sarbsyn**

**./compile_7.2.1.pl all**

1.  The Status Message Files can be made by typing:

**cd \$CERESHOME/sarb/bin/sarbsyn**

**./compile_7.2.1.pl smf**

5.  The SARB Library can be made by typing:

**cd \$CERESHOME/sarb/bin/sarbsyn**

**./compile_7.2.1.pl lib**

As this is a software library, no executable is generated. The message
"Warning: creating SARBlib_SYN.a" appears at the end of successful
compilation. The file, **SARBlib_SYN.a**, remains in the
**\$CERESHOME/sarb/lib/src** directory.

### Compiling PGE 7.2.1P1

1.  The Subsystem 7.2 Main-Processor executable can be made by typing:

**cd \$CERESHOME/sarb/bin/sarbsyn**

**./compile_7.2.1.pl 7.2.1**

The resulting executable, **SynSARB_Drv.exe**, is stored in the
directory **\$CERESHOME/sarb/bin/sarbsyn**.

6.  Execute the following to compile the comparison software for the
    Main-Processor output:

> **cd \$CERESHOME/sarb/bin/sarbsyn**

**./compile_7.2.1.pl test**

The resulting executable, **synicomp.exe**, remains in the directory
**\$CERESHOME/sarb/test_suites/sarbsyn/src/mainss7_2**.

# Test and Evaluation Procedures

This section provides general information on how to execute the
Subsystem 7.2 PGE and provides an overview of the test and evaluation
procedures. It includes a description of what is being tested and the
order in which the tests should be performed.

## PGE CER7.2.1P1\--Main-Processor TRMM Test Case

### Stand Alone Test Procedures

The Main-Processor production script, runsarb, references a Process
Control File (PCF) which contains the correct file names and paths for
the test procedures. The PCF is created by first executing an ASCII file
generator, ascii_gen_7.2.1P1.pl, and then executing the PCF generator,
pcfgen_7.2.1P1.pl.

In the production environment, ascii_gen_7.2.1P1.pl and
pcfgen_7.2.1P1.pl must be executed to create the PCF for each production
run. The ASCII file generator, ascii_gen_7.2.1P1.pl, requires one
command line argument\--the date/zone parameter, formatted as
YYYYMMZxxx, where YYYY is the 4-digit year, MM is the 2-digit month, Z
is a constant and xxx is the 3-digit latitudinal zone index. The PCF
generator, pcfgen_7.2.1P1.pl, is then executed using the newly created
ASCII input file name as a command line argument. Execute the production
script by typing the script name, run_7.2.1.pl, followed by the name of
the PCF generated by pcfgen_7.2.1P1.pl.

#### PCF Generation and Execution

1.  Copy the TSIB input file provided with this delivery, and link to
    the to the directories to which the PCF is pointing by typing:

**cd \$CERESHOME/sarb/data/input/sarbsyn**

**./CER7.2P1_InputFileMover.csh copyfiles**

7.  Generate the PCF for the TRMM test case:

Set the test case environment variables:

**cd \$CERESHOME/sarb/bin/sarbsyn**

> **cp \$CERESHOME/sarb/bin/sarb/ssit-main-env-TRMM.pl**
>
> **\$CERESHOME/sarb/bin/sarb/ssit-main-env.pl**

**setenv DATE 199807Z090**

**setenv INSTANCE TRMM-PFM-VIRS_SSIT_999999.199807Z090**

Execute the ASCII file and PCF generators:

**\$CERESHOME/sarb/bin/sarbsyn/setup7.2.1.pl \$DATE**

The following PCF will be generated in
**\$CERESHOME/sarb/rcf/pcf/sarbsyn**:

-   CER7.2.1P1_PCF\_\$INSTANCE

8.  Compare the PCF for the test case with the PCF provided in this
    delivery, using the diff command:

**diff \$CERESHOME/sarb/rcf/pcf/sarbsyn/CER7.2.1P1_PCF\_\$INSTANCE
\$CERESHOME/sarb/data/out_exp/data/sarbsyn/CER7.2.1P1_PCF\_\$INSTANCE**

The only differences between the files should be in the directory paths
where the tests were run.

9.  Execute the test case by typing:

**cd \$CERESHOME/sarb/bin/sarbsyn**

**./run_7.2.1.pl CER7.2.1P1_PCF\_\$INSTANCE**

Four files will be created by the Main-Processor:

-   \$CERESHOME/sarb/data/out_comp/data/sarbsyn/CER_SYNI\_\$INSTANCE

-   \$CERESHOME/sarb/data/out_comp/data/sarbsyn/CER_SYNI\_\$INSTANCE.met

-   \$CERESHOME/sarb/data/out_comp/qa_reports/sarbsyn/CER_KQCR\_\$INSTANCE

-   \$CERESHOME/sarb/data/out_comp/qa_reports/sarbsyn/CER_KQCR\_\$INSTANCE.met

##### Exit Codes

All CER7.2.1P1 software terminates using the CERES defined EXIT CODES
for the Langley TRMM Information System (LaTIS). Successful completion
is indicated by an exit code of 0. This test should complete with an
exit code of 0 for each of the two executables.

##### Test Summary

[]{#__RefHeading___Toc189039697 .anchor}Table 3‑1. Test Summary for PGE
7.2.1P1

+-----------------------------------------+----------------------------+
|                                         | > Warlock                  |
+-----------------------------------------+----------------------------+
|                                         | > **PFM**                  |
+-----------------------------------------+----------------------------+
| > Run Time                              | > 8:10 hours               |
+-----------------------------------------+----------------------------+
| > Memory                                | > 69200 K                  |
+-----------------------------------------+----------------------------+
| > Required Disk Space                   | > 6615 MB                  |
+-----------------------------------------+----------------------------+

#### Metadata Evaluation

Metadata files which end in extension, \'.met\', are located in the same
directories as their corresponding output files after CER7.2.1P1 has
been executed. Compare the metadata contained in these files with the
expected contents of the files with the same names found in directory
\$CERESHOME/sarb/data/out_exp/data/sarbsyn, using the diff command.

The only differences between the files should be the production times
and differences in the directory paths where the tests were run.

**diff
\$CERESHOME/sarb/data/out_comp/data/sarbsyn/CER_SYNI\_\$INSTANCE.met
\$CERESHOME/sarb/data/out_exp/data/sarbsyn**/**CER_SYNI\_\$INSTANCE.met**

**diff
\$CERESHOME/sarb/data/out_comp/qa_reports/sarbsyn/CER_KQCR\_\$INSTANCE.met
\$CERESHOME/sarb/data/out_exp/data/sarbsyn/CER_KQCR\_\$INSTANCE.met**

#### Execution of Comparison Software for the Main-Processor

This section provides information on how to execute the comparison
software for the Synoptic SARB Subsystem PGE CER7.2.1P1.

1.  Execute the following to compare the binary output from the
    Main-Processor Full-Hour Mode test case. Note that this software
    does not compare the HDF version of the CRS.

> **cd \$CERESHOME/sarb/test_suites/sarbsyn/src/mainss7_2**

**./run_syni_compare.pl CER_SYNI\_\$INSTANCE**

One file will be created:

-   \$CERESHOME/sarb/test_suites/sarbsyn/src/mainss7_2/CER_SYNI\_\$INSTANCE\\\_test_suites_results

NOTE: The script run_syni_compare.pl removes any output files leftover
from previous executions if they exist. If a file the script is
attempting to remove does not exist, a message is written to the screen.

10. Compare the Quality Control Report for the Mode against the expected
    output:

First, try to remove old output files IF they exist:

> **cd \$CERESHOME/sarb/data/out_exp/data/sarbsyn**
>
> **rm** **CER7.2.1P1_MainQC_diff**

**diff
\$CERESHOME/sarb/data/out_comp/qa_reports/sarbsyn/CER_KQCR\_\$INSTANCE
\$CERESHOME/sarb/data/out_exp/data/sarbsyn/CER_KQCR\_\$INSTANCE \>
\$CERESHOME/sarb/data/out_exp/data/sarbsyn/CER7.2.1P1_MainQC_diff**

The only differences should be in the Processing Date information in the
Quality Control Report Header. Some mismatches might occur due to
computer precision, thus, there is no need for immediate alarm.

#### Evaluation of Main-Processor Comparison Software Output

This section provides the procedure for evaluating the output from the
Synoptic SARB Subsystem 7.2.

1.  Examine the comparison report files for the Main-Processor:

**more
\$CERESHOME/sarb/test_suites/sarbsyn/src/mainss7_2/CER_SYNI\_\$INSTANCE\\\_test_suites_results**

If all goes well, there will be a line indicating that no mismatches
were found when comparing the results produced by the Langley ASDC with
those produced by the CERES team. Some mismatches might occur due to
computer precision, thus, there is no need for immediate alarm. Just
perform Step 2.

11. E-mail the files **\$CERESHOME/sarb/test_suites/sarbsyn/mainss7_2/\
    CER_SYNI\_\$INSTANCE**\\**\_test_suites_results** and
    **\$CERESHOME/sarb/**
    **data/out_exp/sarbsyn/CER7.2.1P1_MainQC_diff** to
    ceresdmt+sarb@larc.nasa.gov.

### Solutions to Possible Problems

1.  All output files must be deleted or renamed in order to run the
    production software properly again. To use the provided script, type
    the following:

> **cd \$CERESHOME/sarb/bin/sarbsyn**

**./rm_script_7.2.1P1.pl CER7.2.1P1_PCF\_\$INSTANCE**

12. Environment variables, FCOMP and F90COMP, must be set to the
    following SGI compiler options for the Main-Processor:

**setenv F90COMP '-w -O2 -c -64'**

**setenv FCOMP '-O2 -c -64'**

13. A "No match" indicates there were no files to delete during
    execution of a script. This message does not indicate a problem.

## PGE CER7.2.1P1\--Main-Processor Terra Test Case

### Stand Alone Test Procedures

The Main-Processor production script, runsarb, references a Process
Control File (PCF) which contains the correct file names and paths for
the test procedures. The PCF is created by first executing an ASCII file
generator, ascii_gen_7.2.1P1.pl, and then executing the PCF generator,
pcfgen_7.2.1P1.pl.

In the production environment, ascii_gen_7.2.1P1.pl and
pcfgen_7.2.1P1.pl must be executed to create the PCF for each production
run. The ASCII file generator, ascii_gen_7.2.1P1.pl, requires one
command line argument\--the date/zone parameter, formatted as
YYYYMMZxxx, where YYYY is the 4-digit year, MM is the 2-digit month, Z
is a constant and xxx is the 3-digit latitudinal zone index. The PCF
generator, pcfgen_7.2.1P1.pl, is then executed using the newly created
ASCII input file name as a command line argument. Execute the production
script by typing the script name, run_7.2.1.pl, followed by the name of
the PCF generated by pcfgen_7.2.1P1.pl.

#### PCF Generation and Execution

1.  Copy the TSIB input file provided with this delivery, and link to
    the to the directories to which the PCF is pointing by typing:

**cd \$CERESHOME/sarb/data/input/sarbsyn**

**./CER7.2P1_InputFileMover.csh copyfiles**

14. Generate the PCF for the Terra test cases:

Set the test case environment variables:

**For FM1:**

**cd \$CERESHOME/sarb/bin/sarbsyn**

> **cp \$CERESHOME/sarb/bin/sarbsyn/ssit-main-env-Terra-FM1.pl
> \$CERESHOME/sarb/bin/sarbsyn/ssit-main-env.pl**

**setenv DATE 200207Z054**

**setenv INSTANCE Terra-FM1-MODIS_SSIT_999999.200207Z054**

**For FM2:**

**cd \$CERESHOME/sarb/bin/sarbsyn**

> **cp \$CERESHOME/sarb/bin/sarbsyn/ssit-main-env-Terra-FM2.pl
> \$CERESHOME/sarb/bin/sarbsyn/ssit-main-env.pl**

**setenv DATE 200110Z054**

**setenv INSTANCE Terra-FM2-MODIS_SSIT_999999.200110Z054**

Execute the ASCII file and PCF generators:

**\$CERESHOME/sarb/bin/sarbsyn/setup7.2.1.pl \$DATE**

The following PCF will be generated in
**\$CERESHOME/sarb/rcf/pcf/sarbsyn**:

-   CER7.2.1P1_PCF\_\$INSTANCE

15. Compare the PCF for the test case with the PCF provided in this
    delivery, using the diff command:

**diff \$CERESHOME/sarb/rcf/pcf/sarbsyn/CER7.2.1P1_PCF\_\$INSTANCE
\$CERESHOME/sarb/data/out_exp/data/sarbsyn/CER7.2.1P1_PCF\_\$INSTANCE**

The only differences between the files should be in the directory paths
where the tests were run.

16. Execute the test case by typing:

**cd \$CERESHOME/sarb/bin/sarbsyn**

**./run_7.2.1.pl CER7.2.1P1_PCF\_\$INSTANCE**

Four files will be created by the Main-Processor:

-   \$CERESHOME/sarb/data/out_comp/data/sarbsyn/CER_SYNI\_\$INSTANCE

-   \$CERESHOME/sarb/data/out_comp/data/sarbsyn/CER_SYNI\_\$INSTANCE.met

-   \$CERESHOME/sarb/data/out_comp/qa_reports/sarbsyn/CER_KQCR\_\$INSTANCE

-   \$CERESHOME/sarb/data/out_comp/qa_reports/sarbsyn/CER_KQCR\_\$INSTANCE.met

##### Exit Codes

All CER7.2.1P1 software terminates using the CERES defined EXIT CODES
for the Langley TRMM Information System (LaTIS). Successful completion
is indicated by an exit code of 0. This test should complete with an
exit code of 0 for each of the two executables.

##### Test Summary

[]{#__RefHeading___Toc189039698 .anchor}Table 3‑2. Test Summary for PGE
7.2.1P1

+-------------------+-----------+------------+-----------+-----------+
|                   | > Warlock |            | > Linux   |           |
|                   |           |            | > Cluster |           |
+-------------------+-----------+------------+-----------+-----------+
|                   | > **FM1** | > **FM2**  | > **FM1** | > **FM2** |
+-------------------+-----------+------------+-----------+-----------+
| > Run Time        | > 15:03   | > 14:10    | > 9:54    | > 9:16    |
|                   | > hours   | > hours    | > hours   | > hours   |
+-------------------+-----------+------------+-----------+-----------+
| > Memory          | > 73256 K | > 73088 K  | > 73088 K | > 73088 K |
+-------------------+-----------+------------+-----------+-----------+
| > Required Disk   | > 8603 MB | > 8603 MB  | > 8603 MB | > 8603 MB |
| > Space           |           |            |           |           |
+-------------------+-----------+------------+-----------+-----------+

#### Metadata Evaluation

Metadata files which end in extension, \'.met\', are located in the same
directories as their corresponding output files after CER7.2.1P1 has
been executed. Compare the metadata contained in these files with the
expected contents of the files with the same names found in directory
\$CERESHOME/sarb/data/out_exp/data/sarbsyn, using the diff command.

The only differences between the files should be the production times
and differences in the directory paths where the tests were run.

**diff
\$CERESHOME/sarb/data/out_comp/data/sarbsyn/CER_SYNI\_\$INSTANCE.met
\$CERESHOME/sarb/data/out_exp/data/sarbsyn**/**CER_SYNI\_\$INSTANCE.met**

**diff
\$CERESHOME/sarb/data/out_comp/qa_reports/sarbsyn/CER_KQCR\_\$INSTANCE.met
\$CERESHOME/sarb/data/out_exp/data/sarbsyn/CER_KQCR\_\$INSTANCE.met**

#### Execution of Comparison Software for the Main-Processor

This section provides information on how to execute the comparison
software for the Synoptic SARB Subsystem PGE CER7.2.1P1.

1.  Execute the following to compare the binary output from the
    Main-Processor Full-Hour Mode test case. Note that this software
    does not compare the HDF version of the CRS.

> **cd \$CERESHOME/sarb/test_suites/sarbsyn/src/mainss7_2**

**./run_syni_compare.pl CER_SYNI\_\$INSTANCE**

One file will be created:

-   \$CERESHOME/sarb/test_suites/sarbsyn/src/mainss7_2/CER_SYNI\_\$INSTANCE\\\_test_suites_results

NOTE: The script run_syni_compare.pl removes any output files leftover
from previous executions if they exist. If a file the script is
attempting to remove does not exist, a message is written to the screen.

17. Compare the Quality Control Report for the Mode against the expected
    output:

First, try to remove old output files IF they exist:

> **cd \$CERESHOME/sarb/data/out_exp/data/sarbsyn**
>
> **rm** **CER7.2.1P1_MainQC_diff**

**diff
\$CERESHOME/sarb/data/out_comp/qa_reports/sarbsyn/CER_KQCR\_\$INSTANCE
\$CERESHOME/sarb/data/out_exp/data/sarbsyn/CER_KQCR\_\$INSTANCE \>
\$CERESHOME/sarb/data/out_exp/data/sarbsyn/CER7.2.1P1_MainQC_diff**

The only differences should be in the Processing Date information in the
Quality Control Report Header. Some mismatches might occur due to
computer precision, thus, there is no need for immediate alarm.

#### Evaluation of Main-Processor Comparison Software Output

This section provides the procedure for evaluating the output from the
Synoptic SARB Subsystem 7.2.

1.  Examine the comparison report files for the Main-Processor:

**more
\$CERESHOME/sarb/test_suites/sarbsyn/src/mainss7_2/CER_SYNI\_\$INSTANCE\\\_test_suites_results**

If all goes well, there will be a line indicating that no mismatches
were found when comparing the results produced by the Langley ASDC with
those produced by the CERES team. Some mismatches might occur due to
computer precision, thus, there is no need for immediate alarm. Just
perform Step 2.

18. E-mail the files
    **\$CERESHOME/sarb/test_suites/sarbsyn/src/mainss7_2/\
    CER_SYNI\_\$INSTANCE**\\**\_test_suites_results** and
    **\$CERESHOME/sarb/data/\
    out_exp/data/sarbsyn/CER7.2.1P1_MainQC_diff** to
    ceresdmt+sarb@larc.nasa.gov.

### Solutions to Possible Problems

1.  All output files must be deleted or renamed in order to run the
    production software properly again. To use the provided script, type
    the following:

> **cd \$CERESHOME/sarb/bin/sarbsyn**

**./rm_script_7.2.1P1.pl CER7.2.1P1_PCF\_\$INSTANCE**

19. Environment variables, FCOMP and F90COMP, must be set to the
    following SGI compiler options for the Main-Processor:

**setenv F90COMP '-w -O2 -c -64'**

**setenv FCOMP '-O2 -c -64'**

20. A "No match" indicates there were no files to delete during
    execution of a script. This message does not indicate a problem.

## PGE CER7.2.1P1\--Main-Processor Aqua Test Case

### Stand Alone Test Procedures

The Main-Processor production script, runsarb, references a Process
Control File (PCF) which contains the correct file names and paths for
the test procedures. The PCF is created by first executing an ASCII file
generator, ascii_gen_7.2.1P1.pl, and then executing the PCF generator,
pcfgen_7.2.1P1.pl.

In the production environment, ascii_gen_7.2.1P1.pl and
pcfgen_7.2.1P1.pl must be executed to create the PCF for each production
run. The ASCII file generator, ascii_gen_7.2.1P1.pl, requires one
command line argument\--the date/zone parameter, formatted as
YYYYMMZxxx, where YYYY is the 4-digit year, MM is the 2-digit month, Z
is a constant and xxx is the 3-digit latitudinal zone index. The PCF
generator, pcfgen_7.2.1P1.pl, is then executed using the newly created
ASCII input file name as a command line argument. Execute the production
script by typing the script name, run_7.2.1.pl, followed by the name of
the PCF generated by pcfgen_7.2.1P1.pl.

#### PCF Generation and Execution

1.  Copy the TSIB input file provided with this delivery, and link to
    the to the directories to which the PCF is pointing by typing:

**cd \$CERESHOME/sarb/data/input/sarbsyn**

**./CER7.2P1_InputFileMover.csh copyfiles**

21. Generate the PCF for the Aqua test cases:

Set the test case environment variables:

**For FM3:**

**cd \$CERESHOME/sarb/bin/sarbsyn**

> **cp \$CERESHOME/sarb/bin/sarbsyn/ssit-main-env-Aqua-FM3.pl
> \$CERESHOME/sarb/bin/sarbsyn/ssit-main-env.pl**

**setenv DATE 200207Z054**

**setenv INSTANCE Aqua-FM3-MODIS_SSIT_999999.200207Z054**

**For FM4:**

**cd \$CERESHOME/sarb/bin/sarbsyn**

> **cp \$CERESHOME/sarb/bin/sarbsyn/ssit-main-env-Aqua-FM4.pl
> \$CERESHOME/sarb/bin/sarbsyn/ssit-main-env.pl**

**setenv DATE 200207Z054**

**setenv INSTANCE Aqua-FM4-MODIS_SSIT_999999.200207Z054**

Execute the ASCII file and PCF generators:

**\$CERESHOME/sarb/bin/sarbsyn/setup7.2.1.pl \$DATE**

NOTE: The scripts may state that certain optional input files are
missing. If this happens, enter a y to tell the scripts to finish
generating the PCF.

The following PCF will be generated in
**\$CERESHOME/sarb/rcf/pcf/sarbsyn**:

-   CER7.2.1P1_PCF\_\$INSTANCE

22. Compare the PCF for the test case with the PCF provided in this
    delivery, using the diff command:

**diff \$CERESHOME/sarb/rcf/pcf/sarbsyn/CER7.2.1P1_PCF\_\$INSTANCE
\$CERESHOME/sarb/data/out_exp/data/sarbsyn/CER7.2.1P1_PCF\_\$INSTANCE**

The only differences between the files should be in the directory paths
where the tests were run.

23. Execute the test case by typing:

**cd \$CERESHOME/sarb/bin/sarbsyn**

**./run_7.2.1.pl CER7.2.1P1_PCF\_\$INSTANCE**

Four files will be created by the Main-Processor:

-   \$CERESHOME/sarb/data/out_comp/data/sarbsyn/CER_SYNI\_\$INSTANCE

-   \$CERESHOME/sarb/data/out_comp/data/sarbsyn/CER_SYNI\_\$INSTANCE.met

-   \$CERESHOME/sarb/data/out_comp/qa_reports/sarbsyn/CER_KQCR\_\$INSTANCE

-   \$CERESHOME/sarb/data/out_comp/qa_reports/sarbsyn/CER_KQCR\_\$INSTANCE.met

##### Exit Codes

All CER7.2.1P1 software terminates using the CERES defined EXIT CODES
for the Langley TRMM Information System (LaTIS). Successful completion
is indicated by an exit code of 0. This test should complete with an
exit code of 0 for each of the two executables.

##### Test Summary

[]{#__RefHeading___Toc189039699 .anchor}Table 3‑3. Test Summary for PGE
7.2.1P1

+-------------------+-----------+------------+-----------+-----------+
|                   | > Warlock |            | > Linux   |           |
|                   |           |            | > Cluster |           |
+-------------------+-----------+------------+-----------+-----------+
|                   | > **FM3** | > **FM4**  | > **FM3** | > **FM4** |
+-------------------+-----------+------------+-----------+-----------+
| > Run Time        | > 10:08   | > 15:10    | > 9:57    | > 10:10   |
|                   | > hours   | > hours    | > hours   | > hours   |
+-------------------+-----------+------------+-----------+-----------+
| > Memory          | > 73256 K | > 73088 K  | > 73088 K | > 73088 K |
+-------------------+-----------+------------+-----------+-----------+
| > Required Disk   | > 8603 MB | > 8603 MB  | > 8603 MB | > 8603 MB |
| > Space           |           |            |           |           |
+-------------------+-----------+------------+-----------+-----------+

#### Metadata Evaluation

Metadata files which end in extension, \'.met\', are located in the same
directories as their corresponding output files after CER7.2.1P1 has
been executed. Compare the metadata contained in these files with the
expected contents of the files with the same names found in directory
\$CERESHOME/sarb/data/out_exp/data/sarbsyn, using the diff command.

The only differences between the files should be the production times
and differences in the directory paths where the tests were run.

**diff
\$CERESHOME/sarb/data/out_comp/data/sarbsyn/CER_SYNI\_\$INSTANCE.met
\$CERESHOME/sarb/data/out_exp/data/sarbsyn**/**CER_SYNI\_\$INSTANCE.met**

**diff
\$CERESHOME/sarb/data/out_comp/qa_reports/sarbsyn/CER_KQCR\_\$INSTANCE.met
\$CERESHOME/sarb/data/out_exp/data/sarbsyn/CER_KQCR\_\$INSTANCE.met**

#### Execution of Comparison Software for the Main-Processor

This section provides information on how to execute the comparison
software for the Synoptic SARB Subsystem PGE CER7.2.1P1.

1.  Execute the following to compare the binary output from the
    Main-Processor Full-Hour Mode test case. Note that this software
    does not compare the HDF version of the CRS.

> **cd \$CERESHOME/sarb/test_suites/sarbsyn/src/mainss7_2**

**./run_syni_compare.pl CER_SYNI\_\$INSTANCE**

One file will be created:

-   \$CERESHOME/sarb/test_suites/sarbsyn/src/mainss7_2/CER_SYNI\_\$INSTANCE\\\_test_suites_results

NOTE: The script run_syni_compare.pl removes any output files leftover
from previous executions if they exist. If a file the script is
attempting to remove does not exist, a message is written to the screen.

24. Compare the Quality Control Report for the Mode against the expected
    output:

First, try to remove old output files IF they exist:

> **cd \$CERESHOME/sarb/data/out_exp/data/sarbsyn**
>
> **rm** **CER7.2.1P1_MainQC_diff**

**diff
\$CERESHOME/sarb/data/out_comp/qa_reports/sarbsyn/CER_KQCR\_\$INSTANCE
\$CERESHOME/sarb/data/out_exp/data/sarbsyn/CER_KQCR\_\$INSTANCE \>
\$CERESHOME/sarb/data/out_exp/data/sarbsyn/CER7.2.1P1_MainQC_diff**

The only differences should be in the Processing Date information in the
Quality Control Report Header. Some mismatches might occur due to
computer precision, thus, there is no need for immediate alarm.

#### Evaluation of Main-Processor Comparison Software Output

This section provides the procedure for evaluating the output from the
Synoptic SARB Subsystem 7.2.

1.  Examine the comparison report files for the Main-Processor:

**more \$CERESHOME/sarb/test_suites/sarbsyn/src/mainss7_2/\
CER_SYNI\_\$INSTANCE\\\_test_suites_results**

If all goes well, there will be a line indicating that no mismatches
were found when comparing the results produced by the Langley ASDC with
those produced by the CERES team. Some mismatches might occur due to
computer precision, thus, there is no need for immediate alarm. Just
perform Step 2.

25. E-mail the files
    **\$CERESHOME/sarb/test_suites/sarbsyn/src/mainss7_2/\
    CER_SYNI\_\$INSTANCE**\\**\_test_suites_results** and
    **\$CERESHOME/sarb/data/\
    out_exp/data/sarbsyn/CER7.2.1P1_MainQC_diff** to
    ceresdmt+sarb@larc.nasa.gov.

### Solutions to Possible Problems

1.  All output files must be deleted or renamed in order to run the
    production software properly again. To use the provided script, type
    the following:

> **cd \$CERESHOME/sarb/bin/sarbsyn**

**./rm_script_7.2.1P1.pl CER7.2.1P1_PCF\_\$INSTANCE**

26. Environment variables, FCOMP and F90COMP, must be set to the
    following SGI compiler options for the Main-Processor:

**setenv F90COMP '-w -O2 -c -64'**

**setenv FCOMP '-O2 -c -64'**

27. A "No match" indicates there were no files to delete during
    execution of a script. This message does not indicate a problem.

#######  Acronyms and Abbreviations

ASDC Atmospheric Sciences Data Center

CERES Clouds and the Earth's Radiant Energy System

CERESlib CERES library

CRS Clouds and Radiation Swath

CRSB Clouds and Radiation Swath Binary

DAAC Distributed Active Archive Center

DRIVTAB Derivative Table

EOS Earth Observing System

EOS-AM EOS Morning Crossing Mission

EOS-PM EOS Afternoon Crossing Mission

ERBE Earth Radiation Budget Experiment

ERBS Earth Radiation Budget Satellite

FOV Field-of-View

HDF Hierarchical Data Format

LaTIS Langley TRMM Information System

MCF Metadata Control Files

NASA National Aeronautics and Space Administration

NOAA National Oceanic and Atmospheric Administration

PCF Process Control File

PGE Product Generation Executive

QC Quality Control

SARB Surface and Atmospheric Radiation Budget

SCF Science Computing Facility

SMF Status Message Facility

SYNI Synoptic Intermediate Product

TRMM Tropical Rainfall Measuring Mission

TSIB Time Space Interpolate Binary Product

#######  Directory Structure Diagrams

[]{#__RefHeading___Toc189038545 .anchor}Figure B‑1. Synoptic SARB
Directory Structure

Figure B‑1. Synoptic SARB Directory Structure

Figure B‑1. Synoptic SARB Directory Structure

#######  File Description Tables

######## Production Scripts and Executables

The following scripts must be moved to the production environment.

[]{#__RefHeading___Toc189039744 .anchor}Table C.1‑1. Production Scripts

+---------------------+--------+--------------------------------------+
| > File Name         | >      | > Description                        |
|                     | Format |                                      |
+---------------------+--------+--------------------------------------+
| > a                 | >      | > Perl script which creates the PCF  |
| scii_gen_7.2.1P1.pl |  ASCII | > generator's ASCII file needed by   |
|                     |        | > the Main-Processor                 |
+---------------------+--------+--------------------------------------+
| > pcfgen_7.2.1P1.pl | >      | > Perl script which creates the PCF  |
|                     |  ASCII | > for the Main-Processor             |
+---------------------+--------+--------------------------------------+
| > run_7.2.1.pl      | >      | > Perl script which executes the     |
|                     |  ASCII | > Main-Processor                     |
+---------------------+--------+--------------------------------------+

[]{#__RefHeading___Toc189039745 .anchor}Table C.1‑2. Executables

+---------------------+--------+--------------------------------------+
| > File Name         | >      | > Description                        |
|                     | Format |                                      |
+---------------------+--------+--------------------------------------+
| >                   | >      | > Main-Processor executable          |
|  SynSARB_Drv.exe^1^ | Binary |                                      |
+---------------------+--------+--------------------------------------+
| > 1\. These files   |        |                                      |
| > will be generated |        |                                      |
| > on execution of   |        |                                      |
| > Subsystem         |        |                                      |
| > software and are  |        |                                      |
| > not included in   |        |                                      |
| > the tar file.     |        |                                      |
+---------------------+--------+--------------------------------------+

######## Processing Control Files (PCF), Metadata Control Files (MCF) and Status Message Files (SMF)

The Process Control Files are not included in the Software Delivery
Package. They will be created by the PCF generator scripts.

[]{#__RefHeading___Toc189039746 .anchor}Table C.2‑3. Metadata Control
Files

+------------------+--------+-----------------------------------------+
| > File Name      | >      | > Description                           |
|                  | Format |                                         |
+------------------+--------+-----------------------------------------+
| > mcf_sarbsynqc  | > ODL  | > MCF for Binary QC Report for          |
|                  |        | > Main-Processor                        |
+------------------+--------+-----------------------------------------+
| > mcf_sarbsyn    | > ODL  | > MCF for Binary CRS file for           |
|                  |        | > Main-Processor                        |
+------------------+--------+-----------------------------------------+

[]{#__RefHeading___Toc189039747 .anchor}Table C.2‑4. Process Control
Files

+-------------------------------+-------+------------------------------+
| > File Name                   | > F   | > Description                |
|                               | ormat |                              |
+-------------------------------+-------+------------------------------+
| > CER7.2.1P1_PCF_TRMM-PFM-V   | >     | > Process Control File for   |
| IRS_SSIT_000000.199807Z090^1^ | ASCII | > Main-Processor             |
+-------------------------------+-------+------------------------------+
| > 1\. These files will be     |       |                              |
| > generated on execution of   |       |                              |
| > Subsystem software and are  |       |                              |
| > not included in the tar     |       |                              |
| > file.                       |       |                              |
+-------------------------------+-------+------------------------------+

+------------------------+--------+---------------+-------------------+
| []{#__Ref              |        |               |                   |
| Heading___Toc189039748 |        |               |                   |
| .anchor}Table C.2‑5.   |        |               |                   |
| Status Message Files   |        |               |                   |
| (SMF)                  |        |               |                   |
+========================+========+===============+===================+
| > File Name            | >      | > Directory   | > Description     |
|                        | Format |               |                   |
+------------------------+--------+---------------+-------------------+
| > ANCINIT_25725.t      | >      | > smf/sarb    | > Toolkit Message |
|                        |  ASCII |               | > File            |
+------------------------+--------+---------------+-------------------+
| > PGS_25725^1^         | >      | > PGS         | > Toolkit Message |
|                        |  ASCII | _message/sarb | > File            |
+------------------------+--------+---------------+-------------------+
| > FLSALUT_25724.t      | >      | > smf/sarb    | > Toolkit Message |
|                        |  ASCII |               | > File            |
+------------------------+--------+---------------+-------------------+
| > PGS_25724^1^         | >      | > PGS         | > Toolkit Message |
|                        |  ASCII | _message/sarb | > File            |
+------------------------+--------+---------------+-------------------+
| > GFDLAER_25716.t      | >      | > smf/sarb    | > Toolkit Message |
|                        |  ASCII |               | > File            |
+------------------------+--------+---------------+-------------------+
| > PGS_25716^1^         | >      | > PGS         | > Toolkit Message |
|                        |  ASCII | _message/sarb | > File            |
+------------------------+--------+---------------+-------------------+
| > HCMOCNALB_225723.t   | >      | > smf/sarb    | > Toolkit Message |
|                        |  ASCII |               | > File            |
+------------------------+--------+---------------+-------------------+
| > PGS_225723^1^        | >      | > PGS         | > Toolkit Message |
|                        |  ASCII | _message/sarb | > File            |
+------------------------+--------+---------------+-------------------+
| > IGBPUTIL_25721.t     | >      | > smf/sarb    | > Toolkit Message |
|                        |  ASCII |               | > File            |
+------------------------+--------+---------------+-------------------+
| > PGS_25721^1^         | >      | > PGS         | > Toolkit Message |
|                        |  ASCII | _message/sarb | > File            |
+------------------------+--------+---------------+-------------------+
| > INITSARB_25701.t     | >      | > smf/sarb    | > Toolkit Message |
|                        |  ASCII |               | > File            |
+------------------------+--------+---------------+-------------------+
| > PGS_25701^1^         | >      | > PGS         | > Toolkit Message |
|                        |  ASCII | _message/sarb | > File            |
+------------------------+--------+---------------+-------------------+
| > MSFCALBIO_25722.t    | >      | > smf/sarb    | > Toolkit Message |
|                        |  ASCII |               | > File            |
+------------------------+--------+---------------+-------------------+
| > PGS_25722^1^         | >      | > PGS         | > Toolkit Message |
|                        |  ASCII | _message/sarb | > File            |
+------------------------+--------+---------------+-------------------+
| > PGS_INGEST_25702.t   | >      | > smf/sarb    | > Toolkit Message |
|                        |  ASCII |               | > File            |
+------------------------+--------+---------------+-------------------+
| > PGS_25702^1^         | >      | > PGS         | > Toolkit Message |
|                        |  ASCII | _message/sarb | > File            |
+------------------------+--------+---------------+-------------------+
| >                      | >      | > smf/sarb    | > Toolkit Message |
|  PGS_SIGMALOAD_25703.t |  ASCII |               | > File            |
+------------------------+--------+---------------+-------------------+
| > PGS_25703^1^         | >      | > PGS         | > Toolkit Message |
|                        |  ASCII | _message/sarb | > File            |
+------------------------+--------+---------------+-------------------+
| > PGS_TUNEDRV_25704.t  | >      | > smf/sarb    | > Toolkit Message |
|                        |  ASCII |               | > File            |
+------------------------+--------+---------------+-------------------+
| > PGS_25704^1^         | >      | > PGS         | > Toolkit Message |
|                        |  ASCII | _message/sarb | > File            |
+------------------------+--------+---------------+-------------------+
| > PGS_FLXRANGE_25705.t | >      | > smf/sarb    | > Toolkit Message |
|                        |  ASCII |               | > File            |
+------------------------+--------+---------------+-------------------+
| > PGS_25705^1^         | >      | > PGS         | > Toolkit Message |
|                        |  ASCII | _message/sarb | > File            |
+------------------------+--------+---------------+-------------------+
| > PGS_FLMODEL_25706.t  | >      | > smf/sarb    | > Toolkit Message |
|                        |  ASCII |               | > File            |
+------------------------+--------+---------------+-------------------+
| > PGS_25706^1^         | >      | > PGS         | > Toolkit Message |
|                        |  ASCII | _message/sarb | > File            |
+------------------------+--------+---------------+-------------------+
| > SARBMETA_25726.t     | >      | > smf/sarb    | > Toolkit Message |
|                        |  ASCII |               | > File            |
+------------------------+--------+---------------+-------------------+
| > PGS_25726^1^         | >      | > PGS         | > Toolkit Message |
|                        |  ASCII | _message/sarb | > File            |
+------------------------+--------+---------------+-------------------+
| >                      | >      | > smf/sarb    | > Toolkit Message |
| PGS_MODISAERRD_25751.t |  ASCII |               | > File            |
+------------------------+--------+---------------+-------------------+
| > PGS_25751            | >      | > PGS         | > Toolkit Message |
|                        |  ASCII | _message/sarb | > File            |
+------------------------+--------+---------------+-------------------+
| > SARBIOUTIL_25750.t   | >      | > smf/sarb    | > Toolkit Message |
|                        |  ASCII |               | > File            |
+------------------------+--------+---------------+-------------------+
| > PGS_25750            | >      | > PGS         | > Toolkit Message |
|                        |  ASCII | _message/sarb | > File            |
+------------------------+--------+---------------+-------------------+
| >                      | >      | > smf/sarb    | > Toolkit Message |
| PGS_SFCALBCALC_25707.t |  ASCII |               | > File            |
+------------------------+--------+---------------+-------------------+
| > PGS_25707^1^         | >      | > PGS         | > Toolkit Message |
|                        |  ASCII | _message/sarb | > File            |
+------------------------+--------+---------------+-------------------+
| > PG                   | >      | > smf/sarb    | > Toolkit Message |
| S_SFCALBINGEST_25708.t |  ASCII |               | > File            |
+------------------------+--------+---------------+-------------------+
| > PGS_25708^1^         | >      | > PGS         | > Toolkit Message |
|                        |  ASCII | _message/sarb | > File            |
+------------------------+--------+---------------+-------------------+
| >                      | >      | > smf/sarb    | > Toolkit Message |
|  PGS_DERIVLOAD_25709.t |  ASCII |               | > File            |
+------------------------+--------+---------------+-------------------+
| > PGS_25709^1^         | >      | > PGS         | > Toolkit Message |
|                        |  ASCII | _message/sarb | > File            |
+------------------------+--------+---------------+-------------------+
| > PGS_WRAPSARB_25710.t | >      | > smf/sarb    | > Toolkit Message |
|                        |  ASCII |               | > File            |
+------------------------+--------+---------------+-------------------+
| > PGS_25710^1^         | >      | > PGS         | > Toolkit Message |
|                        |  ASCII | _message/sarb | > File            |
+------------------------+--------+---------------+-------------------+
| > INITSYN_26003.t      | >      | > smf/sarb    | > Toolkit Message |
|                        |  ASCII |               | > File            |
+------------------------+--------+---------------+-------------------+
| > PGS_26003            | >      | > PGS         | > Toolkit Message |
|                        |  ASCII | _message/sarb | > File            |
+------------------------+--------+---------------+-------------------+
| > REGDRV_26005.t       | >      | > smf/sarb    | > Toolkit Message |
|                        |  ASCII |               | > File            |
+------------------------+--------+---------------+-------------------+
| > PGS_26005            | >      | > PGS         | > Toolkit Message |
|                        |  ASCII | _message/sarb | > File            |
+------------------------+--------+---------------+-------------------+
| > TSIRET_26004.t       | >      | > smf/sarb    | > Toolkit Message |
|                        |  ASCII |               | > File            |
+------------------------+--------+---------------+-------------------+
| > PGS_26004            | >      | > PGS         | > Toolkit Message |
|                        |  ASCII | _message/sarb | > File            |
+------------------------+--------+---------------+-------------------+
| > WRAPSYN_26006.t      | >      | > smf/sarb    | > Toolkit Message |
|                        |  ASCII |               | > File            |
+------------------------+--------+---------------+-------------------+
| > PGS_26006            | >      | > PGS         | > Toolkit Message |
|                        |  ASCII | _message/sarb | > File            |
+------------------------+--------+---------------+-------------------+
| > 1\. These files will |        |               |                   |
| > be generated on      |        |               |                   |
| > execution of         |        |               |                   |
| > Subsystem software   |        |               |                   |
| > and are not included |        |               |                   |
| > in the tar file.     |        |               |                   |
+------------------------+--------+---------------+-------------------+

######## Ancillary Input Data

The Synoptic SARB Subsystem accesses several ancillary input data files.
Many of these files are shared with the Instantaneous SARB Subsystem PGE
CER5.1P1, and are thus located in either the
\$CERESHOME/sarb/data/ancillary/static/sarb or the
\$CERESHOME/sarb/data/ancillary/dynamic/sarb directory. Ancillary input
data files only accessed by the Synoptic SARB Subsystem PGE CER7.2.1P1
are located in the \$CERESHOME/sarb/data/ancillary/static/sarbsyn
directory.

+----------------------------+-------+-----------------+--------------+
| []{#_                      |       |                 |              |
| _RefHeading___Toc189039749 |       |                 |              |
| .anchor}Table C.3‑6.       |       |                 |              |
| Ancillary Input Data       |       |                 |              |
+============================+=======+=================+==============+
| > File Name                | > F   | > Description   | > St         |
|                            | ormat |                 | atic/Dynamic |
+----------------------------+-------+-----------------+--------------+
| > SS5_DrivTab_19990315     | > B   | > Derivative    | > Static     |
|                            | inary | > tables        |              |
+----------------------------+-------+-----------------+--------------+
| > IGBP_Ver3.0              | > B   | > IGBP map      | > Static     |
|                            | inary |                 |              |
+----------------------------+-------+-----------------+--------------+
| > SigTab_Synoptic_20040730 | >     | > Sigma tables  | > Static     |
|                            | ASCII |                 |              |
+----------------------------+-------+-----------------+--------------+
| >                          | > B   | > Collins-based | > Static     |
| CollinsAer_1998TRMM_Ver3.0 | inary | > assimilated   |              |
|                            |       | > aerosol       |              |
|                            |       | > climatology   |              |
+----------------------------+-------+-----------------+--------------+
| > ControFile_20070920      | >     | > Drives        | > Static     |
|                            | ASCII | > selection of  |              |
|                            |       | > data sources  |              |
|                            |       | > based on      |              |
|                            |       | > specified     |              |
|                            |       | > record        |              |
|                            |       | > conditions    |              |
+----------------------------+-------+-----------------+--------------+
| > SS5_ZJin_OcnAlb_20011218 | > B   | > Coefficients  | > Static     |
|                            | inary | > for Zhonghai  |              |
|                            |       | > Jin surface   |              |
|                            |       | > albedo over   |              |
|                            |       | > ocean         |              |
|                            |       | > retrieval     |              |
+----------------------------+-------+-----------------+--------------+
| > SS5_GFDLAerClim_200006   | > B   | > Geophysical   | > Static     |
|                            | inary | > Fluid         |              |
|                            |       | > Dynamics      |              |
|                            |       | > Laboratory    |              |
|                            |       | > (GFDL)        |              |
|                            |       | > Aerosol       |              |
|                            |       | > climatology   |              |
+----------------------------+-------+-----------------+--------------+
| > flsa0404_lut.2s.coef     | > B   | > Surface       | > Static     |
|                            | inary | > Albedo look   |              |
|                            |       | > up table for  |              |
|                            |       | > Fu-Liou model |              |
+----------------------------+-------+-----------------+--------------+
| >                          | > B   | > Surface       | > Static     |
| flsa3_lut.4s.coef_19991215 | inary | > Albedo look   |              |
|                            |       | > up table for  |              |
|                            |       | > Fu-Liou model |              |
+----------------------------+-------+-----------------+--------------+
| >                          | > B   | > Surface       | > Static     |
| flsa4_lut.2s.coef_19991215 | inary | > Albedo look   |              |
|                            |       | > up table for  |              |
|                            |       | > Fu-Liou model |              |
+----------------------------+-------+-----------------+--------------+
| > flsa200508c.fubin.tab    | > B   | > Surface       | > Static     |
|                            | inary | > Albedo look   |              |
|                            |       | > up table for  |              |
|                            |       | > Fu-Liou model |              |
+----------------------------+-------+-----------------+--------------+
| > SAH.v5.yyyymm (in        | > B   | > Surface       | > Static     |
| > sahmaps)                 | inary | > albedo        |              |
|                            |       | > history look  |              |
|                            |       | > up tables     |              |
+----------------------------+-------+-----------------+--------------+
| > MATCH_TERRA_AOTS_CLIM\_\ | > B   | > Match         | > Static     |
| > MODIS.mm (in match_aot)  | inary | > climatology   |              |
|                            |       | > data for      |              |
|                            |       | > Terra         |              |
|                            |       | > processing    |              |
+----------------------------+-------+-----------------+--------------+
| > MATCH                    | > B   | > Match aerosol | > Static     |
| _TERRA_AOTS_MODIS.yyyymmdd | inary | > data for      |              |
| >                          |       | > Terra         |              |
| > (in                      |       | > processing    |              |
| > mat                      |       |                 |              |
| ch_aot/match_aots_yyyymm/) |       |                 |              |
+----------------------------+-------+-----------------+--------------+
| > MA                       | > B   | > Match aerosol | > Static     |
| TCH_TERRA_VERTICAL_MODIS.\ | inary | > profile data  |              |
| > yyyymmdd                 |       | > for Terra     |              |
| >                          |       | > processing    |              |
| > (in                      |       |                 |              |
| > match                    |       |                 |              |
| _vert/match_verts_yyyymm/) |       |                 |              |
+----------------------------+-------+-----------------+--------------+
| > chlor_clim.mm (in        | > B   | > Seasonal      | > Static     |
| > data/ancillary/static/\  | inary | > climatology   |              |
| > sarbsyn/chlor_clim)      |       | > of            |              |
|                            |       | > chlorophyll   |              |
|                            |       | > used as an    |              |
|                            |       | > input to the  |              |
|                            |       | > Z. Jin Ocean  |              |
|                            |       | > spectral      |              |
|                            |       | > surface       |              |
|                            |       | > albedo        |              |
+----------------------------+-------+-----------------+--------------+
| > indxs_nesds.dat (in      | > B   | > Monthly       | > Static     |
| > data/ancillary/\         | inary | > chlorophyll   |              |
| > static/sarbsyn/iceage)   |       | > based on      |              |
|                            |       | > seawifs data  |              |
+----------------------------+-------+-----------------+--------------+
| > seawifs_chlor.yyyymm (in | > B   | > Monthly       | > Static     |
| > data/\                   | inary | > chlorophyll   |              |
| > ancilla                  |       | > based on      |              |
| ry/static/sarbsyn/seawifs) |       | > seawifs data  |              |
+----------------------------+-------+-----------------+--------------+
| > zjin.ice.bin.1 (in       | > B   | > Ice look up   | > Static     |
| > data/ancillary/static/\  | inary | > tables of     |              |
| > sarbsyn/zjin)            |       | > Zhonhai       |              |
|                            |       | > Jin\'s        |              |
|                            |       | > spectral      |              |
|                            |       | > surface       |              |
|                            |       | > albedo        |              |
+----------------------------+-------+-----------------+--------------+
| > zjin.snow.bin.1 (in      | > B   | > Snow look up  | > Static     |
| > data/ancillary/static/\  | inary | > tables of     |              |
| > sarbsyn/zjin)            |       | > Zhonhai       |              |
|                            |       | > Jin\'s        |              |
|                            |       | > spectral      |              |
|                            |       | > surface       |              |
|                            |       | > albedo        |              |
+----------------------------+-------+-----------------+--------------+
| > zjin_ocean_feb04.bin (in | > B   | > Ocean look up | > Static     |
| > data/ancillary/\         | inary | > tables of     |              |
| > static/sarbsyn/zjin)     |       | > Zhonhai       |              |
|                            |       | > Jin\'s        |              |
|                            |       | > spectral      |              |
|                            |       | > surface       |              |
|                            |       | > albedo        |              |
+----------------------------+-------+-----------------+--------------+
| > Sitelist.txt             | >     | > List of sites | > Static     |
|                            | ASCII | > included in   |              |
|                            |       | > Subset SYN    |              |
|                            |       | > product       |              |
+----------------------------+-------+-----------------+--------------+

######## Output Temporary Data Files (Production Results)

[]{#__RefHeading___Toc189039750 .anchor}Table C.4‑7. Output Temporary
Data Files

+------------------------------+--------+------------------------------+
| > File Name                  | >      | > Description                |
|                              | Format |                              |
+------------------------------+--------+------------------------------+
| >                            | >      | > ASCII file created by the  |
| CER7.2.1P1_PCFin_TRMM-PFM-VI |  ASCII | > ASCII file generator to be |
| RS_SSIT_000000.199807Z090^1^ |        | > used to produce PCF        |
|                              |        | > generator used by both the |
|                              |        | > Main-Processor and the HDF |
|                              |        | > Post-Processor for the     |
|                              |        | > Full-Hour Mode.            |
+------------------------------+--------+------------------------------+
| > 1\. These files will be    |        |                              |
| > generated on execution of  |        |                              |
| > Subsystem software and are |        |                              |
| > not included in the tar    |        |                              |
| > file.                      |        |                              |
+------------------------------+--------+------------------------------+