Sandia National Laboratories
SAND Report LaTeX class
Home
Introduction
Template
Examples
SANDmath.tex
SAND Memo
Usage
Preamble
Body
Markings
Download
v1.32: April 30, 2009

Tar ball
Change log
FAQ
Tips
Links
SAND Memo Class
Tar ball

DOWNLOAD

You can download all necessary files plus the examples in a single tar ball: SANDreport.tar.gz. The tar ball includes the files needed to typeset Sandia memos (curtesy Org. 1520 and Rich Field), as well as Philippe Pébay's SAND Math style file. The following sections describe the files and lets you download each individually.

Mandatory files for SAND Reports:

You will need at least the following files:

SANDreport.cls The class file itself.

DOEbwlogo.eps The DOE logo for the back cover page, or

DOEbwlogo.pdf if you are using pdflatex.

snllineblk.eps The SNL logo for the front cover page, or

snllineblk.pdf if you are using pdflatex. And

fancyhdr.sty. The one that came with your LaTeX distribution may not quite work when you are using markings and pdflatex. You really should upgrade your LaTeX distribution.

Mandatory files for SAND Math:

You only need the following file:

SANDmath.tex The style file itself.

Mandatory files for SAND Memos:

You will need at least the following files:

smemo.cls The class file itself.

sfonts.cls If you want PostScript files.

snllineblubrd.eps for the blue logo in encapsulated PostScript.

snllineblubrd.jpg for the blue logo as a jpeg.

Template file:

SANDtemplate.tex is a LaTeX template that should get you rapidly going creating SAND Reports.

smemo_template.tex a LaTeX template that should help creating SAND Memos.

OUOmemo_template.tex This is a template that helps you create OUO memos. It uses the files OUObox.tex and markmemoOUO.tex.

Example files:

The following files provide a simple example of how to use the class file. You can use them as a template for your own SAND report by editing the text and providing your own content. You will need the file SANDdsitribution.tex which is included by all the example files, as well asSANDExample.bib A simple BibTeX file for use with the examples above.

The text used by the example files is inlcuded from some common files named Common*.tex. They are in the archive. You'll need these if you want to build the example files.

SANDExampleArticleNotstrict.tex The LaTeX example file which uses the class file. This one is based on LaTeX's article class and does not strictly follow the SAND report guidelines. (It looks a little bit more like a LaTeX file than an MS Word file.)

In order to build it, you will also need the jpg versions of the two figures: dragon.jpg and hippogriff.jpg.

Here are three other versions. An article class based example that follows the guidelines pretty strictly: SANDExampleArticlestrict.tex. And two based on the report style. This one is not strict: SANDExampleReportNotstrict.tex. And this one is: SANDExampleReportstrict.tex.

dragon.eps and hippogriff.eps Are two graphic files needed for the example report.

MarkOUO.tex is used by SANDExampleArticlestrict.tex example file to show how markings can be done.

smemo_example.tex is an example of how to use the Sandia memo class.

This Makefile automates the build process.

Typesetting Math in SAND Reports

Philippe Pébay has written a nice collection of symbols and directives to typeset mathematical formulas and proofs in SAND reports. Simply include his package with the following command after the documentclass line:

\input{SANDmath}

The file SANDmath.tex is included in the distribution. This SAND report describes the package and shows what it can do: SAND2004-3894.pdf

Please, contact Philippe directly with questions or suggestions about the SANDmath package: pppebay@ca.sandia.gov.

Typesetting Sandia Memos

All files necessary are listed above and included in the tar ball.

Please, contact Rich Field directly with questions or suggestions about the Sandia Memo package: rvfield@sandia.gov.

Change Log

v1.32 April 30, 2009

  • When strict is used, section refernces do not work, since sections are not numbered. Not sure how to deal with this. For now just print a warning during compile and update the strict examples not to use \ref. (Problem reported by Eric Chu)
  • In article style, the list of figures and tables are now placed directly after the table of contents without starting a new page first. They do start on a new page in report style, since that is meant for longer documents. (Suggested by Tammy Kolda)
  • Tammy reports that R&A sometimes asks for no paragraph indentation in the abstract. In strict mode, this is now the case.
  • R&A also suggests that all paragraphs are indented the same. Until now the first paragraph after a section heading was not indented. The strict option now indents the first paragraph as well. (Suggested by Tammy Kolda)
  • Some people don't like their blank pages to be blank. Added the "blank" option which adds "Page intentionally blank" to blank pages
  • Shared text bewteen examples is now in seperate files and \input into the examples

