Research Association of Statistical Sciences(Bulletin of Informatics and Cybernetics)

How to use BIC article classfile and remarks
Masao Mori (28th Sep 2000)

Abstract:
This document provides the usage of BIC article class file (bic-art.cls version 0.5a) for authors to write articles for Bulletin of Informatics and Cybernetics. LATEX 2e is required. LATEX 2.09 is not supported, however, most of features provided in bic-art.sty are retained.

Contents

Introduction

The class file bic-art.cls is a LATEX 2e document class file to write articles for Bulletin of Informatics and Cybernetics (BIC, for short). Authors are supposed to submit articles for BIC in form of LATEX source. Note that bic-art.cls requires not LATEX 2.09 but LATEX 2e. For LATEX 2.09 users should utilize old version bic-art.sty, however, LATEX 2e is highly recommended. We suppose that LATEX 2e is installed in TeX Directory Standard (TDS, for short) and denote $texmf for the top directory of TDS.

Getting the class file

The BIC article class file can be obtained from

Put the class file bic-art.cls in the working directory, or $texmf/tex/latex/base. Windows users should note that folders below the My document folder is not recommended for the working directory. LATEX 2e may not find the class file.

Features

Features of bic-art.cls are introduced. Most of them are retained from the old version bic-art.sty. New and modified features are marked with and , respectively, stable features are not marked.

Preamble

A LATEX source file begins with \documentclass[]{} command. For bic-art.cls we start a file as the following. With an option reprint the cover page for reprint would be output. The class file fixes charactor size at 10 points and b5 paper size for the purpose of checking the accurate pages of an article. So that if another option such as b4paper or 12pt are specified, LATEX 2e would warn and not output dvi files. To use package the \usepackage[]{} command should be declared. Specially if authors need to include graphics(EPS etc), the graphicx package would be convinient. See [Goossens,M., Mittelbach,F. and Samarin, A.].

\documentclass{bic-art}

or

\documentclass[reprint]{bic-art}
\usepackage[dvips,xdvi]{graphicx}

The DVI file would have twoside pages and be formed in b5 paper. Another Paper sizes are not supported. Use dvips command with appropriate options to convert DVI files to ps files. We remark that the old version bic-art.sty can be used in LATEX 2e. But some troubles are reported.

In preamble BIC articles requires particularly the following commands, \bictitle{}, \bicvol{}, bicno{}, \bicyear{} and \bic*author command family.

  • \bictitle{arg} takes one argument arg which is the title of the article changed into upper case charactors. With reprint option in \documentclass command the arg would be also used for the title in the cover page.
  • \bicvol{arg}(optional), \bicno{arg}(optional) and \bicyear{arg}(optional) commands set parameters volume, number and the published year of BIC, respectively. Each of them takes one argument. If not declared the default value '00' would be set.

The class file bic-art.cls provide \bic*author command family as follows. All of command is used for authors' name in cover page, title page and headers. Family names would be shown in SMALL CAPS font and first names would be shorten in headers.

  • \bicauthor[thanks]{firstname}{familyname} take thanks option to describe institutes, contact address etc. Do not use \thanks command, use this option.
  • \bicfirstauthor[thanks]{firstname}{familyname} would be used to describe the first author of the article in case that there are more than two authors. The commands \bicsecondauthor[]{}{} \bicfifithauthor[]{}{} are provided for the rest of authors. In case of more than six authors, please get in touch with editor. Remark that for the thanks option there is a restriction of LATEX that some LATEX command are not effective.

[Note] The settings in preamble have an effect to the document only if the \maketitle command is called in the document environment.

Start document

For the inside of document environment, \bickeyword{} command, custmized abstract environment and customized theorem environment family are provided.

  • \bickeyword{keywords}(optional) command outputs keywords and phrases in the abstract which are specified in the argument keywords. Note that this command should be declared before abstract environment in the following.
  • abstract environment is a customized abstract environment which shows keywords and phrases only if \bickeyword{} command is declared in advance.

Theorem environment family consists of theorem, proposition, lemma, collorary, definition, axiom and note. Theorem number are unified for each section except proof and remark which have no numbers. It is possible to define new environment with \definethm command.

  • \definethm[numbering]{name}{headline} requires three arguments. The argument name is the environment name and headline would be output for the headline of this environment. The headline is in SMALL CAPS font and the content is in Roman font. Theorem-numbering follows the option numbering. See LATEX reference ([Lamport,L.]) for \newtheorem command about theorem-numbering. The default of option numbering does not output its theorem-number as proof and note environments.

