A list of all the output files produced by SPENVIS is given in the table below. The file names of the outputs of SPENVIS are spenvis_xxx.html for report files and spenvis_xxx.txt for data files (with a few exceptions). In the first column, the files are listed alphabetically by the three character label xxx). The second column contains a short description of the file contents, the third column identifies the model or tool that produces or modifies the file, and the fourth column lists the models or tools that use the file as input. Clicking on a file name extension will bring up a description of the file formats.

The output files can be downloaded via the directory listing in the results page for each model.

General description of the tabular output format

• read by a FORTRAN program;
• read by an IDL® program;
• imported into a spreadsheet program (e.g. Microsoft® Excel);
• migrated between different platforms;
• written by the UNIRAD/SPENVIS programs.

File specifications

      OPEN(UNIT=n, FILE='project.csv', FORM='FORMATTED', 
     :     ORGANIZATION='SEQUENTIAL', RECORDTYPE='STREAM')

Each record contains comma (,) separated values that can be read by a FORTRAN list-directed READ statement. The integer and floating values are represented by their decimal forms (e.g. 123, -98, 734.5, -3.2345E+10, +6.2345D+68), optionally preceded by white space characters (ASCII code 32). The character strings are delimited by apostrophes (') without other characters before or after the apostrophes. When an apostrophe has to be included in the character string, it is represented by two consecutive apostrophes.

Example

      PROGRAM sample_1
C
      INTEGER      k1, k2
      REAL         r1, r2
      CHARACTER*32 s1
C
      DATA k1, k2, r1, r2/ -547, 12, -5.978E-18, 6371.2/
C
C     File creation
C
      OPEN(UNIT=1, FILE='sample_1.txt', FORM='FORMATTED', 
     :     ORGANIZATION='SEQUENTIAL', RECORDTYPE='STREAM')
      WRITE(1,1000) k1, r1, k2, r2
      CLOSE(1)
C
C     format
C
 1000 FORMAT( i6, 1h,, 1p, e13.6, 0p, 2h,', 
     :        'Text with an apostrophe:''''.', 2h',, i8, 1h,, f10.3)
C
C     File read
C
      OPEN(UNIT=1, FILE='sample_1.txt', STATUS='OLD')
      READ(1,*) k1, r1, s1, k2, r2
      CLOSE(1)
C
      PRINT*,k1
      PRINT*,r1
      PRINT*,s1
      PRINT*,k2
      PRINT*,r2
      END

Internal organisation

The general structure is illustrated with the help of a sample file.

Header section

The header section is directly followed by the body section.

Future extensions

Body section

The number of records contained in the body section is not explicitly determined. An expected value of this number is given by the 8th element of the first record of the header section (nbody).
Practically, the end of the body section is defined by the detection of the footer section.

Footer section

For the sake of uniformity the following character strings are suggested:

• 'End of Block', to indicate that the next part of the output file is related to the next namelist section;
• 'End of File', to indicate that the end of the output file has been reached;
• 'Section Break', to indicate that the next part of the output file is related to the same namelist section (see npart in the header section);
• 'End of Namelist', to indicate that, next to the current part, parts have been added in the output file which are not related a common namelist section.

Sample file

Comments

• The first record (in black) indicates that
  • the header section extends from record 1 to 13;
  • the header section includes 2 text lines, 3 metavariables, 4 reserved records, and 3 variable definitions;
  • each record of the body section contains 8 elements corresponding to the values of the 3 variables;
  • the number of records of the body section was unknown when this record has been written;
  • there is only a single part associated to the current namelist section.
• Records 2 and 3 (in green) contain the two text lines.
• Records 4 to 6 (in red) contain the three metavariables: EPOCH, ENERGY and MODEL. The metavariable EPOCH corresponds to a single real number while the metavariable ENERGY is a vector of 6 elements. The metavariable MODEL refers to a character string.
• Records 7 to 10 (in silver) correspond to an area, the format of which is not defined by the current specification.
• Records 11, 12 and 13 (in blue, brown and magenta, respectively) contain the definition of the three variables. Both first and third variables (AMJD and L) correspond to single real numbers. The second variable (FLUX_EL) is a 6-element vector of real numbers.
• Records 14 to 21 correpond to the body section. Each record contains 8 elements associated to the three variables AMJD, FLUX_EL and L. The colors highlight the association between the columns and the variables.
• Record 22 is the footer section.

Last update: Fri, 20 Apr 2018