To accomplish the CL revision and analysis summarized in this report, we developed several Fortran programs. These programs were written for our own use, they are neither bug-free nor especially user-friendly, and they are unsupported. However, they are available upon request if anyone wishes to attempt to use them for their own use. This section briefly describes these programs.
This is a multi-purpose program which processes a master input file of UTIG contribution list and citation information, producing several different output files. In initial checking of the CL certain output files are useful for finding errors in the input and for building trial character strings for the SCI CD-ROM search; subsequently other output files are useful as input for statistical analysis programs or for building word-processed sublists of the CL.
Data in the master input file is in the following form:
263
Watkins, J. S., and J. L. Worzel
Serendipity gas seep area, South Texas offshore
Am. Assn. Petrol. Geol. Bull.
62
1067-1074
1978
*jaM
*aG1
*1993 3 3 3
*1994 1 1 1
*1995 1 1 1
*1996 1 1 1
1075
Sen, M., and P. L. Stoffa
*not#Global Optimization Methods in Geophysical Inversion#, Elsevier Science Publishers
1995
*aG1
*jaA
*chk MS-Dec. 1997; PS-Dec. 1997
*1993
*1994
*1995 1 1 0
*1996 2 2 0
For each contribution, the first line is the contribution number, the second line is the author or authors, and the third line is the title. For ordinary journal articles, the fourth, fifth and sixth line are the journal name, volume, and page numbers; for other contributions (where the title line begins with '*not') the title line includes the remaining information.
After a year line, lines beginning with '*' summarize various information about contribution category and about citations. This includes information about journal category:
'*jaM' - mainstream journal
'*jaA' - archival contribution
'*pmx' - proceedings, map, or cross section;
'*jaO' - other journal;
'*com' - comment
'*trp' - technical report and about author category:
'*aG1' - UTIG first-authored article
'*aS1' - student first-authored article
'*aGn' - UTIG coauthored article
'*aF1' - UT faculty-member authored article
'*aB1' - UT MSI biologist-authored article.
A line such as '*1993' indicates that we have checked in the 1993 SCI CD-ROM and found no citations; a line such as '*1996 2 2 0' means that in the 1996 SCI CD-ROM two citations were found, both were not first-author self-citations, but none were non-coauthor self-citations. The line beginning '*chk' indicates that the contribution was checked for accuracy.
There are also other input files which summarize various types of information. 'Journals.type' identifies journals as mainstream, archival, or other, and presents a suitable abbreviation for the SCI CD-ROM character string.' AuthorHist.dat' identifies individuals as students, UTIG staff, or UT faculty, and gives their dates of employment or dates of graduation.
Running a compiled version of UTIGread.f produces various output files useful for checking format accuracy include files named 'Journals.xxx', 'volume.xxx', 'pages.xxx', and 'year.xxx'; in these each line gives the contribution number and the designated information. A similar file named 'Authors.xxx' produces a line with the contribution number, author order, and author name for every coauthor on every article.
Each line in the 'Author.xxx' file also summarizes information useful for statistical analysis.
263 UG M 1 2 1978 WatkinsJS 93: 3 3 3; 94: 1 1 1; 95: 1 1 1; 96: 1 1 1; 97: 0 0 0
263 GG M 2 2 1978 WorzelJL 93: 3 3 3; 94: 1 1 1; 95: 1 1 1; 96: 1 1 1; 97: 0 0 0
For example, the above lines for #263 indicate which authors are UTIG staff, students, faculty, or unknown (G, S, F, or U in column 7), the author category of the publication (G, g, S, F, or B in column 8 indicates G1st, Gnth, S1st, F1st and B1st, respectively), the journal category of the publication (M, A, O, t, c, or B in column 10 for mainstream, archival, other, technical report, comment, or biology). Finally, the line summarizes the citations found for the article for each year.
There are two other useful output files. 'OutFile.troff' translates master input file data into a troff format ; troff is a quite flexible but now archaic word processor which is available on the UTIG Sun workstations; in the future we may also output this information in a more modern word-processed format. 'SCIname.xxx' processes the author, journal, volume, etc., information into a form as a trial for the SCI CD-ROM program. For example, for the two examples above it produces:
263 WATKINS-J*-1978-AAPG-*-V62-P1067
1075 SEN-M*-1995-*
Because the information for #1075 doesn't possess volume and page information in the master input file, additional information needs to be added before it is used to recover citations from the SCI CD-ROM.
These short utility programs sorts files such as 'Authors.xxx' and 'Journals.xxx' into forms more useful for subsequent analysis. OrderAB.f is a simple alphabetizing program. One specifies an input file and two column numbers; it then reorders the file alphabetically with respect to alphabetic information between the to specified columns. Thus, since author names are between columns 27 and 41 in 'Author.xxx', this reorders the file to make it easy to find each individual's contributions.
OneColSort.f splits an input file into two files, with all lines having a specified character in a specified column going into one output file, and all others going into a second output file. By applying this to file 'Authors.xxx', specifying column xx and 'B', one obtains two new filesÐone with no contributions from MSI biologists, and another with only contributions from MSI biologists.
This program plots out graphs summarizing the time-dependence of contributions and citations for a specified input file. The program is controlled by a driver file 'UTIGpltdriver'; e. g., for Figure V.A.1 this contained:
Regular Plot
Authors.AllUTIG
output.xxx
UTIGcont/UTIG.ps
2.0000 10.200 Staff & Students
4.5000 00.200 15 April 98 data
AC 1 1972 1998 1972.5 1100 1.000 7.250 2.750 2.750 0.10
A1 0 1972 1998 1972.5 800 1.000 4.000 2.750 2.750 0.10
AN 1972 1998 1972.5 700 1.000 0.750 2.750 2.750 0.10
CA 2 1993 1997 1993.0 4000 4.250 7.250 2.750 2.750 0.10
CS 1993 1997 1993.0 4000 4.250 4.000 2.750 2.750 0.10
CN 0 1993 1997 1993.0 3000 4.250 0.750 2.750 2.750 0.10
CC-1 1993 1997 1993.0 3000 4.250 0.750 2.750 2.750 0.10
This program produces troff files of specified subsets of the CL. It requires two input filesÐone in troff format like OutFile.troff, and a second containing a list of contribution numbers. For example, if the list has all numbers for a particular individual, the output will be a troff-formatted file of this individual's contributions.