[Note] In case that the statement begins parenthesis in a theorem environment, theorem labels may be in bold font. To avoid this, those words with parenthesis should be enclosed by bracket {}. For instance,

\begin{theorem} (Gauss)  % label is in bold font.
% should be
\begin{theorem} {(Gauss)}

Next version of class file will resolve the bug.

For acknowledgement acknowledgement environment is provided.

  • acknowledgement environment shows its centered headline and the acknowledgement in Roman font without indention.

Author may use a square box to show the end of proofs, theorems and statements. Currently \Box command is obsolete in LATEX 2e, however, bic-art.cls provide a substitute command \qed for square boxes.

  • \qed outputs a square box which can be used in both text mode and math mode.

Reference section

For the reference section a modified thebibliography environment is provided with modified commands \bibitem[]{}{} and \cite{}. Generally speaking it is necessary to compile LATEX 2e source file more than twice to output reference section successfully. See [Lamport,L.] for more detail.

  • \bibitem[citation]{author}{year} takes three arguments. Note that citation is not option but used in \cite{} command so that it is required to specify for citation. citestring is shown as an author name for reference in the document. It would be efficient if there are plural authors. For instance,
    \begin{thebibliography}{99}
    \bibitem[Knuth]{Knuth,D.}{1970}{Knuth}
      \textit{The \TeX book}, ASCII corporation, Japanese.
    \bibitem[GMS]{Goossens,M., Mittelbach,F. and Samarin,A.}{1994}{Goossens et al.}
      \textit{The \LaTeX companion}, Addison Wesley, Japanese.  
    \end{thebibliography}
    If we cite \cite{Knuth} and \cite{GMS} then output would be [Knuth,D.] and [Goossens,M., Mittelbach,F. and Samarin, A.].
  • \cite{citation} command outputs a citation in the form author(year) and list it up in the reference section.

Remarks

Some remarks are noted for editing and printing out. We suppose that LATEX 2e is installed in TeX Directory Standard (TDS, for short). We note $texmf for the top directory of TDS.

Folders and directories

The class file bic-art.cls should be put in the working directory or any directories directly under $texmf/tex/latex/. Windows users should note that the folders below My document is not recommended for the working directory. LATEX 2e may not find the class file.

Including graphics

It is possible to include graphics into articles. It is recommended for authors to may make use of graphics package ([Carlisle,D.P. and Rahtz,S.P.Q.]) bundled into LATEX 2e. To do this it is necessary to call it with the \usepackage command.

\usapackage[dvips,xdvi]{graphicx}

There are two kind of style files in graphics package. See the enclosed document in [Carlisle,D.P. and Rahtz,S.P.Q.]. For instance, an Encapsled PostScript graphic file fig-1.eps can be included by the command:

\usepackage[dvips,xdvi]{graphicx}   % In preamble
.....
\begin{center}
  \includegraphics[scale=0.5]{fig-1.eps}
  \label{fig:1}
\end{center}

Another graphics format can be used with this package, however, it is necessary to prepare drivers to deal with them.

Converting to PostScript file with dvipsk

Currently dvips(version 5.78 p1.4c) does not support paper size b5. The config file $texmf/dvips/config.ps might be modified.

@ B5 182mm 257mm
@+ ! %%DocumentPaperSizes: B5
@+ %%BeginPaperSize: B5
@+ b5
@+ %%EndPaperSize

@ B4 257mm 364mm
@+ ! %%DocumentPaperSizes: B4
@+ %%BeginPaperSize: B4
@+ b4
@+ %%EndPaperSize

Add the above lines to the end of $texmf/dvips/config.ps file. If authors are familiar with UNIX version of dvips, conversion would be done by the following command.

$ dvips -o output.ps -t b5 file.dvi
$ gs output.ps

The command gs (GhostScript) shows the converted PostScript documents.

Acknowledgement

Prof. Yanagawa, Editor-In-Chief of BIC, had been patient and encouraged me for the BIC class file for LATEX 2e. I would like to thank Prof. Yanagawa.

Bibliography

  1. Lamport,L. LATEX: A Document Preparation System, 2nd edition, Pearson Education Japan, 1994.
  2. Knuth,D. The TEX book, ASCII corporation, Japanese, 1970.
  3. Goossens,M., Mittelbach,F. and Samarin, A. The LATEX companion, Addison Wesley, Japanese, 1994.
  4. Carlisle,D.P. and Rahtz,S.P.Q. The graphics package, LATEX2e standard bundle package, 1997.

Last-modified: 2008-09-02 (火) 16:01:58 (3364d)