|
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.
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.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:
- add support for discrete intervals
- fix some comments
- 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
|
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
|