Contents

1 What’s Here?

This web page contains support files connected with some computer programs I use, mainly Scientific WorkPlace, LaTeX, and GAMS. They may be freely downloaded.

Some of the files are plain-text files. When you click on the link, your browser may display the file, in which case just save the results to a disk file. In Netscape, the simplest way to download a text file is to do shift+left-button-click.

Unless stated otherwise, SWP means both Scientific Word and Scientific WorkPlace.

Enjoy! Send comments/corrections to mailto:viton.1@osu.edu

Phil Viton
Ohio State University

2 Endfloat Support for SWP 2.5 / 3.0

Support for the endfloat package in SWP 2.5. IMPORTANT — this will not work in previous versions of SWP.

Though SWP’s web site claims that the standard endfloat package will work in SWP3, I don’t think this is correct. The style file provided here does appear to work in SWP 3. Note that support for figures (as poosed to tables) at the end of your document relies on a hack — be sure to read the instructions in the .sty file.

Download the package (eftci.zip); January 1997.

3 Endfloat Modification

The endfloat package by default writes a reminder like “Figure 1 about here” in your document right where it found a figure (or table), before moving the float to the end of the document. This package writes the text into the margin instead. This is SW-independent.

Download the package (efmar.zip); January 1997.

4 Valign Fix for SWP 2.5

Fix for vertically aligning fixed-width cells in tables in SWP 2.5.

This fixes the problem whereby specifying any vertical alignment other than the default (Top) alignment causes the contents of the cell to be written out verbatim into your document, with a comment to the effect that you’ve asked for an AMS-LaTeX construct when AMS-LaTeX isn’t present. As far as I can tell, this is not in fact an AMS-LaTeX problem.

Also note that the effects of the Top and Bottom choices are reversed: selecting “Top” alignment gives Bottom alignment, and vice-versa. (The package does not fix this).

Download the package (valignx.zip); February 1997.

5 PFE-GAMS

This describes a way to use Alan Phillips’ PFE editor as a control center for GAMS. You can use PFE to type your GAMS source programs, then submit them to GAMS and retrieve the results all without leaving the editor.

This setup is geared to the 32-bit (Win95 or Win-NT) version of PFE: the 16-bit version should also work, with a few changes (since the 16-bit version doesn’t access the Registry; and initialization is a bit different).

To use the system you will need the PDF file which describes how to set it up (and hence the Adobe Acrobat Reader) and the setup files themselves. Alternatively, the setup instructions are now (February 1999) available in HTML format for on-line browsing.

Note that you need to obtain PFE for yourself — see below for a link.

• Read the PDF file (pfegams.pdf, about 182K): if your browser is set up appropriately, the Acrobat Reader should start automatically.
• Read the HTML version of the setup instructions.
• Download the zipped PDF file (pfegamsz.zip, about 132K) for later reading/printing.
• Download the setup files (pfegams.zip, about 13K).
• Link to PFE files from Lancaster University (UK). Important note, November 1999. Alan Phillips has announced that development of PFE has ceased. I very much regret this — PFE is a wonderful editor — and I’m leaving the link to Lancaster in place in the hopes that he’ll reconsider. Meanwhile, the final versions of PFE are available at winsite.com: look there for pfe101i.zip (Win 95/95/NT/2000) or pfe101.zip (Win3.1x).
• Link to GAMS Home Page. This contains lots of useful information, including PDF versions of the GAMS manuals.

Update, October 1998: the supplementary utility GAMSRD distributed with the PFE-GAMS system will not deal correctly with long file names (it was originally compiled with Microsoft C, version 7, which pre-dates Windows 95). I’ve now recompiled GAMSRD with the GNU mingw32 system, and the source and executable files are available here. This file is not included in the PFE-GAMS distribution: you need it only if your run PFE under Win95/98/NT.

6 The LTX2X translator for Win32 systems

LTX2X is a configurable translator for LaTeX documents: it can be used, for example to “detex” a document by removing and replacing LaTeX commands (I use this to produce versions of mostly non-math documents for inclusion in email), and for producing HTML for the Web. The program was written in C by Peter Wilson and has long been available for UNIX systems.

