USER GUIDE

(Updated 4/19/02)

• Procedure to FTP files
  
  
• Naming syntax for files

The SBI Field Catalog can be accessed via the Healy network at http://catalog/sbi/catalog.

If you want to submit a small number of products or reports to the catalog, you can use the product upload form. Contact Greg Stossmeister (gstoss@ucar.edu) for the password to this form. If you have a large number of files to submit please use the ftp method described below. 
 

1. Submission of files for inclusion in the catalog using ftp


All products and reports submitted to the catalog should meet certain naming conventions. If a file does not meet the naming convention, it will not be inserted into the catalog automatically. Files with improper names will be moved to a holding area for renaming or deletion.

Files to be included in the catalog must be placed in the anonymous ftp area in a particular directory as shown below:
 

FTP to catalog machine (catalog) - ftp catalog

Login anonymous - anonymous

Password "your email" - "your email"

Change directory to pub/incoming/catalog/ - cd pub/incoming/catalog/

Change to binary mode - binary

Put files - put your_file

Quit - quit
 
 

If your file does not appear in the catalog within 10 minutes the file has been moved to a holding area as it does not meet the naming convention. To check if your file has been moved log back into the catalog machine as follows:
 
 

FTP to catalog machine (catalog) - ftp catalog

Login anonymous - anonymous

Password "your email" - "your email"

Change directory to pub/incoming/catalog/junk - cd pub/incoming/junk
 
 

All misnamed files will reside here. Resubmit your file after renaming on your machine. If you do not have a copy of your own file, you may down load it from this site now. If you are having persistent problems with files being moved to the junk area ask a JOSS staff member to help you.
 
 

2. Naming of files for submission to the catalog.

   
   All files submitted to the catalog must conform to the following convention:

   name1.name2.yyyymmdddhhmm.name3.ext  or   category.platform.date.product.extension
    

   where,
    
    

   
   1. To submit products to the "Underway Sensor Products" section of the catalog use the following format:

   name1 - must always be "ops"; for the Operational Products.

   name2 - should be the platform name; e.g. radar, sounding, goes-8

   yyyymmddhhmm - This is the 4 digit year, two digit month (01-12), two digit day (01,02...11,12...), two digit hour (00-23), and two digit minute (00-59) in UTC. Every file MUST have this block. If hour and minute are not relevant they can be left out.

   name3 - should be the product name. This may be temperature, visible, IR, theta or similar.

   ext - This is the file extension. For all files being submitted to the catalog, the acceptable extensions are .gif , .jpg, .txt, .html only. If you have trouble with converting a file to one of these file types, contact a JOSS staff member for advice.

   
    

   

   2. To submit products to the "Research Products(non-station)" section of the catalog use the following format:

   
   name1 - must always be "research" .

   name2 - should be of the form "platform". Examples are "S-Pol", "NRL_P-3".

   yyyymmddhhmm - the same as for "Underway Sensor Products" above.

   name3 - should be the product name. This may be temperature, visible, IR, theta or similar.

   ext - the same as for "Underway Sensor Products" above.

   (example file name: research.S-Pol.200204191200.base_reflectivity.jpg) 
    

   

   3. To submit products to the "Research Products(station)" section of the catalog use the following format:

   
   name1 - must always be "station_#" . where "#" is the station number. This may be station_HLY-02-01-001,station_HLY-02-01-001, etc

   name2 - should be of the form "platform". Examples are "S-Pol", "NRL_P-3".

   yyyymmddhhmm - the same as for "Underway Sensor Products" above.

   name3 - should be the product name. This may be temperature, visible, IR, theta or similar.

   ext - the same as for "Underway Sensor Products" above.

   (example file name: research.S-Pol.200204191200.base_reflectivity.jpg) 
    

   

   4. To submit products to the "Shipboard Reports" section of the catalog use the following format:

   
   name1 - must always be "report".

   name2 - should always be platform or location, Operations, NRL_P-3, or one that has been predefined by JOSS. Check with a JOSS staff member before submitting a report for the first time.

   yyyymmddhhmm - the same as for "Underway Sensor Products" above.

   name3 - should be the product name. This may be Summary, Status, Mission_Summary or similar.

   ext - the same as for "Underway Sensor Products" above.

   (example file name: report.Operations.200204191200.Summary.html)
    

   1. How to include a figure in a report
   If the files you submit have an ext of html (i.e if the report is of type html), then other products anywhere else on the catalog maybe dynamically linked to it.
   Find the image of interest in the field catalog and scroll to the bottom. Immediately visible below the image will be text of the form:

   Sample HTML to link to this image:
   <a href="/sbi/catalog_hly-04-02/products/goes-8/20010402/goes-8.200104020501.svissr_ir1.jpg">goes-8.200104020501.svissr_ir1.jpg</a>

   Please cut and paste the line "<a href=..." into your html document. Once the document has been submitted to the catalog this HTML link should work. If none of the above makes sense or you have any problems/questions please contact Greg Stossmeister (gstoss@ucar.edu)

   ---

   Back to SBI Field Catalog
   comments : gstoss@ucar.edu