Instructions for compiling and using program CF2PS -------------------------------------------------- by Steve Hilla, 29 January 2003. The CF2PS program requires only one *.cpp file: cf2ps.cpp. There are no user- defined include files that are needed. The program was originally compiled using Borland C++ Builder Professional Version 5.0 (Build 12.34) Update Pack 1. It was compiled on a PC running Windows NT 4.0 Build 1381: Service Pack 6. If you are using Borland C++ Builder, you should be able to load three files into a directory and get the program to compile; the three files you need are cf2ps.cpp, cf2ps.bpr, and cf2ps.bpf. The last two files are specific to the Borland C++ Builder compiler. The program was also compiled on a Unix machine using an ANSI/ISO C++ compatible compiler. For UNIX, a few lines needed to be commented out, and one line added (as denoted in cf2ps.cpp). The program ran fine on a Hewlett Packard workstation runing HPUX 11.11. Of course, the GMT software and the Ghostscript software were also installed on the UNIX workstation. There are three example data files included: cha22170.02o, brdc2170.02n, and cha22170.mp1. The first two files can be run through the TEQC program to create the third. The CF2PS program can be used on the third file to create a postscript file called cha22170.mp1.ps . Other files: As mentioned in the corresponding technical paper ("A new plotting program for Windows-based TEQC users", GPS Solutions, Volume 6, Number 3, 2002) while the CF2PS program is running it creates files called legend.txt, makePS.bat, cf2ps.sum, and several prn*.xy files. Example copies of the first three files are included on the website. A PC-executable file is included: cf2ps.exe. One should be able to run this program on the example TEQC plot file, cha22170.mp1, to create a postscript file called cha22170.mp1.ps using the DOS command: cf2ps -icha22170.mp1 -b"2002 8 5 5 0 0.0" -e"2002 8 5 9 0 0.0" This can only be done if the GMT software is loaded on the PC. The PostScript file, cha22170.mp1.ps, can then be viewed or printed if the Ghostview software is installed on the PC. Installing GMT and Ghostview: The technical paper, "A new plotting program for Windows-based TEQC users", gives the details about where to find GMT and Ghostview and what files to read for instructions on how to install these software suites on your PC. For convenience, the instructions are repeated below (see "Downloading TEQC, GMT, and Ghostview"). After installing the GMT (Generic Mapping Tools) software on the PC make sure that it is working by typing a GMT program name at the DOS command prompt (e.g. type 'gmtset'). This should start the gmtset program that is part of GMT and give you the usage message for program gmtset. If this does not occur then the GMT software is not yet active on your PC and you will not be able to successfully run program cf2ps.exe. After installing the Ghostview software you can verify it is working by running the gsview32.exe program from its icon on your desktop and then trying to view the example cha22170.mp1.ps file included on the website. Downloading TEQC, GMT, and Ghostview: The TEQC program can be downloaded from the UNAVCO website: http://www.unavco.ucar.edu/data_support/software/teqc/teqc.html From the main TEQC page, scroll down to the section entitled Microsoft Windows and DOS zip files. Then download the appropriate zip file for your PC's operating system. The Generic Mapping Tools (GMT) software can be found at the University of Hawaii, School of Ocean and Earth Science and Technology website: http://gmt.soest.hawaii.edu Scroll down to the section entitled "GMT master and mirror sites". Click on one of the mirrorsites and download the README.GMT file. All of the files needed for Windows-users are listed as *.zip files; this file explains what each *.zip file contains. To start out simple, the reader may wish to download only the following files: GMT_exe.zip, GMT_share.zip, GMT_suppl_exe.zip,GMT_pdf.zip, and netcdf-3.5.0.win32bin.zip. The CF2PS program uses GMT to create fairly simple XY-plots. But the GMT software can also be used to generate high-quality maps using several different coastline data sets. The reader may wish to download these different coastline files later on for the purpose of building maps. There are also source code files that the reader may wish to download at a later time. Once the GMT software has been unzipped, examine the README.WIN32 file in the main GMT directory for instructions on how to configure your PC to run GMT. The AFPL Ghostscript software is available from the Computer Science Department at the University of Wisconsin: http://www.cs.wisc.edu/~ghost First click on "Obtaining AFPL Ghostscript 7.04". The acronym AFPL stands for "Alladin Free Public License". Then scroll down to the section entitled "Windows 95, 98, ME, NT, 2000 or XP". Download the files gs704w32.exe and gsv43w32.exe. Execute the first file to install Ghostscript version 7.04. Then run gsv43w32.exe to install GSview. Ghostscript/GSview will require about 17 MB of disk space. The GMT software, using just the five *.zip files mentioned above, will require about 22 MB of disk space. Since both of these software packages are actively maintained, the reader can expect that each of the above mentioned websites will eventually contain future versions of the software.