I’ve compiled his source under the GNU gcc compiler from Cygnus, and I’m pleased to make it available here. Note that the program has been tested only under WinNT4, and I don’t know if it will run under Win95 (though I think it probably will): if anyone experiments and finds out, please let me know and I’ll add the information here.

6.1 Restrictions

The version available here will not run under Win31. However, if you get the djgpp compiler (available free on the internet) you will probably be able to produce a Win31/MSDOS version.

The run-time distribution available here includes Peter Wilson’s original configuration files for detex and html, and some extensions I’ve produced for my own use. It also includes his manual and a couple of batch files and a Perl script to automate coping with some special features of SW documents. (You will need a Perl interpreter to work with this). See the included file setup.txt for details and installation instructions.

I’m also making available the source code: this contains a “make” file which works under the Cygnus gcc compiler See the included file describe.txt for details.

6.2 Update, September 1998:

I now have a version which runs without the Cygnus DLL, saving about half a meg of disk space. The source distribution now also contains a file makev.bat which will compile LTX2X under the “minimalist” mingw32 version of the gcc compiler.

• Download the Cygnus run-time version (ltx2xusc.zip, about 397K); February 1998.
• Download the source code (ltx2x.zip, about 244K).
• Download the non-Cygnus run-time version (ltx2xusm.zip, about 194K); September 1998.

The translator can also produce HTML versions of your LaTeX; but, like most of these translators, doesn’t handle math well. A very promising alternative is Ian Hutchinson’s freeware TtH translator, which does amazingly well in converting math using the built-in fonts of your computer. I ran a series of econometrics notes through this, and was very pleased with the result. I’ve heard an occasional comment that the display from the TtH translator falls a bit short on systems other than MS-Windows. You’ll have to experiment. See also the Hevea and TeX4ht translators described below.

• Link to the TtH translator

7 The alltimes package

This tiny package does three things:

1. It acts as a cover for the mathtime package, automatically setting the option noTS1 for using Times Roman in both text and math, which I can never remember when I need it. It also sets the option cmbold, which uses Computer Modern bold fonts for bold Greek characters, which are not available with Times. (Instructions are provided for making this a user-specifiable option).
2. It adds two additional options:
   • cmtt: this replaces the Courier font with Computer Modern’s typewriter font.
   • cmss: this replaces the sans-serif Arial font with Computer Modern’s sans-serif font
3. It provides a redefinition of the \cents macro for producing the US cents symbol — the default one looks terrible. This macro has been tested only at 11 points.

In my opinion the two font substitution options — particularly the use of the Computer Modern typewriter font — make for a much nicer look to documents produced with the Times option. (Note that you can easily do these replacements without the package by saying, in the preamble, eg, \renewcommand{\ttdefault}{cmtt} but, especially in SWP, I prefer to keep the amount of typing I need to do in the preamble dialog to a minimum.)

Thus if you add, in your preamble

\usepackage[cmtt,cmss]{alltimes}   or   \RequirePackage[cmtt,cmss]{alltimes}

you get: Times Roman fonts for math and text, except that Computer Modern will be used for bold Greek math, typewriter and sans-serif text.

Download the package (alltimes.zip): October 1998.

8 The Hevea LaTeX to HTML translator for Win32

Hevea is a LaTeX to HTML translator, written in the Objective Caml programming language. Three important features of the translator are:

• It understands LaTeX, hence can be extended to cope with non-standard LaTeX constructs.
• It uses font resources (HTML entities) to render mathematics expressions; the up-side is that even for browsers which do not understand mathML, images are not required for formulas.
• An included companion program, Hacha, can cut your HTML document into linked subdocuments.

The port is provided by permission of the author, Luc Maranget, INRIA, France. It is available only for 32-bit Windows systems — Windows NT4/2000/XP and Windows 95/98 (NT 3.5.1 and Windows 98 are untested). It will not run under Windows 3.x or MS-DOS.

8.1 The Distribution