v1.31 May 22, 2008

  • A template to typeset OUO memos (Rich Field)
  • Per management request, remove all references in the examples to Harry Potter and magic

v1.30 April 23, 2008

  • Change the library distribution yet again (per Monica Price)

v1.29 March 1, 2008

  • Added Rich Field's SAND Memo class.

v1.28 December 13, 2007

  • No change: Org. Number for Central Technical Files is 8944 (confirmed by Beth Watkins)
  • Mark the OUO examples as sample to avoid misunderstandings (Roger Suppona)
  • Paragraph indent is set to 0 for cover pages, but never restored (Daniel Dolan)
  • Use "Lorem ipsum" instead of "bla bla bla" in the examples (Stephanie Phillips) (There is a LaTeX package, lipsum.sty, that does it, but it is not always installed. Therefore, I included the text verbatim, instead of generating it.)
  • If the report is an OUO document, some text on the back cover needs to disappear. Thanks to Marcia Cooper for discovering it, and providing the necessary LaTeX code.
  • A lot of changes from Michael Kaneshige to better match the formatting of the official SAND report template:
    • Removed the odd-even margin asymmetry - made the textwidth 6.5 in and both margins 1 in. This is consistent with the official cover templates, although it's not the standard LaTeX way of formatting double sided documents. If the document gets bound, the LaTeX way is better, but a lot of documents exist only electronically now.
    • Added more space to \topmiddlewidth and subtracted it from \topleftwidth and \toprightwidth so that "official Use Only / Export Controlled Information" would not get broken across lines on the title page.
    • Reduced the \vspace between the title and authors from 0.75in to 0.375in. This is specific to my document, but with everything we were required to add, and a moderate length title, LaTeX was generating a blank first page because the cover page was overfilled.
    • On the back cover, I centered the text block and reduced the minipage width to make it look more like the official covers.
    • The word "NOTICE" on the back cover was significantly larger than the other text, which was not consistent with the official covers. I removed the \fontsize command that was causing this, and it looks more consistent with the official covers.
    • On the title page, the top block (SAND#, OUO/ECI, Printed...) was not centered because there were topleft and topmiddle boxes, but no topright box. I think this was inherited from the report.cls and article.cls classes, but to fix the asymmetry, I inserted a topright box the same as the topleft box. It would seem to work just as well to remove both topleft and topright boxes, since they contain nothing, but to be conservative, I didn't remove anything.
    • Most of MarkOUO.tex has to be edited by the user, but the "Official Use Only" (SANDmarkTopBottom) should be fairly generic. To make it look more like the official covers, I made it bold, 12 pt, all caps. In addition, I reformatted the OUO box from tabular with multicolumn columns, hlines and vertical bars, to a minipage inside a framebox. I think this is smoother.
  • The Technical Library has a new org number again: 4536 > 9536 (Ann Sample via Bill Hart) Also changed NM tech library org to 8944, but I am mostly guessing here... Added (1 electronic and 1 hardcopy) for housekeeping copies and reduce spacing between distribution entries. (Ann Sample via Bill Hart)
  • Central Technical Files doesn't seem to want unclassified reports anymore. (Several)

v1.27 October 3, 2006

  • Forgot to extend the width of external distributions

v1.26 October 3, 2006

  • Some Web page error fixes from Daniel Dunlavy.
  • Mike Eldred suggested to keep internal distributions on a single line.

v1.25 September 19, 2006

  • David Wilson discovered that markings in report style also activated chapter name headings, which are unwanted and sometimes overlap with the markings.

v1.24 August 17, 2006

  • Changed tar file extension from .tgz to .tar.gz Some winzip versions under Windows don't seem to like the former. (Rich Lehoucq)
  • Org. Number for Central Technical Files changed from 8945-1 to 8944 (Tammy and Debbie)

v1.23 June 26, 2006

  • Tammy Kolda found a bug when using amsmath. Seems to have been a problem with white space in the redefinition of \section. LaTeX would stop when building the TOC.

v1.22 June 10, 2006

  • Remove "Unclassified" from "Unclassified Unlimited Release" (Thanks Brett Bader and Mike Heroux)
  • Confirmed that M2497 is correct mail stop for classified reports to Central Technical Files. (Thanks Debbie Johnson)
  • Make the distribution list single column. This makes it easier to print labels. (Thanks Debbie and Estrella)
  • D. Chavez, LDRD Office mail-stop changed from 0188 to 0123. (Thanks Brett Bader)
  • In examples, added \phantomsection and moved \addcontentsline{toc}{section}{References} just before the \bibliography{...} command. This helps putting the right page number into the TOC and also with hyperlinking. (Thanks Tammy Kolda)
  • Clarified usage of \SANDnum{} on Web page. (Thanks Tammy Kolda)
  • More usage and LaTeX tips on Web page. (Thanks Tammy Kolda)

v1.21 March 22, 2006

  • Introduced \SANDrePrintDate and \begin{SANDreDistribution}.
  • Put a page number (2) on the back cover.
  • No institution in \SANDauthor{} in example files.
  • Move the SNL logo on the cover towards the bottom of the page.
  • Add a back cover with the SNL logo at the bottom of the back.
  • Use \cleardouble page and add comment to example files to make sure TOC always starts on an odd page.
  • Don't put title on first page of body text (above introduction) anymore. (Changed from Ver 1.0, Sep. 2002 to Ver 2.0, Dec. 2005 of the guide.)
  • For article, start every section on a new page (report already does this).
  • Fixed URLs for DOE report ordering.
  • \SANDmarkCover now takes only one argument! This makes it easier to draw a box around the statement and configure it as needed. See MarkOUO.tex for an example. Thanks to John Foster for the example.
  • Print small class file version number at bottom of inside back cover
  • Change by Daniel Dolan to make it work and look consistent with the mathptmx package. This leaves the Helvetica fonts on the cover alone, but lets him have the body of the report in Times.
  • From Debbie Johnson (Creative Arts):
    • In example files, use First Name, Middle Initial, Last Name on cover and title page.
    • In example files, on cover, put author names on one line
    • Mail Stop for Central Technical Files is MS9018. (This was an error in the example file, not the class itself.)
    • Back cover was shifted right too far.
    • Move chapter headings up a bit.
    • Use the geometry package to get the margins right.

v1.20 December 21, 2005

  • Updated the distribution list according to version 2.0 of the Guide.

v1.19 December 19, 2005

  • There were still problems with the hyperref package. Fixed it so that the page markings on the back cover are now correct.

v1.18 December 9, 2005

  • Make it work with hyperref again....

v1.17 December 9, 2005

  • Fixed a bug introduced in the last version: The \cleardoublepage is only supposed to happen for chapters in the main body of a report, and it needs to happen before the page number is entered into the TOC.
  • Fixed several new and old bugs that dealt with markings
  • Fixed text on usage page about marking commands.

v1.16 December 5, 2005

  • New org numbers reflect new corporate structure 9616 - > 4536, etc. Thanks to Philip Sackinger for doing this.
  • Philip also found out what the newest distribution rules for NM are.
  • In the example files, deleted a misleading comment about secnumdepth in the appendix. Thanks to John Mitchell for spotting this.
  • Philippe Pébay contributed a new version of SANDmath.tex. (ver. 1.2) Changes include:
    1. add support for discrete intervals
    2. fix some comments
    3. replace incorrect \RequirePackage's by \usepackage's
  • Also from Philippe Pébay: CA distribution list changes.
  • Abstract will start on title page, even with report style. Thanks to Daniel Dolan for noticing it and making suggestions to fix it.
  • Put the title just above the first chapter in the report style.

v1.15 May 20, 2005

  • A small change in the distribution list (D. Chavez in the LDRD office moved)

v1.14 August 18, 2004

  • \begin{SANDdistribution} now takes an optional argument (CA or NM). The respective \documentclass options are no longer valid. Several new commands are available within the SANDdistribution environment to automate distributions for special cases such as CRADA, LDRD, Classified, Patent, etc.
  • The distribution list is now better formatted.
  • Fixed a bug with \SANDreleaseType discovered by Mark Ackermann.
  • Added the command \SANDmarkTop.

v1.13 August 7, 2004

  • Use pdf versions of logos for pdftex. This makes the "jpg" option obsolete. Suggestion and converted logos by Richard Lehoucq.
  • Make SANDreport.cls compatible with the hyperref package.
  • Added SANDmath.tex from Philippe Pébay

v1.12 May 21, 2004

  • Added the options [FIGBOTCAP,normal,bf,tight] to the subfigure package in the example files from a suggestion by Philippe Pébay.
  • Added the CA and NM options to insert the respective standard distributions. Also thanks to Philippe for noticing that they are different in California from the ones used in New Mexico.

v1.11 May 14, 2004

  • Had to comment out a line in fancyhdr.sty for pdflatex to work.

v1.10 February 25, 2004

  • It is now SANDIA REPORT, no longer SAND REPORT. Central Technical Files now wants three copies. See the distribution examples. (Info from Philippe Pébay)
  • Added new commands for markings used in OUO, export controlled, and other reports not labeled "Unlimited Release". Thanks to Mark Ackermann for providing an OUO example.
  • The new commands are \SANDmarkBottomCover{}, \SANDmarkTopBottom{}, \SANDmarkBottom{}, \SANDmarkTopBottomCoverBackTitle{}, \SANDmarkTopBottomCoverTitle{}, \SANDmarkCoverTitle{type}{text}, and \SANDmarkCover{type}{text}. See the Usage page for more details.
  • In report style, the page numbers restarted after the title page. Fixed!
  • Big clean-up.

v1.09 January 19, 2004

  • The distribution list at the end of a SAND report was modifying the description environment which interfered with its regular use. Created a separate environment to fix that.
  • If in "report", list chapters and sections in TOC.
  • Added the jpg option. Using it, includes the jpg versions of the DOE and Sandia logo. This makes it possible to use pdflatex which cannot deal with Postscript logos.

v1.08 November 23, 2003

Optionally use the report class instead of the article class as a basis. Put "report" as an option into \documentclass[report]{SANDreport} to activate it. There were some other fixes and clean-ups as well. Mainly in the table of contents.

  • Changed the ordering URL on page 2.
  • Added fleqn to \LoadClass.
  • Can't get the report title to repeat on the first chapter page. Left it off for now.
  • The table of contents formatting for report class is more or less like report.cls. For article, we try to make it look like the guideline.

v1.07 October 16, 2003

  • Using \ifthenelse in the addcontentsline command interfered with the subfigure class. James Gruetzner and Todd Pitts provided a fix.
  • Philippe Pébay reports that the color package needs to be imported before the graphicx package. This class file uses the graphicx package, so Philippe could not use the color package because graphicx was already loaded when his \usepackage command got executed.

v1.06 February 13, 2003

New DOEbwlogo.eps from Tim Draelos. This one is smaller and has some incompatible junk removed.

v1.05 November 25, 2002

Some changes from Daniel Segalman to conform to the new guide (SAND2002-2068P):

  • Adjust top margin of the title page to conform to the MS Word template (this may or may not be correct depending on your latex/dvips initial setup. Use texconfig to setup paper and dvips).
  • Added the word "Printed" before the date on front page
  • Classification category is no longer needed on page 3; get rid of \SANDdistcategory
  • Added "National Nuclear Security Administration" on title page
  • Changed NTIS URL on page 2

If "strict" is not used, we'll number sections to two decimal places (1.2.3)

v1.04 August 7, 2002

  • Added a Makefile based on one Mike Heroux provided
  • Allow for distribution lists that span more than one page and typeset the distribution in two columns

v1.03 June 19, 2002

Set tocdepth to 2 to only list sections and subsections in TOC.

v1.02 June 17, 2002

Use \raggedright for main title

v1.01 June 14, 2002

Make distribution list wider. Spaces between area codes and phone numbers.

v1.00 June 14, 2002

First Version.

Top of page

Image placeholder


Contact
SAND Report
Rolf Riesen
(rolf@sandia.gov)
(505)845-7363

SAND Math
Philippe Pébay
(pppebay@ca.sandia.gov)
(925)294-2024

SAND Memo
Rich Field
(rvfield@sandia.gov)
(505)284-4060


Related Links
SAND Report Guide