Starting with Hevea version 1.01 we provide only the executables, and not the source code. Thus you no longer need the Objective Caml programming system. A nice feature of versions 1.04+ is that they support LaTeX-to-plain-text and LaTeX-to-Info translations.

8.2 Current Version

The current version of the Win32 port is Hevea version 1.10, compiled September 12, 2007.

8.3 Instructions

You can read the installation instructions now as a text or as an HTML file produced by Hevea. (A copy of the HTML version is included in the distribution).

• General Win32 Distribution (version 1.10): Download winport.zip (about 370K), the Win32 distribution. You will need an unzipper which understands long file names.
• Hevea Home: Here’s a link to the Hevea site, where the Hevea manual is available in various formats. This site also has an on-line Hevea manual.
• SWP Distribution: I’m pleased to announce the availability of support for the Scientific WorkPlace family of products (Scientific WorkPlace, Scientific Word and Scientific Notebook). This support includes source-level support for SWP graphics and for Unicode. Details, including a pointer to the downloadable archive plus a long-ish Tutorial, aimed at those SWP users who have so far managed to avoid any knowledge of LaTeX, are available here.

9 The TeX4ht TeX/LaTeX-to-HTML Translator

TeX4ht is Eitan Gurari’s TeX/LaTeX-to-HTML translator. Here are some links for this system:

• TeX4ht Home Site: Eitan Gurari’s TeX4ht home site, with source files, documentation, and examples.
  
• MiKTeX: My setup instructions for TeX4ht under MiKTeX (Christian Schenk’s Win32 TeX system).
• Scientific Word /Scientific WorkPlace: It is possible to get TeX4ht to work with SW/SWP systems, using only the TrueType fonts which come up with these systems. This requires you to obtain and install several “helper” applications, like Ghostscript, DVIPS and ImageMagick. Full instructions are provided in the distribution.

  June 2000: Version 2 of the SWP support is now out. Features:

  • No package needed! Previous versions of TeX4ht required that you use a special package to invoke the system. This is no longer necessary (but is still supported). The new batch files take care of all these details automatically. The upshot is that in many cases you will be able to convert your document to HTML without having to make any changes in it.
  • Quasi-automated installation.
  • Greatly enhanced support for pictures, including support for automatic conversion of some picture types.
  • Support for MathML and Mozilla translation (though until capable browsers emerge this is of limited usefullness).
  • Enhanced support for Portable LaTeX documents.

  The SWP-TeX4ht distribution: swp-ht.zip

  The online documentation (included in the distribution): swp-ht.html.Th

  Basic installation instructions:

  1. Start a DOS session.
  2. Decide where you want to put the TeX4ht system. This must be in a directory (folder) whose name (path) does not contain spaces: I recommend c:\tex4ht.
  3. Create this directory: md c:\tex4ht
  4. Change to this directory: cd c:\tex4ht
  5. Create the directory temp under this: md temp
  6. Unzip the distribution file swp-ht.zip to the temp directory you just created.
  7. Now proceed with the rest of the installation, as described in the documentation.

10 Getting Started with custom-bib: An Introduction for SWP Users

The typeset appearance of a BibTeX bibliography is governed by the “bibliography style” (.bst) file associated with your document, which you choose when you insert the Bibliography tag from within SWP. One of the most frequently asked questions about this is: how do I get the bibliography into the format that journal X requires? While it is occasionally possible to hack the .bst file, there is a much better solution: generate a customized bibliography style file yourself, set up just the way you want it. Patrick Daly’s custom-bib package makes this astonishingly easy to do, and to encourage SWP users to get to know this package, I’ve churned out a quick note explaining how to set up and use it.

Here is a link to that note.

11 Automating PDF Production with SWP

It’s easy to use SWP and Ghostscript 6.0+ to produce excellent PDF: you typeset-compile your document, print it to an on-disk PostScript file, and then run the PostScript file though GhostScript’s ps2pdfxx.bat routine. The advantage of PDF is its typographic fidelity: it looks just like your typeset document. The disadvantage is that PDF files are considerably larger than HTML files, but in these days of fast Internet access that’s not the problem it once was, and PDF has become a second de facto standard in Internet documentation.

I’ve put together a setup that automates the task of producing PDF from your SWP documents. Once it is installed, you will be able to turn your SWP TeX source into PDF by running a single command. And because you first print to disk into a PostScript file, you don’t have to worry about embedding TrueType fonts into your document: the PDF produced by this system will automatically be readable by anyone with the free Adobe Acrobat reader (version 3+).

This is a command-line setup, but Steve Mayer has also updated his GUI TeXConverter to accomodate it, so if you’ve an aversion to working at the DOS prompt, there’s something here for you, too. You can read all about it here in HTML format, or you can read it in a PDF file (much larger, of course) produced by the system, or you can just retrieve the SWP distribution (which also contains the HTML file).

SWP versions supported: Scientific Word and Scientific WorkPlace 3.0+; I believe that it will also work with SW or SWP version 2.5 as long as you’re running on a Win32 platform. But this is untested.

Note: As of SWP5 we have built-in support for PDF production using pdfTeX. This has a few substantial advantages over the method outlines here: it allows you to use the hyperref package to customize your PDF; its faster; and you can produce PDF with rotated tables, using teh rotating package (though there’s still no way to get rotation in DVI output). If you’re using SWP5+, then the built-in support is preferable to this strategy.

12 Typesetting Currency Symbols in SWP

Current versions of SWP allow you to enter currency symbols (eg the Euro) into your documents, but do not permit you to typeset those symbols (you get black squares instead). I’ve developed a way around this: with this support you should now be able to typeset all the currency symbols (plus other text symbols on the SWP Miscellaneous Symbols panel).

SWP versions supported: Scientific Word and Scientific WorkPlace 3.0+.

• You can read about the support here
• Or you can just download currency.zip (about 38K) which contains a setup routine, and a copy of the documentation (currency.html). Unzip currency.zip to some empty directory, and read the documentation for further instructions.

13 Running Gauss code in Ox

Jurgen Doornik’s Ox is an important econometric programming language closely based on C/C++. But it has another valuable feature: with it you can run Gauss programs with relatively little fixup, and obtain results identical to those under native Gauss. It is also free for academic research and teaching.

• Here is a link to the main Ox site, where you can read more about Ox (version 3, released July 2001): http://www.nuff.ox.ac.uk/Users/Doornik/index.html
• I have produced a brief write-up on the mechanics of converting Gauss code to run under Ox: you can read it here as HTML or PDF.
• Some actual converted Gauss code which will run under Ox:
  • Ken Train’s panel-data mixed-log model. The Ox code is available here, in train0299-ox.zip. You will need Train’s original documentation on the way the code expects the data to be formatted: you can get it at http://elsa.berkeley.edu/~train/ Click on Software then Mixed logit estimation for panel data. The file you want is train0299.zip. This file also contains a test data set.
  • Ken Train’s cross-sectional mixed-logit model. The Ox code is available here, in train0199-ox.zip. You will need Train’s original documentation on the way the code expects the data to be formatted: you can get it at http://elsa.berkeley.edu/~train/ Click on Software then Mixed logit estimation for cross-sectional data. The file you want is train0199.zip. This file also contains a test data set.

14 OxEdit+GAMS: another GAMS IDE

For some time now my preferred environment for editing and running GAMS programs under Windows has been Alan Phillips’ PFE editor (see PFEGAMS for more on this). But a couple of years ago Alan Phillips announced that he was no longer developing PFE; and ever since, I’ve been on the lookout for a substitute. I think I’ve found one, using Jurgen Doornik’s OxEdit; and this note describes how to obtain and set up this environment, which I call OxEdit+GAMS.

OxEdit+GAMS has some nice features:

• Syntax coloring: GAMS keywords are automatically colored, as are text strings, numbers etc. This can substantially reduce the number of GAMS errors: you type SETT when you mean SET and the fact that nothing happens — no coloring takes place — immediately alerts you to the fact that something is wrong.
• Parenthesis checking: mismatched parentheses are flagged on screen, which helps reduce another very common source of error.
• Interaction between compilation errors and the source document: GAMS error messages are displayed in a separate window; you double-click on one of these, and you are immediately taken to the offending line in the source. This feature requires that a scripting language — either Perl or VBScript — be installed on your system. Both of these are freely available.

You can read more about this IDE here, in HMTL or PDF forms. Complete installation instructions and a screenshot are included.

15 Using different citation forms in SWP

This short document explains how you can get SWP to work with the various citation forms — for example, a noun-like format in which \cite{viton:2000} results in the citiation form: Viton (2000), rather than the standard form (Viton, 2000) — supported in packages like natbib or harvard.

SWP versions supported: 3.0+ (though I don’t see why it wouldn’t work for 2.5 either).

Read the instructions here

16 Using Type1 fonts in SWP5

This note explains how you can use (free) Type1 fonts in SWP5+, but only when you’re producing PDF using the new built-in pdfTeX support. As an example, I explain how to install and use Young Ryu’s TX and PX font systems. The TX fonts are a Times-like setup, which, unlike mathtime (included with SWP since version 3.0), provides a genuine caps-and-small-caps font, as well as bold Greek fonts (econometricians, rejoice!). The PX fonts are similar to the TX fonts, except that the font style (text and math) is Palatino. In addition, I provide a sketch of a small package which will allow you to use these fonts only when you’re producing PDF, and set up the hyperref package to customize your PDF.

SWP versions supported: 5.0+. Note that this is available only when you produce PDF using SWP’s built-in support.

Read the instructions in HTML format here , or in PDF format (dc fonts) with live links to other font setups here

17 lgrind — program listings in SWP

lgrind is a system for including pretty-printed listings of computer code within your LaTeX document. I’ve produced a version of the lgrind executable which runs under Win32.

• Non-SWP users: read the setup instructions here
• SWP users: there’s a much mor extensive document discussing your options for including code into your SWP document available here .
• All users: Get the zipfile lgrindswp.zip containing the system here . This zip archive also contains a copy of the setup and both sets of usage instructions in HTML format.

18 OSU Dissertation support for SWP

A while back I produced some SWP support for Mark Hanes’ class and style files for typesetting OSU dissertations. Note that his support is conditioned on the requirements as of 1996: since then the Grad School has somewhat relaxed the formal requirements — and you are now also required to submit a only a PDF version — but I think that Mark’s original files will still do. As far as I know, his support is not being updated; but if anyone finds a more recent source of LaTeX support, let me know, and I’ll be glad to reference it.

Read the write-up here . This document also contains links to the files you will need to download.

19 Documentation for the Spaeth ALLCOURT database

I’ve produced, originally for my own use, updated , expanded and hyperlinked versions of the documentation of the Spaeth database of US Supreme Court decisions from the Warren Court onwards. The documentation comes in three formats:

• codebook-a.pdf : this is suitable for printing, and contains extensive cross-references to page numbers.
• codebook-b.pdf : this is intended for online usage. The cross-references are live: if you click on a bit of red text, you should be taken to the appropriate description (or in the case of page references, to the top of the relevant page).
• codebook-c.html : HTML version of codebook-b.pdf. The links should work in the same way. This may be faster to navigate with; but of course it sacrifices typeset quality. The file comes with a .css file which should be placed in the same folder as the .html file.

  All three formats are included in the zip archive, available here . You can also read the HTML version here

20 A Scratch Work area for SWP

I explain how you can set up a non-printing area within your SWP documents, which you can use for preliminary computations, or notes to yourself for things that need to be done/altered/fixed. You can read the instructions here . There’s also a tiny zip file to help you get started, available here . (The zip archive also contains a copy of the instructions).

21 Using the booktabs Package in SWP

The booktabs package produces tables which to some eyes look more professional than those produced by standard LaTeX: you can open booktabsA.pdf to see a comparison of the two.

It turns out to be relatively easy to produce the booktabs table layout within SWP, and I have writeen a short guide for this purpose. You can download the guide here . The main file is booktabsB.tex which you can read from within SWP.