From 2c04063b3d9996634b93b35dc89827eb103370d7 Mon Sep 17 00:00:00 2001 From: Arnaud Giersch Date: Mon, 20 Oct 2014 17:47:16 +0200 Subject: [PATCH 1/1] Initial commit. --- Heter_paper.tex | 733 +++++ IEEEabrv.bib | 447 +++ IEEEtran.bst | 2417 +++++++++++++++ IEEEtran.cls | 4733 ++++++++++++++++++++++++++++++ IEEEtran/.gitignore | 12 + IEEEtran/IEEEabrv.bib | 447 +++ IEEEtran/IEEEexample.bib | 1190 ++++++++ IEEEtran/IEEEfull.bib | 419 +++ IEEEtran/IEEEtran.bst | 2417 +++++++++++++++ IEEEtran/IEEEtran.cls | 4733 ++++++++++++++++++++++++++++++ IEEEtran/IEEEtranS.bst | 2607 ++++++++++++++++ IEEEtran/IEEEtran_HOWTO.pdf | Bin 0 -> 705216 bytes IEEEtran/IEEEtran_bst_HOWTO.pdf | Bin 0 -> 305669 bytes IEEEtran/README | 144 + IEEEtran/bare_adv.tex | 1100 +++++++ IEEEtran/bare_conf.tex | 601 ++++ IEEEtran/bare_jrnl.tex | 745 +++++ IEEEtran/bare_jrnl_compsoc.tex | 844 ++++++ IEEEtran/changelog.txt | 762 +++++ fig/avg_eq-eps-converted-to.pdf | Bin 0 -> 7636 bytes fig/avg_eq.eps | 756 +++++ fig/avg_neq-eps-converted-to.pdf | Bin 0 -> 7646 bytes fig/avg_neq.eps | 764 +++++ fig/commtasks.pdf | Bin 0 -> 12818 bytes fig/heter-eps-converted-to.pdf | Bin 0 -> 6697 bytes fig/heter.eps | 635 ++++ fig/homo-eps-converted-to.pdf | Bin 0 -> 6975 bytes fig/homo.eps | 690 +++++ fig/sen_comp.pdf | Bin 0 -> 17617 bytes fig/start_freq.pdf | Bin 0 -> 21938 bytes fig/three_scenarios.pdf | Bin 0 -> 13550 bytes my_reference.bib | 671 +++++ 32 files changed, 27867 insertions(+) create mode 100644 Heter_paper.tex create mode 100644 IEEEabrv.bib create mode 100644 IEEEtran.bst create mode 100644 IEEEtran.cls create mode 100644 IEEEtran/.gitignore create mode 100644 IEEEtran/IEEEabrv.bib create mode 100644 IEEEtran/IEEEexample.bib create mode 100644 IEEEtran/IEEEfull.bib create mode 100644 IEEEtran/IEEEtran.bst create mode 100644 IEEEtran/IEEEtran.cls create mode 100644 IEEEtran/IEEEtranS.bst create mode 100644 IEEEtran/IEEEtran_HOWTO.pdf create mode 100644 IEEEtran/IEEEtran_bst_HOWTO.pdf create mode 100644 IEEEtran/README create mode 100644 IEEEtran/bare_adv.tex create mode 100644 IEEEtran/bare_conf.tex create mode 100644 IEEEtran/bare_jrnl.tex create mode 100644 IEEEtran/bare_jrnl_compsoc.tex create mode 100644 IEEEtran/changelog.txt create mode 100644 fig/avg_eq-eps-converted-to.pdf create mode 100644 fig/avg_eq.eps create mode 100644 fig/avg_neq-eps-converted-to.pdf create mode 100644 fig/avg_neq.eps create mode 100644 fig/commtasks.pdf create mode 100644 fig/heter-eps-converted-to.pdf create mode 100644 fig/heter.eps create mode 100644 fig/homo-eps-converted-to.pdf create mode 100755 fig/homo.eps create mode 100644 fig/sen_comp.pdf create mode 100644 fig/start_freq.pdf create mode 100644 fig/three_scenarios.pdf create mode 100644 my_reference.bib diff --git a/Heter_paper.tex b/Heter_paper.tex new file mode 100644 index 0000000..3b2b238 --- /dev/null +++ b/Heter_paper.tex @@ -0,0 +1,733 @@ +\documentclass[conference]{IEEEtran} + +\usepackage[T1]{fontenc} +\usepackage[utf8]{inputenc} +\usepackage[english]{babel} +\usepackage{algpseudocode} +\usepackage{graphicx} +\usepackage{subfig} +\usepackage{amsmath} + +\usepackage{url} +\DeclareUrlCommand\email{\urlstyle{same}} + +\usepackage[autolanguage,np]{numprint} +\AtBeginDocument{% + \renewcommand*\npunitcommand[1]{\text{#1}} + \npthousandthpartsep{}} + +\usepackage{xspace} +\usepackage[textsize=footnotesize]{todonotes} +\newcommand{\AG}[2][inline]{% + \todo[color=green!50,#1]{\sffamily\textbf{AG:} #2}\xspace} +\newcommand{\JC}[2][inline]{% + \todo[color=red!10,#1]{\sffamily\textbf{JC:} #2}\xspace} + +\newcommand{\Xsub}[2]{\ensuremath{#1_\textit{#2}}} + +\newcommand{\Dist}{\textit{Dist}} +\newcommand{\Eind}{\Xsub{E}{ind}} +\newcommand{\Enorm}{\Xsub{E}{Norm}} +\newcommand{\Eoriginal}{\Xsub{E}{Original}} +\newcommand{\Ereduced}{\Xsub{E}{Reduced}} +\newcommand{\Fdiff}{\Xsub{F}{diff}} +\newcommand{\Fmax}{\Xsub{F}{max}} +\newcommand{\Fnew}{\Xsub{F}{new}} +\newcommand{\Ileak}{\Xsub{I}{leak}} +\newcommand{\Kdesign}{\Xsub{K}{design}} +\newcommand{\MaxDist}{\textit{Max Dist}} +\newcommand{\Ntrans}{\Xsub{N}{trans}} +\newcommand{\Pdyn}{\Xsub{P}{dyn}} +\newcommand{\PnormInv}{\Xsub{P}{NormInv}} +\newcommand{\Pnorm}{\Xsub{P}{Norm}} +\newcommand{\Tnorm}{\Xsub{T}{Norm}} +\newcommand{\Pstates}{\Xsub{P}{states}} +\newcommand{\Pstatic}{\Xsub{P}{static}} +\newcommand{\Sopt}{\Xsub{S}{opt}} +\newcommand{\Tcomp}{\Xsub{T}{comp}} +\newcommand{\TmaxCommOld}{\Xsub{T}{Max Comm Old}} +\newcommand{\TmaxCompOld}{\Xsub{T}{Max Comp Old}} +\newcommand{\Tmax}{\Xsub{T}{max}} +\newcommand{\Tnew}{\Xsub{T}{New}} +\newcommand{\Told}{\Xsub{T}{Old}} + +\begin{document} + +\title{Energy Consumption Reduction in heterogeneous architecture using DVFS} + +\author{% + \IEEEauthorblockN{% + Jean-Claude Charr, + Raphaël Couturier, + Ahmed Fanfakh and + Arnaud Giersch + } + \IEEEauthorblockA{% + FEMTO-ST Institute\\ + University of Franche-Comté\\ + IUT de Belfort-Montbéliard, + 19 avenue du Maréchal Juin, BP 527, 90016 Belfort cedex, France\\ + % Telephone: \mbox{+33 3 84 58 77 86}, % Raphaël + % Fax: \mbox{+33 3 84 58 77 81}\\ % Dept Info + Email: \email{{jean-claude.charr,raphael.couturier,ahmed.fanfakh_badri_muslim,arnaud.giersch}@univ-fcomte.fr} + } + } + +\maketitle + +\begin{abstract} + +\end{abstract} + +\section{Introduction} +\label{sec.intro} + + +\section{Related works} +\label{sec.relwork} + + + + + +\section{The performance and energy consumption measurements on heterogeneous architecture} +\label{sec.exe} + +% \JC{The whole subsection ``Parallel Tasks Execution on Homogeneous Platform'', +% can be deleted if we need space, we can just say we are interested in this +% paper in homogeneous clusters} + +\subsection{The performance of parallel tasks on heterogeneous cluster} + +The heterogeneous cluster is a collection of non identical computing nodes. Each node in +a cluster is connected via a high speed network. The communication capabilities between nodes +are identical or different. In this work we are interested in identical communications. While each +node has different processing capabilities such as CPU speeds and memory. Tasks executed +on this model can be either synchronous or asynchronous. In this paper we are consider execution of +the synchronous tasks on distributed heterogeneous platform. These tasks can exchange +the data via synchronous message passing. + +\begin{figure}[t] + \centering + \includegraphics[scale=0.6]{fig/commtasks} + \caption{Parallel tasks on heterogeneous platform} + \label{fig:heter} +\end{figure} + + Therefore, the execution time of a task consists of the computation time and + the communication time. Due to heterogeneous computations can lead to slack times while the tasks + wait at the synchronization barrier for other tasks to finish their jobs (see Figure~(\ref{fig:heter})). + In this case the fastest tasks have to wait at the synchronization barrier for the slowest ones to begin + the next task. Therefore, the overall execution time of the program is the execution time of the slowest + task as in EQ~(\ref{eq:T1}). +\begin{equation} + \label{eq:T1} + \textit{Program Time} = \max_{i=1,2,\dots,N} T_i +\end{equation} + where $T_i$ is the execution time of the task $i$ and all the tasks are executed concurrently on different processors. DVFS is a process that is allowed in modern processors to reduce the dynamic +power by scaling down the voltage and frequency. Then any DVFS operation used to reduce energy of the processor has direct affect on the execution time of the MPI program. The reduction process of the frequency can be expressed by the scaling factor S which is the ratio between the maximum and the new frequency as in EQ (\ref{eq:s}). +\begin{equation} + \label{eq:s} + S = \frac{F_\textit{max}}{F_\textit{new}} +\end{equation} + The execution time of a parallel program is linearly proportional to the frequency scaling factor $S$. + However, in most MPI applications the processes exchange data. During these communications the + processors involved remain idle until the communications are finished. For that reason, any change in + the frequency has no impact on the time of communication~\cite{17}. The communication time for a task is the summation of periods + of time that begin with an MPI call for sending or receiving a message till the message is synchronously sent or received. + Each node has different DVFS features such as frequency values and the number of available frequencies + (Pstates) for each node. By contrast there are different frequency scaling factors for each node $S_1, S_2,..., S_N$. To be able to predict the execution time of MPI program, the communication time and the computation time for the slowest + task must be measured before scaling. These times are used to predict the execution time for any MPI program running on heterogeneous cluster as a function + of the new scaling factors as in EQ (\ref{eq:perf}). The model is computes the maximum production of computation time + with scaling factor from each node added to the minimum communication time of the slowest node, it means only the + communication time without slack times, because in MPI the slack times is measured with communication times. +\begin{multline} + \label{eq:perf} + \textit T_\textit{new} = \\ + {} \max_{i=1,2,\dots,N} (TcpOld_{i} \cdot S_{i}) + + \min_{i=1,2,\dots,N} Tcm Old_{i} +\end{multline} +This prediction modal is developed from our model for predicting the execution time of parallel task on homogeneous architecture~\cite{45}. The execution time predicting model is useful to used in our method for optimizing both energy and performance of iterative methods as in the coming sections. + + +\subsection{Energy model for heterogeneous platform} + +Many researchers~\cite{9,3,15,26} divide the power consumed by a processor into +two power metrics: the static and the dynamic power. While the first one is +consumed as long as the computing unit is on, the latter is only consumed during +computation times. The dynamic power $P_{d}$ is related to the switching +activity $\alpha$, load capacitance $C_L$, the supply voltage $V$ and +operational frequency $F$, as shown in EQ(\ref{eq:pd}). +\begin{equation} + \label{eq:pd} + P_\textit{d} = \alpha \cdot C_L \cdot V^2 \cdot F +\end{equation} +The static power $P_{s}$ captures the leakage power as follows: +\begin{equation} + \label{eq:ps} + P_\textit{s} = V \cdot N_{trans} \cdot K_{design} \cdot I_{leak} +\end{equation} +where V is the supply voltage, $N_{trans}$ is the number of transistors, +$K_{design}$ is a design dependent parameter and $I_{leak}$ is a +technology-dependent parameter. The energy consumed by an individual processor +to execute a given program can be computed as: +\begin{equation} + \label{eq:eind} + E_\textit{ind} = P_\textit{d} \cdot T_{cp} + P_\textit{s} \cdot T +\end{equation} +where $T$ is the execution time of the program, $T_{cp}$ is the computation +time and $T_{cp} \leq T$. $T_{cp}$ may be equal to $T$ if there is no +communication, no slack time and no synchronization. + +The main objective of DVFS operation is to +reduce the overall energy consumption~\cite{37}. The operational frequency $F$ +depends linearly on the supply voltage $V$, i.e., $V = \beta \cdot F$ with some +constant $\beta$. This equation is used to study the change of the dynamic +voltage with respect to various frequency values in~\cite{3}. The reduction +process of the frequency can be expressed by the scaling factor $S$ which is the +ratio between the maximum and the new frequency as in EQ~(\ref{eq:s}). +The value of the scaling factor $S$ is greater than 1 when changing the +frequency of the CPU to any new frequency value~(\emph{P-state}) in the +governor. The CPU governor is an interface driver supplied by the operating +system's kernel to lower a core's frequency. we can calculate the new frequency +$F_{new}$ from EQ(\ref{eq:s}) as follow: +\begin{equation} + \label{eq:fnew} + F_\textit{new} = S^{-1} . F_\textit{max} +\end{equation} +By substituting this equation in EQ(\ref{eq:pd}) results the following equation for dynamic +power consumption: +\begin{multline} + \label{eq:pdnew} + {P}_\textit{d} = \alpha \cdot C_L \cdot V^2 \cdot F_{new} = \alpha \cdot C_L \cdot \beta^2 \cdot F_{new}^3 \\ + = \alpha \cdot C_L \cdot V^2 \cdot F \cdot S^{-3} = P_{d} \cdot S^{-3} +\end{multline} +According to EQ(\ref{eq:pdnew}) the dynamic power is reduce by a factor of $S^{-3}$ when +reducing the frequency by a factor of $S$~\cite{3}. The dynamic energy is the energy consumed by a CPU when its in the computation mode. +So, the dynamic energy is the dynamic power multiply by the time of computations. While the time of computation is decreased by a factor of $S$. Therefore the +the dynamic energy is decreased by a factor of $S^{-2}$ as follow: +\begin{equation} + \label{eq:Edyn} + E_\textit{d} = P_{d} \cdot S^{-3} \cdot (Tcp \cdot S)= S^{-2}\cdot P_{d} \cdot Tcp +\end{equation} +The static power is related to leakage power consumption, its mean the CPU continue consumes energy +whereas in idle state. Therefore, we are make an assumption that the static power is constant as in~\cite{3,46}. +The static energy is the static power multiply by the execution time of the program. Moreover, the CPU consumes static +energy in all times of the program such as computation, communication and slacks times. According to the execution time model in EQ(\ref{eq:perf}), +the execution time of the program is the summation of the computation and the communication times. The computation time is related +to frequency scaling factor linearly, while this scaling factor not affecting on the time of communication~\cite{17}, then the static energy +of individual processor is as follow: + +\begin{equation} + \label{eq:Estatic} + E_\textit{s} = P_\textit{s} \cdot (Tcp \cdot S + Tcm) +\end{equation} +In heterogeneous architecture there is a number of different processors $P_1, P_2,...,P_N$, where $N$ is the number of nodes . Moreover, each processor perhaps has different frequency scaling factor, so there are a set of frequency scaling factors for such platform $S_1,S_2,...,S_N$. According to these different +scaling factors producing different computation time, $Tcp_1,Tcp_2,...,Tcp_N$, because these times linearly related to these scaling factors. In MPI program the communication times is measured with slacks times. The slack times also has linear relation with the scaling factors. So, there are different mesured communication times $Tcm_1,Tcm_2,...,Tcm_N$ even if its identical communications, e.g. see figure(\ref{fig:heter}). The energy modal of an heterogeneous architecture represents the summation of all dynamic and static energies from each processors, each processor has its dynamic and static powers, for example, in the hole architecture their are: $Pd_1,Pd_2,...,Pd_N$ and $Ps_1,Ps_2,...,Ps_N$. The dynamic energy is computes as in EQ(\ref{eq:Edyn}) with regarding to the frequency scaling factor and the dynamic power of each node. While the static energy is computes using EQ(\ref{eq:perf}) multiplied by the static power of each processor. So, the energy modal of an heterogeneous platform has the following form: +\begin{multline} + \label{eq:energy} + E = \sum_{i=1}^{N} {(S_i^{-2} \cdot Pd_i \cdot Tcp_i)} +\\ + {}\sum_{i=1}^{N} {(Ps_i \cdot (\max_{i=1,2,\dots,N} (Tcp_{i} \cdot S_{i}) +} + {}\min_{i=1,2,\dots,N} {Tcm_{i}))} + \end{multline} + +These set of frequency scaling factors $S_i$ reduce quadratically the dynamic power which may cause degradation in performance and thus, the +increase of the static energy because the execution time is increased~\cite{36}. + +\section{Optimization of both energy consumption and performance} +\label{sec.compet} +Applying DVFS to lower level not surly reducing the energy consumption to minimum level. Also, a big scaling for the frequency produces high performance degradation percent. Moreover, by considering the drastically increase in execution time of parallel program, the static energy is related to this time +and it also increased by the same ratio. Thus, the opportunity for gaining more energy reduction is restricted. For that choosing frequency scaling factors is very important process to taking into account both energy and performance. In our previous work~\cite{45}, we are proposed a method that selects the optimal frequency scaling factor for an homogeneous cluster, depending on the trade-off relation between the energy and performance. In this work we have an heterogeneous cluster, at each node there is different scaling factors, so our goal is to selects the optimal set of frequency scaling factors, $Sopt_1,Sopt_2,...,Sopt_N$, that gives the best trade-off between energy consumption and performance. The relation between the energy and the execution time is complex and nonlinear, Thus, unlike the relation between the performance and the scaling factor, the relation of the energy with the frequency scaling factors is nonlinear, for more details refer to~\cite{17}. Moreover, they are not measured using the same metric. To solve this problem, we normalize the execution time by calculating the ratio between the new execution time (the scaled execution time) and the old one as follow: +\begin{multline} + \label{eq:pnorm} + P_\textit{Norm} = \frac{T_\textit{New}}{T_\textit{Old}}\\ + = \frac{ \max_{i=1,2,\dots,N} (Tcp_{i} \cdot S_{i}) +\min_{i=1,2,\dots,N} {Tcm_{i}}} + {\max_{i=1,2,\dots,N}{(Tcp_i+Tcm_i)}} +\end{multline} + + +By the same way, we are normalize the energy by calculating the ratio between the consumed energy with scaled frequency and the consumed energy without scaled frequency: +\begin{multline} + \label{eq:enorm} + E_\textit{Norm} = \frac{E_\textit{Reduced}}{E_\textit{Original}} \\ + = \frac{ \sum_{i=1}^{N}{(S_i^{-2} \cdot Pd_i \cdot Tcp_i)} + + \sum_{i=1}^{N} {(Ps_i \cdot T_{New})}}{\sum_{i=1}^{N}{( Pd_i \cdot Tcp_i)} + + \sum_{i=1}^{N} {(Ps_i \cdot T_{Old})}} +\end{multline} +Where $T_{New}$ and $T_{Old}$ is computed as in EQ(\ref{eq:pnorm}). The second problem +is that the optimization operation for both energy and performance is not in the same direction. +In other words, the normalized energy and the normalized execution time curves are not at the same direction. +While the main goal is to optimize the energy and execution time in the same time. According to the +equations~(\ref{eq:enorm}) and~(\ref{eq:pnorm}), the set of frequency scaling factors $S_1,S_2,...,S_N$ reduce both the energy and the +execution time simultaneously. But the main objective is to produce maximum energy +reduction with minimum execution time reduction. Many researchers used different +strategies to solve this nonlinear problem for example see~\cite{19,42}, their +methods add big overheads to the algorithm to select the suitable frequency. +In this paper we are present a method to find the optimal set of frequency scaling factors to optimize both energy and execution time simultaneously +without adding a big overhead. Our solution for this problem is to make the optimization process +for energy and execution time follow the same direction. Therefore, we inverse the equation of the normalized +execution time, the normalized performance, as follows: + +\begin{multline} + \label{eq:pnorm_inv} + P_\textit{Norm} = \frac{T_\textit{Old}}{T_\textit{New}}\\ + = \frac{\max_{i=1,2,\dots,N}{(Tcp_i+Tcm_i)}} + { \max_{i=1,2,\dots,N} (Tcp_{i} \cdot S_{i}) +\min_{i=1,2,\dots,N} {Tcm_{i}}} +\end{multline} + + +\begin{figure} + \centering + \subfloat[Homogeneous platform]{% + \includegraphics[width=.22\textwidth]{fig/homo.eps}\label{fig:r1}}% + \qquad% + \subfloat[Heterogeneous platform]{% + \includegraphics[width=.22\textwidth]{fig/heter.eps}\label{fig:r2}} + \label{fig:rel} + \caption{The energy and performance relation} +\end{figure} + +Then, we can model our objective function as finding the maximum distance +between the energy curve EQ~(\ref{eq:enorm}) and the performance +curve EQ~(\ref{eq:pnorm_inv}) over all available sets of scaling factors. This +represents the minimum energy consumption with minimum execution time (better +performance) at the same time, see figure~(\ref{fig:r1}) or figure~(\ref{fig:r2}) . Then our objective +function has the following form: +\begin{multline} + \label{eq:max} + Max Dist = + \max_{i=1,\dots F, j=1,\dots,N} + (\overbrace{P_\textit{Norm}(S_{ij})}^{\text{Maximize}} - + \overbrace{E_\textit{Norm}(S_{ij})}^{\text{Minimize}} ) +\end{multline} +where $N$ is the number of nodes and $F$ is the number of available frequencies for each nodes. +Then we can select the optimal set of scaling factors that satisfies EQ~(\ref{eq:max}). Our objective function can +work with any energy model or energy values stored in a data file. +Moreover, this function works in optimal way when the energy curve has a convex +form over the available frequency scaling factors as shown in~\cite{15,3,19}. + +\section{The heterogeneous scaling algorithm } +\label{sec.optim} +In this section we proposed an heterogeneous scaling algorithm, (figure~\ref{HSA}), that selects the optimal set of scaling factors from each node. +The algorithm is numerates the suitable range of available scaling factors for each node in the heterogeneous cluster, returns a set of optimal frequency scaling factors for each node. Using heterogeneous cluster is produces different workloads for each node. Therefore, the fastest nodes waiting at the barrier for the slowest nodes to finish there work as in figure (\ref{fig:heter}). Our algorithm takes into account these imbalanced workloads when is starts to search for selecting the best scaling factors. So, the algorithm is selecting the initial frequencies values for each node proportional to the times of computations that gathered from the first iteration. As an example in figure (\ref{fig:st_freq}), the algorithm don't test the first frequencies of the fastest nodes until it converge their frequencies to the frequency of the slowest node. If the algorithm is starts test changing the frequency of the slowest nodes from beginning, we are loosing performance and then not selecting the best tradeoff (the distance). This case will be similar to the homogeneous cluster when all nodes scales their frequencies together from the beginning. In this case there is a small distance between energy and performance curves, for example see the figure(\ref{fig:r1}). Then the algorithm searching for optimal frequency scaling factor from the selected frequencies until the last available ones. +\begin{figure}[t] + \centering + \includegraphics[scale=0.5]{fig/start_freq.pdf} + \caption{Selecting the initial frequencies} + \label{fig:st_freq} +\end{figure} + + +To compute the initial frequencies, the algorithm firstly needs to compute the computation scaling factors $Scp_i$ for each node. Each one of these factors represent a ratio between the computation time of the slowest node and the computation time of the node $i$ as follow: +\begin{equation} + \label{eq:Scp} + Scp_{i} = \frac{\max_{i=1,2,\dots,N}(Tcp_i)}{Tcp_i} +\end{equation} +Depending on the initial computation scaling factors EQ(\ref{eq:Scp}), the algorithm computes the initial frequencies for all nodes as a ratio between the +maximum frequency of node $i$ and the computation scaling factor $Scp_i$ as follow: +\begin{equation} + \label{eq:Fint} + F_{i} = \frac{Fmax_i}{Scp_i},~{i=1,2,\cdots,N} +\end{equation} +\begin{figure}[tp] + \begin{algorithmic}[1] + % \footnotesize + \Require ~ + \begin{description} + \item[$Tcp_i$] array of all computation times for all nodes during one iteration and with highest frequency. + \item[$Tcm_i$] array of all communication times for all nodes during one iteration and with highest frequency. + \item[$Fmax_i$] array of the maximum frequencies for all nodes. + \item[$Pd_i$] array of the dynamic powers for all nodes. + \item[$Ps_i$] array of the static powers for all nodes. + \item[$Fdiff_i$] array of the difference between two successive frequencies for all nodes. + \end{description} + \Ensure $Sopt_1, \dots ,Sopt_N$ is a set of optimal scaling factors + + \State $ Scp_i \gets \frac{\max_{i=1,2,\dots,N}(Tcp_i)}{Tcp_i} $ + \State $F_{i} \gets \frac{Fmax_i}{Scp_i},~{i=1,2,\cdots,N}$ + \State Round the computed initial frequencies $F_i$ to the closest one available in each node. + \If{(not the first frequency)} + \State $F_i \gets F_i+Fdiff_i,~i=1,...,N.$ + \EndIf + \State $T_\textit{Old} \gets max_{~i=1,...,N } (Tcp_i+Tcm_i)$ + \State $E_\textit{Original} \gets \sum_{i=1}^{N}{( Pd_i \cdot Tcp_i)} +\sum_{i=1}^{N} {(Ps_i \cdot T_{Old})}$ + \State $Dist \gets 0$ + \State $Sopt_{i} \gets 1,~i=1,...,N. $ + \While {(all nodes not reach their minimum frequency)} + \If{(not the last freq. \textbf{and} not the slowest node)} + \State $F_i \gets F_i - Fdiff_i,~i=1,...,N.$ + \State $S_i \gets \frac{Fmax_i}{F_i},~i=1,...,N.$ + \EndIf + \State $T_{New} \gets max_\textit{~i=1,\dots,N} (Tcp_{i} \cdot S_{i}) + min_\textit{~i=1,\dots,N}(Tcm_i) $ + \State $E_\textit{Reduced} \gets \sum_{i=1}^{N}{(S_i^{-2} \cdot Pd_i \cdot Tcp_i)} + $ \hspace*{43 mm} + $\sum_{i=1}^{N} {(Ps_i \cdot T_{New})} $ + \State $ P_\textit{Norm} \gets \frac{T_\textit{Old}}{T_\textit{New}}$ + \State $E_\textit{Norm}\gets \frac{E_\textit{Reduced}}{E_\textit{Original}}$ + \If{$(\Pnorm - \Enorm > \Dist)$} + \State $Sopt_{i} \gets S_{i},~i=1,...,N. $ + \State $\Dist \gets \Pnorm - \Enorm$ + \EndIf + \EndWhile + \State Return $Sopt_1,Sopt_2, \dots ,Sopt_N$ + \end{algorithmic} + \caption{Heterogeneous scaling algorithm} + \label{HSA} +\end{figure} +When the initial frequencies are computed the algorithm numerates all available scaling factors starting from these frequencies until all nodes reach their +minimum frequencies. At each iteration the algorithm remains the frequency of the slowest node without change and scaling the frequency of the other nodes. This is gives better performance and energy tradeoff. +The proposed algorithm works online during the execution time of the MPI +program. Its returns a set of optimal frequency scaling factors $Sopt_i$ depending on the objective function EQ(\ref{eq:max}). The program changes the new frequencies of the CPUs according to the computed scaling factors. This algorithm has a small execution time: +for an heterogeneous cluster composed of four different types of nodes having the characteristics presented in +table~(\ref{table:platform}), it takes \np[ms]{0.04} on average for 4 nodes and +\np[ms]{0.1} on average for 128 nodes. The algorithm complexity is $O(F\cdot (N \cdot4) )$, +where $F$ is the number of iterations and $N$ is the number of +computing nodes. The algorithm needs on average from 12 to 20 iterations for all the NAS benchmark on class C to selects the best set of frequency scaling factors. Its called just once during the execution of the program. The DVFS figure~(\ref{dvfs}) shows where and when the algorithm is +called in the MPI program. +\begin{figure}[tp] + \begin{algorithmic}[1] + % \footnotesize + \For {$k=1$ to \textit{some iterations}} + \State Computations section. + \State Communications section. + \If {$(k=1)$} + \State Gather all times of computation and\newline\hspace*{3em}% + communication from each node. + \State Call algorithm from Figure~\ref{HSA} with these times. + \State Compute the new frequencies from the\newline\hspace*{3em}% + returned optimal scaling factors. + \State Set the new frequencies to nodes. + \EndIf + \EndFor + \end{algorithmic} + \caption{DVFS algorithm} + \label{dvfs} +\end{figure} + +\section{Experimental results} +\label{sec.expe} +The experiments of this work are executed on the simulator Simgrid/SMPI v3.10. We configure the simulator to use a heterogeneous cluster +with one core per node. The proposed heterogeneous cluster has four different types of nodes. Each node in cluster has different characteristics +such as the maximum frequency speed, the number of available frequencies and dynamic and static powers values, see table (\ref{table:platform}). These different types of processing nodes simulate some real Intel processors. The maximum number of nodes that supported by the cluster is 144 nodes according to characteristics of some MPI programs of the NAS benchmarks that used. We are use the same number from each type of nodes when running the MPI programs, for example if we execute the program on 8 node, there are 2 nodes from each type participating in the computing. The dynamic and static power values is different from one type to other. Each node has a dynamic and static power values proportional to their performance/GFlops, for more details see the Intel data sheets in \cite{47}. Each node has a percentage of 80\% for dynamic power and 20\% for static power from the hole power consumption, the same assumption is made in \cite{45,3}. These nodes are connected via an ethernet network with 1 Gbit/s bandwidth. +\begin{table}[htb] + \caption{Heterogeneous nodes characteristics} + % title of Table + \centering + \begin{tabular}{|*{7}{l|}} + \hline + Node & Similar & Max & Min & Diff. & Dynamic & Static \\ + type & to & Freq. GHz & Freq. GHz & Freq GHz & power & power \\ + \hline + 1 & core-i3 & 2.5 & 1.2 & 0.1 & 20~w &4~w \\ + & 2100T & & & & & \\ + \hline + 2 & Xeon & 2.66 & 1.6 & 0.133 & 25~w &5~w \\ + & 7542 & & & & & \\ + \hline + 3 & core-i5 & 2.9 & 1.2 & 0.1 & 30~w &6~w \\ + & 3470s & & & & & \\ + \hline + 4 & core-i7 & 3.4 & 1.6 & 0.133 & 35~w &7~w \\ + & 2600s & & & & & \\ + \hline + \end{tabular} + \label{table:platform} +\end{table} + + +%\subsection{Performance prediction verification} + + +\subsection{The experimental results of the scaling algorithm} +\label{sec.res} + +The proposed algorithm was applied to seven MPI programs of the NAS benchmarks (EP, CG, MG, FT, BT, LU and SP) NPB v3. +\cite{44}, which were run with three classes (A, B and C). +In this experiments we are focus on running of the class C, the biggest class compared to A and B, on different number of +nodes, from 4 to 128 or 144 nodes according to the type of the MPI program. Depending on the proposed energy consumption model EQ(\ref{eq:energy}), + we are measure the energy consumption for all NAS MPI programs. The dynamic and static power values used under the same assumption used by \cite{45,3}. We used a percentage of 80\% for dynamic power from all power consumption of the CPU and 20\% for static power. The heterogeneous nodes in table (\ref{table:platform}) have different simulated performance, ranked from the node of type 1 with smaller performance/GFlops to the highest performance/GFlops for node 4. Therefore, the power values used proportionally increased from node 1 to node 4 that with highest performance. Then we used an assumption that the power consumption increases linearly with the performance/GFlops of the processor see \cite{48}. + +\begin{table}[htb] + \caption{Running NAS benchmarks on 4 nodes } + % title of Table + \centering + \begin{tabular}{|*{7}{l|}} + \hline + Method & Execution & Energy & Energy & Performance & Distance \\ + name & time/s & consumption/J & saving\% & degradation\% & \\ + \hline + CG & 64.64 & 3560.39 &34.16 &6.72 &27.44 \\ + \hline + MG & 18.89 & 1074.87 &35.37 &4.34 &31.03 \\ + \hline + EP &79.73 &5521.04 &26.83 &3.04 &23.79 \\ + \hline + LU &308.65 &21126.00 &34.00 &6.16 &27.84 \\ + \hline + BT &360.12 &21505.55 &35.36 &8.49 &26.87 \\ + \hline + SP &234.24 &13572.16 &35.22 &5.70 &29.52 \\ + \hline + FT &81.58 &4151.48 &35.58 &0.99 &34.59 \\ +\hline + \end{tabular} + \label{table:res_4n} +\end{table} + +\begin{table}[htb] + \caption{Running NAS benchmarks on 8 and 9 nodes } + % title of Table + \centering + \begin{tabular}{|*{7}{l|}} + \hline + Method & Execution & Energy & Energy & Performance & Distance \\ + name & time/s & consumption/J & saving\% & degradation\% & \\ + \hline + CG &36.11 &3263.49 &31.25 &7.12 &24.13 \\ + \hline + MG &8.99 &953.39 &33.78 &6.41 &27.37 \\ + \hline + EP &40.39 &5652.81 &27.04 &0.49 &26.55 \\ + \hline + LU &218.79 &36149.77 &28.23 &0.01 &28.22 \\ + \hline + BT &166.89 &23207.42 &32.32 &7.89 &24.43 \\ + \hline + SP &104.73 &18414.62 &24.73 &2.78 &21.95 \\ + \hline + FT &51.10 &4913.26 &31.02 &2.54 &28.48 \\ +\hline + \end{tabular} + \label{table:res_8n} +\end{table} + +\begin{table}[htb] + \caption{Running NAS benchmarks on 16 nodes } + % title of Table + \centering + \begin{tabular}{|*{7}{l|}} + \hline + Method & Execution & Energy & Energy & Performance & Distance \\ + name & time/s & consumption/J & saving\% & degradation\% & \\ + \hline + CG &31.74 &4373.90 &26.29 &9.57 &16.72 \\ + \hline + MG &5.71 &1076.19 &32.49 &6.05 &26.44 \\ + \hline + EP &20.11 &5638.49 &26.85 &0.56 &26.29 \\ + \hline + LU &144.13 &42529.06 &28.80 &6.56 &22.24 \\ + \hline + BT &97.29 &22813.86 &34.95 &5.80 &29.15 \\ + \hline + SP &66.49 &20821.67 &22.49 &3.82 &18.67 \\ + \hline + FT &37.01 &5505.60 &31.59 &6.48 &25.11 \\ +\hline + \end{tabular} + \label{table:res_16n} +\end{table} + +\begin{table}[htb] + \caption{Running NAS benchmarks on 32 and 36 nodes } + % title of Table + \centering + \begin{tabular}{|*{7}{l|}} + \hline + Method & Execution & Energy & Energy & Performance & Distance \\ + name & time/s & consumption/J & saving\% & degradation\% & \\ + \hline + CG &32.35 &6704.21 &16.15 &5.30 &10.85 \\ + \hline + MG &4.30 &1355.58 &28.93 &8.85 &20.08 \\ + \hline + EP &9.96 &5519.68 &26.98 &0.02 &26.96 \\ + \hline + LU &99.93 &67463.43 &23.60 &2.45 &21.15 \\ + \hline + BT &48.61 &23796.97 &34.62 &5.83 &28.79 \\ + \hline + SP &46.01 &27007.43 &22.72 &3.45 &19.27 \\ + \hline + FT &28.06 &7142.69 &23.09 &2.90 &20.19 \\ +\hline + \end{tabular} + \label{table:res_32n} +\end{table} + +\begin{table}[htb] + \caption{Running NAS benchmarks on 64 nodes } + % title of Table + \centering + \begin{tabular}{|*{7}{l|}} + \hline + Method & Execution & Energy & Energy & Performance & Distance \\ + name & time/s & consumption/J & saving\% & degradation\% & \\ + \hline + CG &46.65 &17521.83 &8.13 &1.68 &6.45 \\ + \hline + MG &3.27 &1534.70 &29.27 &14.35 &14.92 \\ + \hline + EP &5.05 &5471.1084 &27.12 &3.11 &24.01 \\ + \hline + LU &73.92 &101339.16 &21.96 &3.67 &18.29 \\ + \hline + BT &39.99 &27166.71 &32.02 &12.28 &19.74 \\ + \hline + SP &52.00 &49099.28 &24.84 &0.03 &24.81 \\ + \hline + FT &25.97 &10416.82 &20.15 &4.87 &15.28 \\ +\hline + \end{tabular} + \label{table:res_64n} +\end{table} + + +\begin{table}[htb] + \caption{Running NAS benchmarks on 128 and 144 nodes } + % title of Table + \centering + \begin{tabular}{|*{7}{l|}} + \hline + Method & Execution & Energy & Energy & Performance & Distance \\ + name & time/s & consumption/J & saving\% & degradation\% & \\ + \hline + CG &56.92 &41163.36 &4.00 &1.10 &2.90 \\ + \hline + MG &3.55 &2843.33 &18.77 &10.38 &8.39 \\ + \hline + EP &2.67 &5669.66 &27.09 &0.03 &27.06 \\ + \hline + LU &51.23 &144471.90 &16.67 &2.36 &14.31 \\ + \hline + BT &37.96 &44243.82 &23.18 &1.28 &21.90 \\ + \hline + SP &64.53 &115409.71 &26.72 &0.05 &26.67 \\ + \hline + FT &25.51 &18808.72 &12.85 &2.84 &10.01 \\ +\hline + \end{tabular} + \label{table:res_128n} +\end{table} + +The results of applying the proposed scaling algorithm to NAS benchmarks is demonstrated in tables (\ref{table:res_4n}, \ref{table:res_8n}, \ref{table:res_16n}, +\ref{table:res_32n}, \ref{table:res_64n} and \ref{table:res_128n}). These tables show the results for running the NAS benchmarks on different number of nodes. In general the energy saving percent is decreased when the number of the computing nodes is increased. While the distance is decreased by the same direction. This because when we are run the MPI programs on a big number of nodes the communications is biggest than the computations, so the static energy is increased linearly to these times. The tables also show that performance degradation percent still approximately the same or decreased a little when the number of computing nodes is increased. This gives good a prove that the proposed algorithm keeping as mush as possible the performance degradation. + +\begin{figure} + \centering + \subfloat[Balanced nodes type scenario]{% + \includegraphics[width=.23185\textwidth]{fig/avg_eq.eps}\label{fig:avg_eq}}% + \quad% + \subfloat[Imbalanced nodes type scenario]{% + \includegraphics[width=.23185\textwidth]{fig/avg_neq.eps}\label{fig:avg_neq}} + \label{fig:avg} + \caption{The average of energy and performance for all Nas benchmarks running with difference number of nodes} +\end{figure} + +In the NAS benchmarks there are some programs executed on different number of nodes. The benchmarks CG, MG, LU and FT executed on 2 to a power of (1, 2, 4, 8, ...) of nodes. The other benchmarks such as BT and SP executed on 2 to a power of (1, 2, 4, 9, ...) of nodes. We are take the average of energy saving, performance degradation and distances for all results of NAS benchmarks. The average of these three objectives are plotted to the number of nodes as in plots (\ref{fig:avg_eq} and \ref{fig:avg_neq}). In CG, MG, LU, and FT benchmarks the average of energy saving is decreased when the number of nodes is increased due to the increasing in the communication times as mentioned before. Thus, the average of distances (our objective function) is decreased linearly with energy saving while keeping the average of performance degradation the same. In BT and SP benchmarks, the average of energy saving is not decreased significantly compare to other benchmarks when the number of nodes is increased. Nevertheless, the average of performance degradation approximately still the same ratio. This difference is depends on the characteristics of the benchmarks such as the computation to communication ratio that has. + +\subsection{The results for different powers scenarios} +The results of the previous section are obtained using a percentage of 80\% for dynamic power and 20\% for static power of total power consumption. In this section we are change these ratio by using two others scenarios. Because is interested to measure the ability of the proposed algorithm to changes it behaviour when these power ratios are changed. In fact, we are use two different scenarios for dynamic and static power ratios in addition to the previous scenario in section (\ref{sec.res}). Therefore, we have three different scenarios for three different dynamic and static power ratios refer to as: 70\%-20\%, 80\%-20\% and 90\%-10\% scenario. The results of these scenarios running NAS benchmarks class C on 8 or 9 nodes are place in the tables (\ref{table:res_s1} and \ref{table:res_s2}). + + \begin{table}[htb] + \caption{The results of 70\%-30\% powers scenario} + % title of Table + \centering + \begin{tabular}{|*{6}{l|}} + \hline + Method & Energy & Energy & Performance & Distance \\ + name & consumption/J & saving\% & degradation\% & \\ + \hline + CG &4144.21 &22.42 &7.72 &14.70 \\ + \hline + MG &1133.23 &24.50 &5.34 &19.16 \\ + \hline + EP &6170.30 &16.19 &0.02 &16.17 \\ + \hline + LU &39477.28 &20.43 &0.07 &20.36 \\ + \hline + BT &26169.55 &25.34 &6.62 &18.71 \\ + \hline + SP &19620.09 &19.32 &3.66 &15.66 \\ + \hline + FT &6094.07 &23.17 &0.36 &22.81 \\ +\hline + \end{tabular} + \label{table:res_s1} +\end{table} + + + +\begin{table}[htb] + \caption{The results of 90\%-10\% powers scenario} + % title of Table + \centering + \begin{tabular}{|*{6}{l|}} + \hline + Method & Energy & Energy & Performance & Distance \\ + name & consumption/J & saving\% & degradation\% & \\ + \hline + CG &2812.38 &36.36 &6.80 &29.56 \\ + \hline + MG &825.427 &38.35 &6.41 &31.94 \\ + \hline + EP &5281.62 &35.02 &2.68 &32.34 \\ + \hline + LU &31611.28 &39.15 &3.51 &35.64 \\ + \hline + BT &21296.46 &36.70 &6.60 &30.10 \\ + \hline + SP &15183.42 &35.19 &11.76 &23.43 \\ + \hline + FT &3856.54 &40.80 &5.67 &35.13 \\ +\hline + \end{tabular} + \label{table:res_s2} +\end{table} + + +\begin{figure} + \centering + \subfloat[Comparison the average of the results on 8 nodes]{% + \includegraphics[width=.22\textwidth]{fig/sen_comp.pdf}\label{fig:sen_comp}}% + \quad% + \subfloat[Comparison the selected frequency scaling factors for 8 nodes]{% + \includegraphics[width=.24\textwidth]{fig/three_scenarios.pdf}\label{fig:scales_comp}} + \label{fig:avg} + \caption{The comparison of the three power scenarios} +\end{figure} + +To compare the results of these three powers scenarios, we are take the average of the performance degradation, the energy saving and the distances for all NAS benchmarks running on 8 or 9 nodes of class C, as in figure (\ref{fig:sen_comp}). Thus, according to the average of the results, the energy saving ratio is increased when using the a higher percentage for dynamic power (e.g. 90\%-10\% scenario). While the average of energy saving is decreased in 70\%-30\% scenario. +Because the static energy consumption is increase. Moreover, the average of distances is more related to energy saving changes. The average of the performance degradation is decreased when using a higher ratio for static power (e.g. 70\%-30\% scenario and 80\%-20\% scenario). The raison behind these relations, that the proposed algorithm optimize both energy consumption and performance in the same time. Therefore, when using a higher ratio for dynamic power the algorithm selecting bigger frequency scaling factors values, more energy saving versus more performance degradation, for example see the figure (\ref{fig:scales_comp}). The inverse happen when using a higher ratio for static power, the algorithm proportionally selects a smaller scaling values, less energy saving versus less performance degradation. This is because the +algorithm also keeps as much as possible the static energy consumption that is always related to execution time. + +\subsection{The verifications of the proposed method} +\label{sec.verif} +The precision of the proposed algorithm mainly depends on the execution time prediction model and the energy model. The energy model is significantly depends on the execution time model EQ(\ref{eq:perf}), that the energy static related linearly. So, we are compare the predicted execution time with the real execution time (Simgrid time) values that gathered offline for the NAS benchmarks class B executed on 8 or 9 nodes. The execution time model can predicts +the real execution time by maximum normalized error 0.03 of all NAS benchmarks. The second verification that we are make is for the scaling algorithm to prove its ability to selects the best set of frequency scaling factors. Therefore, we are expand the algorithm to test at each iteration the frequency scaling factor of the slowest node with the all scaling factors available of the other nodes. This version of the algorithm is applied to different NAS benchmarks classes with different number of nodes. The results from the two algorithms is identical. While the proposed algorithm is runs faster, 10 times faster on average than the expanded algorithm. + +\section{Conclusion} +\label{sec.concl} + + +\section*{Acknowledgment} + + +% trigger a \newpage just before the given reference +% number - used to balance the columns on the last page +% adjust value as needed - may need to be readjusted if +% the document is modified later +%\IEEEtriggeratref{15} + +\bibliographystyle{IEEEtran} +\bibliography{IEEEabrv,my_reference} +\end{document} + +%%% Local Variables: +%%% mode: latex +%%% TeX-master: t +%%% fill-column: 80 +%%% ispell-local-dictionary: "american" +%%% End: + +% LocalWords: Fanfakh Charr FIXME Tianhe DVFS HPC NAS NPB SMPI Rauber's Rauber +% LocalWords: CMOS EQ EPSA Franche Comté Tflop Rünger IUT Maréchal Juin cedex diff --git a/IEEEabrv.bib b/IEEEabrv.bib new file mode 100644 index 0000000..56cae65 --- /dev/null +++ b/IEEEabrv.bib @@ -0,0 +1,447 @@ + +IEEEabrv.bib +V1.12 (2007/01/11) +Copyright (c) 2002-2007 by Michael Shell +See: http://www.michaelshell.org/ +for current contact information. + +BibTeX bibliography string definitions of the ABBREVIATED titles of +IEEE journals and magazines and online publications. + +This file is designed for bibliography styles that require +abbreviated titles and is not for use in bibliographies that +require full-length titles. + +Support sites: +http://www.michaelshell.org/tex/ieeetran/ +http://www.ctan.org/tex-archive/macros/latex/contrib/IEEEtran/ +and/or +http://www.ieee.org/ + +Special thanks to Laura Hyslop and ken Rawson of IEEE for their help +in obtaining the information needed to compile this file. Also, +Volker Kuhlmann and Moritz Borgmann kindly provided some corrections +and additions. + +************************************************************************* +Legal Notice: +This code is offered as-is without any warranty either expressed or +implied; without even the implied warranty of MERCHANTABILITY or +FITNESS FOR A PARTICULAR PURPOSE! +User assumes all risk. +In no event shall IEEE or any contributor to this code be liable for +any damages or losses, including, but not limited to, incidental, +consequential, or any other damages, resulting from the use or misuse +of any information contained here. + +All comments are the opinions of their respective authors and are not +necessarily endorsed by the IEEE. + +This work is distributed under the LaTeX Project Public License (LPPL) +( http://www.latex-project.org/ ) version 1.3, and may be freely used, +distributed and modified. A copy of the LPPL, version 1.3, is included +in the base LaTeX documentation of all distributions of LaTeX released +2003/12/01 or later. +Retain all contribution notices and credits. +** Modified files should be clearly indicated as such, including ** +** renaming them and changing author support contact information. ** + +File list of work: IEEEabrv.bib, IEEEfull.bib, IEEEexample.bib, + IEEEtran.bst, IEEEtranS.bst, IEEEtranSA.bst, + IEEEtranN.bst, IEEEtranSN.bst, IEEEtran_bst_HOWTO.pdf +************************************************************************* + + +USAGE: + +\bibliographystyle{mybstfile} +\bibliography{IEEEabrv,mybibfile} + +where the IEEE titles in the .bib database entries use the strings +defined here. e.g., + + + journal = IEEE_J_AC, + + +to yield "{IEEE} Trans. Automat. Contr." + + +IEEE uses abbreviated journal titles in their bibliographies - +this file is suitable for work that is to be submitted to the IEEE. + + +For work that requires full-length titles, you should use the full +titles provided in the companion file, IEEEfull.bib. + + +** NOTES ** + + 1. Journals have been grouped according to subject in order to make it + easier to locate and extract the definitions for related journals - + as most works use references that are confined to a single topic. + Magazines are listed in straight alphabetical order. + + 2. String names are closely based on IEEE's own internal acronyms. + + 3. Abbreviations follow IEEE's style. + + 4. Older, out-of-print IEEE titles are included (but not including titles + dating prior to IEEE's formation from the IRE and AIEE in 1963). + + 5. The following NEW/current journal definitions have been disabled because + their abbreviations have not yet been verified: + + STRING{IEEE_J_CBB = "{IEEE/ACM} Trans. Comput. Biology Bioinformatics"} + STRING{IEEE_J_CJECE = "Canadian J. Elect. Comput. Eng."} + STRING{IEEE_J_DSC = "{IEEE} Trans. Dependable Secure Comput."} + STRING{IEEE_O_DSO = "{IEEE} Distrib. Syst. Online"} + + 6. The following OLD journal definitions have been disabled because + their abbreviations have not yet been found/verified: + + STRING{IEEE_J_BCTV = "{IEEE} Trans. Broadcast Television Receivers"} + STRING{IEEE_J_EWS = "{IEEE} Trans. Eng. Writing Speech"} + +If you know what the proper abbreviation is for a string in #5 or #6 above, +email me and I will correct them in the next release. + + + + + +IEEE Journals + + + +aerospace and military +@STRING{IEEE_J_AES = "{IEEE} Trans. Aerosp. Electron. Syst."} +@STRING{IEEE_J_ANE = "{IEEE} Trans. Aerosp. Navig. Electron."} +@STRING{IEEE_J_ANNE = "{IEEE} Trans. Aeronaut. Navig. Electron."} +@STRING{IEEE_J_AS = "{IEEE} Trans. Aerosp."} +@STRING{IEEE_J_AIRE = "{IEEE} Trans. Airborne Electron."} +@STRING{IEEE_J_MIL = "{IEEE} Trans. Mil. Electron."} + + + +autos, transportation and vehicles (non-aerospace) +@STRING{IEEE_J_ITS = "{IEEE} Trans. Intell. Transp. Syst."} +@STRING{IEEE_J_VT = "{IEEE} Trans. Veh. Technol."} +@STRING{IEEE_J_VC = "{IEEE} Trans. Veh. Commun."} + + + +circuits, signals, systems, audio and controls +@STRING{IEEE_J_SPL = "{IEEE} Signal Process. Lett."} +@STRING{IEEE_J_ASSP = "{IEEE} Trans. Acoust., Speech, Signal Process."} +@STRING{IEEE_J_AU = "{IEEE} Trans. Audio"} +@STRING{IEEE_J_AUEA = "{IEEE} Trans. Audio Electroacoust."} +@STRING{IEEE_J_AC = "{IEEE} Trans. Autom. Control"} +@STRING{IEEE_J_CAS = "{IEEE} Trans. Circuits Syst."} +@STRING{IEEE_J_CASVT = "{IEEE} Trans. Circuits Syst. Video Technol."} +@STRING{IEEE_J_CASI = "{IEEE} Trans. Circuits Syst. {I}"} +@STRING{IEEE_J_CASII = "{IEEE} Trans. Circuits Syst. {II}"} +in 2004 CASI and CASII renamed part title to CASI_RP and CASII_EB, respectively. +@STRING{IEEE_J_CASI_RP = "{IEEE} Trans. Circuits Syst. {I}"} +@STRING{IEEE_J_CASII_EB = "{IEEE} Trans. Circuits Syst. {II}"} +@STRING{IEEE_J_CT = "{IEEE} Trans. Circuit Theory"} +@STRING{IEEE_J_CST = "{IEEE} Trans. Control Syst. Technol."} +@STRING{IEEE_J_SP = "{IEEE} Trans. Signal Process."} +@STRING{IEEE_J_SU = "{IEEE} Trans. Sonics Ultrason."} +@STRING{IEEE_J_SAP = "{IEEE} Trans. Speech Audio Process."} +@STRING{IEEE_J_UE = "{IEEE} Trans. Ultrason. Eng."} +@STRING{IEEE_J_UFFC = "{IEEE} Trans. Ultrason., Ferroelectr., Freq. Control"} + + + +communications +@STRING{IEEE_J_COML = "{IEEE} Commun. Lett."} +@STRING{IEEE_J_JSAC = "{IEEE} J. Sel. Areas Commun."} +@STRING{IEEE_J_COM = "{IEEE} Trans. Commun."} +@STRING{IEEE_J_COMT = "{IEEE} Trans. Commun. Technol."} +@STRING{IEEE_J_WCOM = "{IEEE} Trans. Wireless Commun."} + + + +components, packaging and manufacturing +@STRING{IEEE_J_ADVP = "{IEEE} Trans. Adv. Packag."} +@STRING{IEEE_J_CHMT = "{IEEE} Trans. Compon., Hybrids, Manuf. Technol."} +@STRING{IEEE_J_CPMTA = "{IEEE} Trans. Compon., Packag., Manuf. Technol. {A}"} +@STRING{IEEE_J_CPMTB = "{IEEE} Trans. Compon., Packag., Manuf. Technol. {B}"} +@STRING{IEEE_J_CPMTC = "{IEEE} Trans. Compon., Packag., Manuf. Technol. {C}"} +@STRING{IEEE_J_CAPT = "{IEEE} Trans. Compon. Packag. Technol."} +@STRING{IEEE_J_CAPTS = "{IEEE} Trans. Compon. Packag. Technol."} +@STRING{IEEE_J_CPART = "{IEEE} Trans. Compon. Parts"} +@STRING{IEEE_J_EPM = "{IEEE} Trans. Electron. Packag. Manuf."} +@STRING{IEEE_J_MFT = "{IEEE} Trans. Manuf. Technol."} +@STRING{IEEE_J_PHP = "{IEEE} Trans. Parts, Hybrids, Packag."} +@STRING{IEEE_J_PMP = "{IEEE} Trans. Parts, Mater., Packag."} + + + +CAD +@STRING{IEEE_J_TCAD = "{IEEE} J. Technol. Comput. Aided Design"} +@STRING{IEEE_J_CAD = "{IEEE} Trans. Comput.-Aided Design Integr. Circuits Syst."} + + + +coding, data, information, knowledge +@STRING{IEEE_J_IT = "{IEEE} Trans. Inf. Theory"} +@STRING{IEEE_J_KDE = "{IEEE} Trans. Knowl. Data Eng."} + + + +computers, computation, networking and software +@STRING{IEEE_J_C = "{IEEE} Trans. Comput."} +@STRING{IEEE_J_CAL = "{IEEE} Comput. Archit. Lett."} +disabled till definition is verified +STRING{IEEE_J_DSC = "{IEEE} Trans. Dependable Secure Comput."} +@STRING{IEEE_J_ECOMP = "{IEEE} Trans. Electron. Comput."} +@STRING{IEEE_J_EVC = "{IEEE} Trans. Evol. Comput."} +@STRING{IEEE_J_FUZZ = "{IEEE} Trans. Fuzzy Syst."} +@STRING{IEEE_J_IFS = "{IEEE} Trans. Inf. Forensics Security"} +@STRING{IEEE_J_MC = "{IEEE} Trans. Mobile Comput."} +@STRING{IEEE_J_NET = "{IEEE/ACM} Trans. Netw."} +@STRING{IEEE_J_NN = "{IEEE} Trans. Neural Netw."} +@STRING{IEEE_J_PDS = "{IEEE} Trans. Parallel Distrib. Syst."} +@STRING{IEEE_J_SE = "{IEEE} Trans. Softw. Eng."} + + + +computer graphics, imaging, and multimedia +@STRING{IEEE_J_JDT = "{IEEE/OSA} J. Display Technol."} +@STRING{IEEE_J_IP = "{IEEE} Trans. Image Process."} +@STRING{IEEE_J_MM = "{IEEE} Trans. Multimedia"} +@STRING{IEEE_J_VCG = "{IEEE} Trans. Vis. Comput. Graphics"} + + + +cybernetics, ergonomics, robots, man-machine, and automation +@STRING{IEEE_J_ASE = "{IEEE} Trans. Autom. Sci. Eng."} +@STRING{IEEE_J_JRA = "{IEEE} J. Robot. Autom."} +@STRING{IEEE_J_HFE = "{IEEE} Trans. Hum. Factors Electron."} +@STRING{IEEE_J_MMS = "{IEEE} Trans. Man-Mach. Syst."} +@STRING{IEEE_J_PAMI = "{IEEE} Trans. Pattern Anal. Mach. Intell."} +in 1989 JRA became RA +in August 2004, RA split into ASE and RO +@STRING{IEEE_J_RA = "{IEEE} Trans. Robot. Autom."} +@STRING{IEEE_J_RO = "{IEEE} Trans. Robot."} +@STRING{IEEE_J_SMC = "{IEEE} Trans. Syst., Man, Cybern."} +@STRING{IEEE_J_SMCA = "{IEEE} Trans. Syst., Man, Cybern. {A}"} +@STRING{IEEE_J_SMCB = "{IEEE} Trans. Syst., Man, Cybern. {B}"} +@STRING{IEEE_J_SMCC = "{IEEE} Trans. Syst., Man, Cybern. {C}"} +@STRING{IEEE_J_SSC = "{IEEE} Trans. Syst. Sci. Cybern."} + + + +earth, wind, fire and water +@STRING{IEEE_J_GE = "{IEEE} Trans. Geosci. Electron."} +@STRING{IEEE_J_GRS = "{IEEE} Trans. Geosci. Remote Sens."} +@STRING{IEEE_J_GRSL = "{IEEE} Geosci. Remote Sens. Lett."} +@STRING{IEEE_J_OE = "{IEEE} J. Ocean. Eng."} + + + +education, engineering, history, IEEE, professional +disabled till definition is verified +STRING{IEEE_J_CJECE = "Canadian J. Elect. Comput. Eng."} +@STRING{IEEE_J_PROC = "Proc. {IEEE}"} +@STRING{IEEE_J_EDU = "{IEEE} Trans. Educ."} +@STRING{IEEE_J_EM = "{IEEE} Trans. Eng. Manag."} +disabled till definition is verified +STRING{IEEE_J_EWS = "{IEEE} Trans. Eng. Writing Speech"} +@STRING{IEEE_J_PC = "{IEEE} Trans. Prof. Commun."} + + + +electromagnetics, antennas, EMI, magnetics and microwave +@STRING{IEEE_J_AWPL = "{IEEE} Antennas Wireless Propag. Lett."} +@STRING{IEEE_J_MGWL = "{IEEE} Microw. Guided Wave Lett."} +IEEE seems to want "Compon." here, not "Comp." +@STRING{IEEE_J_MWCL = "{IEEE} Microw. Wireless Compon. Lett."} +@STRING{IEEE_J_AP = "{IEEE} Trans. Antennas Propag."} +@STRING{IEEE_J_EMC = "{IEEE} Trans. Electromagn. Compat."} +@STRING{IEEE_J_MAG = "{IEEE} Trans. Magn."} +@STRING{IEEE_J_MTT = "{IEEE} Trans. Microw. Theory Tech."} +@STRING{IEEE_J_RFI = "{IEEE} Trans. Radio Freq. Interference"} +@STRING{IEEE_J_TJMJ = "{IEEE} Transl. J. Magn. Jpn."} + + + +energy and power +@STRING{IEEE_J_EC = "{IEEE} Trans. Energy Convers."} +@STRING{IEEE_J_PEL = "{IEEE} Power Electron. Lett."} +@STRING{IEEE_J_PWRAS = "{IEEE} Trans. Power App. Syst."} +@STRING{IEEE_J_PWRD = "{IEEE} Trans. Power Del."} +@STRING{IEEE_J_PWRE = "{IEEE} Trans. Power Electron."} +@STRING{IEEE_J_PWRS = "{IEEE} Trans. Power Syst."} + + + +industrial, commercial and consumer +@STRING{IEEE_J_APPIND = "{IEEE} Trans. Appl. Ind."} +@STRING{IEEE_J_BC = "{IEEE} Trans. Broadcast."} +disabled till definition is verified +STRING{IEEE_J_BCTV = "{IEEE} Trans. Broadcast Television Receivers"} +@STRING{IEEE_J_CE = "{IEEE} Trans. Consum. Electron."} +@STRING{IEEE_J_IE = "{IEEE} Trans. Ind. Electron."} +@STRING{IEEE_J_IECI = "{IEEE} Trans. Ind. Electron. Contr. Instrum."} +@STRING{IEEE_J_IA = "{IEEE} Trans. Ind. Appl."} +@STRING{IEEE_J_IGA = "{IEEE} Trans. Ind. Gen. Appl."} +@STRING{IEEE_J_IINF = "{IEEE} Trans. Ind. Informat."} +@STRING{IEEE_J_PSE = "{IEEE} J. Product Safety Eng."} + + + +instrumentation and measurement +@STRING{IEEE_J_IM = "{IEEE} Trans. Instrum. Meas."} + + + +insulation and materials +@STRING{IEEE_J_JEM = "{IEEE/TMS} J. Electron. Mater."} +@STRING{IEEE_J_DEI = "{IEEE} Trans. Dielectr. Electr. Insul."} +@STRING{IEEE_J_EI = "{IEEE} Trans. Electr. Insul."} + + + +mechanical +@STRING{IEEE_J_MECH = "{IEEE/ASME} Trans. Mechatronics"} +@STRING{IEEE_J_MEMS = "J. Microelectromech. Syst."} + + + +medical and biological +@STRING{IEEE_J_BME = "{IEEE} Trans. Biomed. Eng."} +Note: The B-ME journal later dropped the hyphen and became the BME. +@STRING{IEEE_J_B-ME = "{IEEE} Trans. Bio-Med. Eng."} +@STRING{IEEE_J_BMELC = "{IEEE} Trans. Bio-Med. Electron."} +disabled till definition is verified +STRING{IEEE_J_CBB = "{IEEE/ACM} Trans. Comput. Biology Bioinformatics"} +@STRING{IEEE_J_ITBM = "{IEEE} Trans. Inf. Technol. Biomed."} +@STRING{IEEE_J_ME = "{IEEE} Trans. Med. Electron."} +@STRING{IEEE_J_MI = "{IEEE} Trans. Med. Imag."} +@STRING{IEEE_J_NB = "{IEEE} Trans. Nanobiosci."} +@STRING{IEEE_J_NSRE = "{IEEE} Trans. Neural Syst. Rehabil. Eng."} +@STRING{IEEE_J_RE = "{IEEE} Trans. Rehabil. Eng."} + + + + optics, lightwave and photonics +@STRING{IEEE_J_PTL = "{IEEE} Photon. Technol. Lett."} +@STRING{IEEE_J_JLT = "J. Lightw. Technol."} + + + +physics, electrons, nanotechnology, nuclear and quantum electronics +@STRING{IEEE_J_EDL = "{IEEE} Electron Device Lett."} +@STRING{IEEE_J_JQE = "{IEEE} J. Quantum Electron."} +@STRING{IEEE_J_JSTQE = "{IEEE} J. Sel. Topics Quantum Electron."} +@STRING{IEEE_J_ED = "{IEEE} Trans. Electron Devices"} +@STRING{IEEE_J_NANO = "{IEEE} Trans. Nanotechnol."} +@STRING{IEEE_J_NS = "{IEEE} Trans. Nucl. Sci."} +@STRING{IEEE_J_PS = "{IEEE} Trans. Plasma Sci."} + + + +reliability +IEEE seems to want "Mat." here, not "Mater." +@STRING{IEEE_J_DMR = "{IEEE} Trans. Device Mater. Rel."} +@STRING{IEEE_J_R = "{IEEE} Trans. Rel."} + + + +semiconductors, superconductors, electrochemical and solid state +@STRING{IEEE_J_ESSL = "{IEEE/ECS} Electrochem. Solid-State Lett."} +@STRING{IEEE_J_JSSC = "{IEEE} J. Solid-State Circuits"} +@STRING{IEEE_J_ASC = "{IEEE} Trans. Appl. Supercond."} +@STRING{IEEE_J_SM = "{IEEE} Trans. Semicond. Manuf."} + + + +sensors +@STRING{IEEE_J_SENSOR = "{IEEE} Sensors J."} + + + +VLSI +@STRING{IEEE_J_VLSI = "{IEEE} Trans. {VLSI} Syst."} + + + + + + +IEEE Magazines + + + +@STRING{IEEE_M_AES = "{IEEE} Aerosp. Electron. Syst. Mag."} +@STRING{IEEE_M_HIST = "{IEEE} Ann. Hist. Comput."} +@STRING{IEEE_M_AP = "{IEEE} Antennas Propag. Mag."} +@STRING{IEEE_M_ASSP = "{IEEE} {ASSP} Mag."} +@STRING{IEEE_M_CD = "{IEEE} Circuits Devices Mag."} +@STRING{IEEE_M_CAS = "{IEEE} Circuits Syst. Mag."} +@STRING{IEEE_M_COM = "{IEEE} Commun. Mag."} +@STRING{IEEE_M_COMSOC = "{IEEE} Commun. Soc. Mag."} +@STRING{IEEE_M_CIM = "{IEEE} Comput. Intell. Mag."} +CSEM changed to CSE in 1999 +@STRING{IEEE_M_CSE = "{IEEE} Comput. Sci. Eng."} +@STRING{IEEE_M_CSEM = "{IEEE} Comput. Sci. Eng. Mag."} +@STRING{IEEE_M_C = "{IEEE} Computer"} +@STRING{IEEE_M_CAP = "{IEEE} Comput. Appl. Power"} +@STRING{IEEE_M_CGA = "{IEEE} Comput. Graph. Appl."} +@STRING{IEEE_M_CONC = "{IEEE} Concurrency"} +@STRING{IEEE_M_CS = "{IEEE} Control Syst. Mag."} +@STRING{IEEE_M_DTC = "{IEEE} Des. Test. Comput."} +@STRING{IEEE_M_EI = "{IEEE} Electr. Insul. Mag."} +@STRING{IEEE_M_ETR = "{IEEE} ElectroTechnol. Rev."} +@STRING{IEEE_M_EMB = "{IEEE} Eng. Med. Biol. Mag."} +@STRING{IEEE_M_EMR = "{IEEE} Eng. Manag. Rev."} +@STRING{IEEE_M_EXP = "{IEEE} Expert"} +@STRING{IEEE_M_IA = "{IEEE} Ind. Appl. Mag."} +@STRING{IEEE_M_IM = "{IEEE} Instrum. Meas. Mag."} +@STRING{IEEE_M_IS = "{IEEE} Intell. Syst."} +@STRING{IEEE_M_IC = "{IEEE} Internet Comput."} +@STRING{IEEE_M_ITP = "{IEEE} {IT} Prof."} +@STRING{IEEE_M_MICRO = "{IEEE} Micro"} +@STRING{IEEE_M_MW = "{IEEE} Microw. Mag."} +@STRING{IEEE_M_MM = "{IEEE} Multimedia"} +@STRING{IEEE_M_NET = "{IEEE} Netw."} +IEEE's editorial manual lists "Pers. Commun.", +but "Personal Commun. Mag." seems to be what is used in the journals +@STRING{IEEE_M_PCOM = "{IEEE} Personal Commun. Mag."} +@STRING{IEEE_M_POT = "{IEEE} Potentials"} +CAP and PER merged to form PE in 2003 +@STRING{IEEE_M_PE = "{IEEE} Power Energy Mag."} +@STRING{IEEE_M_PER = "{IEEE} Power Eng. Rev."} +@STRING{IEEE_M_PVC = "{IEEE} Pervasive Comput."} +@STRING{IEEE_M_RA = "{IEEE} Robot. Autom. Mag."} +@STRING{IEEE_M_SAP = "{IEEE} Security Privacy"} +@STRING{IEEE_M_SP = "{IEEE} Signal Process. Mag."} +@STRING{IEEE_M_S = "{IEEE} Softw."} +@STRING{IEEE_M_SPECT = "{IEEE} Spectr."} +@STRING{IEEE_M_TS = "{IEEE} Technol. Soc. Mag."} +@STRING{IEEE_M_VT = "{IEEE} Veh. Technol. Mag."} +@STRING{IEEE_M_WC = "{IEEE} Wireless Commun. Mag."} +@STRING{IEEE_M_TODAY = "Today's Engineer"} + + + + + + +IEEE Online Publications + + + +@STRING{IEEE_O_CSTO = "{IEEE} Commun. Surveys Tuts."} +disabled till definition is verified +STRING{IEEE_O_DSO = "{IEEE} Distrib. Syst. Online"} + + + + + +-- +EOF diff --git a/IEEEtran.bst b/IEEEtran.bst new file mode 100644 index 0000000..53fbc03 --- /dev/null +++ b/IEEEtran.bst @@ -0,0 +1,2417 @@ +%% +%% IEEEtran.bst +%% BibTeX Bibliography Style file for IEEE Journals and Conferences (unsorted) +%% Version 1.12 (2007/01/11) +%% +%% Copyright (c) 2003-2007 Michael Shell +%% +%% Original starting code base and algorithms obtained from the output of +%% Patrick W. Daly's makebst package as well as from prior versions of +%% IEEE BibTeX styles: +%% +%% 1. Howard Trickey and Oren Patashnik's ieeetr.bst (1985/1988) +%% 2. Silvano Balemi and Richard H. Roy's IEEEbib.bst (1993) +%% +%% Support sites: +%% http://www.michaelshell.org/tex/ieeetran/ +%% http://www.ctan.org/tex-archive/macros/latex/contrib/IEEEtran/ +%% and/or +%% http://www.ieee.org/ +%% +%% For use with BibTeX version 0.99a or later +%% +%% This is a numerical citation style. +%% +%%************************************************************************* +%% Legal Notice: +%% This code is offered as-is without any warranty either expressed or +%% implied; without even the implied warranty of MERCHANTABILITY or +%% FITNESS FOR A PARTICULAR PURPOSE! +%% User assumes all risk. +%% In no event shall IEEE or any contributor to this code be liable for +%% any damages or losses, including, but not limited to, incidental, +%% consequential, or any other damages, resulting from the use or misuse +%% of any information contained here. +%% +%% All comments are the opinions of their respective authors and are not +%% necessarily endorsed by the IEEE. +%% +%% This work is distributed under the LaTeX Project Public License (LPPL) +%% ( http://www.latex-project.org/ ) version 1.3, and may be freely used, +%% distributed and modified. A copy of the LPPL, version 1.3, is included +%% in the base LaTeX documentation of all distributions of LaTeX released +%% 2003/12/01 or later. +%% Retain all contribution notices and credits. +%% ** Modified files should be clearly indicated as such, including ** +%% ** renaming them and changing author support contact information. ** +%% +%% File list of work: IEEEabrv.bib, IEEEfull.bib, IEEEexample.bib, +%% IEEEtran.bst, IEEEtranS.bst, IEEEtranSA.bst, +%% IEEEtranN.bst, IEEEtranSN.bst, IEEEtran_bst_HOWTO.pdf +%%************************************************************************* +% +% +% Changelog: +% +% 1.00 (2002/08/13) Initial release +% +% 1.10 (2002/09/27) +% 1. Corrected minor bug for improperly formed warning message when a +% book was not given a title. Thanks to Ming Kin Lai for reporting this. +% 2. Added support for CTLname_format_string and CTLname_latex_cmd fields +% in the BST control entry type. +% +% 1.11 (2003/04/02) +% 1. Fixed bug with URLs containing underscores when using url.sty. Thanks +% to Ming Kin Lai for reporting this. +% +% 1.12 (2007/01/11) +% 1. Fixed bug with unwanted comma before "et al." when an entry contained +% more than two author names. Thanks to Pallav Gupta for reporting this. +% 2. Fixed bug with anomalous closing quote in tech reports that have a +% type, but without a number or address. Thanks to Mehrdad Mirreza for +% reporting this. +% 3. Use braces in \providecommand in begin.bib to better support +% latex2html. TeX style length assignments OK with recent versions +% of latex2html - 1.71 (2002/2/1) or later is strongly recommended. +% Use of the language field still causes trouble with latex2html. +% Thanks to Federico Beffa for reporting this. +% 4. Added IEEEtran.bst ID and version comment string to .bbl output. +% 5. Provide a \BIBdecl hook that allows the user to execute commands +% just prior to the first entry. +% 6. Use default urlstyle (is using url.sty) of "same" rather than rm to +% better work with a wider variety of bibliography styles. +% 7. Changed month abbreviations from Sept., July and June to Sep., Jul., +% and Jun., respectively, as IEEE now does. Thanks to Moritz Borgmann +% for reporting this. +% 8. Control entry types should not be considered when calculating longest +% label width. +% 9. Added alias www for electronic/online. +% 10. Added CTLname_url_prefix control entry type. + + +%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% +%% DEFAULTS FOR THE CONTROLS OF THE BST STYLE %% +%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% + +% These are the defaults for the user adjustable controls. The values used +% here can be overridden by the user via IEEEtranBSTCTL entry type. + +% NOTE: The recommended LaTeX command to invoke a control entry type is: +% +%\makeatletter +%\def\bstctlcite{\@ifnextchar[{\@bstctlcite}{\@bstctlcite[@auxout]}} +%\def\@bstctlcite[#1]#2{\@bsphack +% \@for\@citeb:=#2\do{% +% \edef\@citeb{\expandafter\@firstofone\@citeb}% +% \if@filesw\immediate\write\csname #1\endcsname{\string\citation{\@citeb}}\fi}% +% \@esphack} +%\makeatother +% +% It is called at the start of the document, before the first \cite, like: +% \bstctlcite{IEEEexample:BSTcontrol} +% +% IEEEtran.cls V1.6 and later does provide this command. + + + +% #0 turns off the display of the number for articles. +% #1 enables +FUNCTION {default.is.use.number.for.article} { #1 } + + +% #0 turns off the display of the paper and type fields in @inproceedings. +% #1 enables +FUNCTION {default.is.use.paper} { #1 } + + +% #0 turns off the forced use of "et al." +% #1 enables +FUNCTION {default.is.forced.et.al} { #0 } + +% The maximum number of names that can be present beyond which an "et al." +% usage is forced. Be sure that num.names.shown.with.forced.et.al (below) +% is not greater than this value! +% Note: There are many instances of references in IEEE journals which have +% a very large number of authors as well as instances in which "et al." is +% used profusely. +FUNCTION {default.max.num.names.before.forced.et.al} { #10 } + +% The number of names that will be shown with a forced "et al.". +% Must be less than or equal to max.num.names.before.forced.et.al +FUNCTION {default.num.names.shown.with.forced.et.al} { #1 } + + +% #0 turns off the alternate interword spacing for entries with URLs. +% #1 enables +FUNCTION {default.is.use.alt.interword.spacing} { #1 } + +% If alternate interword spacing for entries with URLs is enabled, this is +% the interword spacing stretch factor that will be used. For example, the +% default "4" here means that the interword spacing in entries with URLs can +% stretch to four times normal. Does not have to be an integer. Note that +% the value specified here can be overridden by the user in their LaTeX +% code via a command such as: +% "\providecommand\BIBentryALTinterwordstretchfactor{1.5}" in addition to +% that via the IEEEtranBSTCTL entry type. +FUNCTION {default.ALTinterwordstretchfactor} { "4" } + + +% #0 turns off the "dashification" of repeated (i.e., identical to those +% of the previous entry) names. IEEE normally does this. +% #1 enables +FUNCTION {default.is.dash.repeated.names} { #1 } + + +% The default name format control string. +FUNCTION {default.name.format.string}{ "{f.~}{vv~}{ll}{, jj}" } + + +% The default LaTeX font command for the names. +FUNCTION {default.name.latex.cmd}{ "" } + + +% The default URL prefix. +FUNCTION {default.name.url.prefix}{ "[Online]. Available:" } + + +% Other controls that cannot be accessed via IEEEtranBSTCTL entry type. + +% #0 turns off the terminal startup banner/completed message so as to +% operate more quietly. +% #1 enables +FUNCTION {is.print.banners.to.terminal} { #1 } + + + + +%%%%%%%%%%%%%%%%%%%%%%%%%%%%% +%% FILE VERSION AND BANNER %% +%%%%%%%%%%%%%%%%%%%%%%%%%%%%% + +FUNCTION{bst.file.version} { "1.12" } +FUNCTION{bst.file.date} { "2007/01/11" } +FUNCTION{bst.file.website} { "http://www.michaelshell.org/tex/ieeetran/bibtex/" } + +FUNCTION {banner.message} +{ is.print.banners.to.terminal + { "-- IEEEtran.bst version" " " * bst.file.version * + " (" * bst.file.date * ") " * "by Michael Shell." * + top$ + "-- " bst.file.website * + top$ + "-- See the " quote$ * "IEEEtran_bst_HOWTO.pdf" * quote$ * " manual for usage information." * + top$ + } + { skip$ } + if$ +} + +FUNCTION {completed.message} +{ is.print.banners.to.terminal + { "" + top$ + "Done." + top$ + } + { skip$ } + if$ +} + + + + +%%%%%%%%%%%%%%%%%%%%%% +%% STRING CONSTANTS %% +%%%%%%%%%%%%%%%%%%%%%% + +FUNCTION {bbl.and}{ "and" } +FUNCTION {bbl.etal}{ "et~al." } +FUNCTION {bbl.editors}{ "eds." } +FUNCTION {bbl.editor}{ "ed." } +FUNCTION {bbl.edition}{ "ed." } +FUNCTION {bbl.volume}{ "vol." } +FUNCTION {bbl.of}{ "of" } +FUNCTION {bbl.number}{ "no." } +FUNCTION {bbl.in}{ "in" } +FUNCTION {bbl.pages}{ "pp." } +FUNCTION {bbl.page}{ "p." } +FUNCTION {bbl.chapter}{ "ch." } +FUNCTION {bbl.paper}{ "paper" } +FUNCTION {bbl.part}{ "pt." } +FUNCTION {bbl.patent}{ "Patent" } +FUNCTION {bbl.patentUS}{ "U.S." } +FUNCTION {bbl.revision}{ "Rev." } +FUNCTION {bbl.series}{ "ser." } +FUNCTION {bbl.standard}{ "Std." } +FUNCTION {bbl.techrep}{ "Tech. Rep." } +FUNCTION {bbl.mthesis}{ "Master's thesis" } +FUNCTION {bbl.phdthesis}{ "Ph.D. dissertation" } +FUNCTION {bbl.st}{ "st" } +FUNCTION {bbl.nd}{ "nd" } +FUNCTION {bbl.rd}{ "rd" } +FUNCTION {bbl.th}{ "th" } + + +% This is the LaTeX spacer that is used when a larger than normal space +% is called for (such as just before the address:publisher). +FUNCTION {large.space} { "\hskip 1em plus 0.5em minus 0.4em\relax " } + +% The LaTeX code for dashes that are used to represent repeated names. +% Note: Some older IEEE journals used something like +% "\rule{0.275in}{0.5pt}\," which is fairly thick and runs right along +% the baseline. However, IEEE now uses a thinner, above baseline, +% six dash long sequence. +FUNCTION {repeated.name.dashes} { "------" } + + + +%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% +%% PREDEFINED STRING MACROS %% +%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% + +MACRO {jan} {"Jan."} +MACRO {feb} {"Feb."} +MACRO {mar} {"Mar."} +MACRO {apr} {"Apr."} +MACRO {may} {"May"} +MACRO {jun} {"Jun."} +MACRO {jul} {"Jul."} +MACRO {aug} {"Aug."} +MACRO {sep} {"Sep."} +MACRO {oct} {"Oct."} +MACRO {nov} {"Nov."} +MACRO {dec} {"Dec."} + + + +%%%%%%%%%%%%%%%%%% +%% ENTRY FIELDS %% +%%%%%%%%%%%%%%%%%% + +ENTRY + { address + assignee + author + booktitle + chapter + day + dayfiled + edition + editor + howpublished + institution + intype + journal + key + language + month + monthfiled + nationality + note + number + organization + pages + paper + publisher + school + series + revision + title + type + url + volume + year + yearfiled + CTLuse_article_number + CTLuse_paper + CTLuse_forced_etal + CTLmax_names_forced_etal + CTLnames_show_etal + CTLuse_alt_spacing + CTLalt_stretch_factor + CTLdash_repeated_names + CTLname_format_string + CTLname_latex_cmd + CTLname_url_prefix + } + {} + { label } + + + + +%%%%%%%%%%%%%%%%%%%%%%% +%% INTEGER VARIABLES %% +%%%%%%%%%%%%%%%%%%%%%%% + +INTEGERS { prev.status.punct this.status.punct punct.std + punct.no punct.comma punct.period + prev.status.space this.status.space space.std + space.no space.normal space.large + prev.status.quote this.status.quote quote.std + quote.no quote.close + prev.status.nline this.status.nline nline.std + nline.no nline.newblock + status.cap cap.std + cap.no cap.yes} + +INTEGERS { longest.label.width multiresult nameptr namesleft number.label numnames } + +INTEGERS { is.use.number.for.article + is.use.paper + is.forced.et.al + max.num.names.before.forced.et.al + num.names.shown.with.forced.et.al + is.use.alt.interword.spacing + is.dash.repeated.names} + + +%%%%%%%%%%%%%%%%%%%%%% +%% STRING VARIABLES %% +%%%%%%%%%%%%%%%%%%%%%% + +STRINGS { bibinfo + longest.label + oldname + s + t + ALTinterwordstretchfactor + name.format.string + name.latex.cmd + name.url.prefix} + + + + +%%%%%%%%%%%%%%%%%%%%%%%%% +%% LOW LEVEL FUNCTIONS %% +%%%%%%%%%%%%%%%%%%%%%%%%% + +FUNCTION {initialize.controls} +{ default.is.use.number.for.article 'is.use.number.for.article := + default.is.use.paper 'is.use.paper := + default.is.forced.et.al 'is.forced.et.al := + default.max.num.names.before.forced.et.al 'max.num.names.before.forced.et.al := + default.num.names.shown.with.forced.et.al 'num.names.shown.with.forced.et.al := + default.is.use.alt.interword.spacing 'is.use.alt.interword.spacing := + default.is.dash.repeated.names 'is.dash.repeated.names := + default.ALTinterwordstretchfactor 'ALTinterwordstretchfactor := + default.name.format.string 'name.format.string := + default.name.latex.cmd 'name.latex.cmd := + default.name.url.prefix 'name.url.prefix := +} + + +% This IEEEtran.bst features a very powerful and flexible mechanism for +% controlling the capitalization, punctuation, spacing, quotation, and +% newlines of the formatted entry fields. (Note: IEEEtran.bst does not need +% or use the newline/newblock feature, but it has been implemented for +% possible future use.) The output states of IEEEtran.bst consist of +% multiple independent attributes and, as such, can be thought of as being +% vectors, rather than the simple scalar values ("before.all", +% "mid.sentence", etc.) used in most other .bst files. +% +% The more flexible and complex design used here was motivated in part by +% IEEE's rather unusual bibliography style. For example, IEEE ends the +% previous field item with a period and large space prior to the publisher +% address; the @electronic entry types use periods as inter-item punctuation +% rather than the commas used by the other entry types; and URLs are never +% followed by periods even though they are the last item in the entry. +% Although it is possible to accommodate these features with the conventional +% output state system, the seemingly endless exceptions make for convoluted, +% unreliable and difficult to maintain code. +% +% IEEEtran.bst's output state system can be easily understood via a simple +% illustration of two most recently formatted entry fields (on the stack): +% +% CURRENT_ITEM +% "PREVIOUS_ITEM +% +% which, in this example, is to eventually appear in the bibliography as: +% +% "PREVIOUS_ITEM," CURRENT_ITEM +% +% It is the job of the output routine to take the previous item off of the +% stack (while leaving the current item at the top of the stack), apply its +% trailing punctuation (including closing quote marks) and spacing, and then +% to write the result to BibTeX's output buffer: +% +% "PREVIOUS_ITEM," +% +% Punctuation (and spacing) between items is often determined by both of the +% items rather than just the first one. The presence of quotation marks +% further complicates the situation because, in standard English, trailing +% punctuation marks are supposed to be contained within the quotes. +% +% IEEEtran.bst maintains two output state (aka "status") vectors which +% correspond to the previous and current (aka "this") items. Each vector +% consists of several independent attributes which track punctuation, +% spacing, quotation, and newlines. Capitalization status is handled by a +% separate scalar because the format routines, not the output routine, +% handle capitalization and, therefore, there is no need to maintain the +% capitalization attribute for both the "previous" and "this" items. +% +% When a format routine adds a new item, it copies the current output status +% vector to the previous output status vector and (usually) resets the +% current (this) output status vector to a "standard status" vector. Using a +% "standard status" vector in this way allows us to redefine what we mean by +% "standard status" at the start of each entry handler and reuse the same +% format routines under the various inter-item separation schemes. For +% example, the standard status vector for the @book entry type may use +% commas for item separators, while the @electronic type may use periods, +% yet both entry handlers exploit many of the exact same format routines. +% +% Because format routines have write access to the output status vector of +% the previous item, they can override the punctuation choices of the +% previous format routine! Therefore, it becomes trivial to implement rules +% such as "Always use a period and a large space before the publisher." By +% pushing the generation of the closing quote mark to the output routine, we +% avoid all the problems caused by having to close a quote before having all +% the information required to determine what the punctuation should be. +% +% The IEEEtran.bst output state system can easily be expanded if needed. +% For instance, it is easy to add a "space.tie" attribute value if the +% bibliography rules mandate that two items have to be joined with an +% unbreakable space. + +FUNCTION {initialize.status.constants} +{ #0 'punct.no := + #1 'punct.comma := + #2 'punct.period := + #0 'space.no := + #1 'space.normal := + #2 'space.large := + #0 'quote.no := + #1 'quote.close := + #0 'cap.no := + #1 'cap.yes := + #0 'nline.no := + #1 'nline.newblock := +} + +FUNCTION {std.status.using.comma} +{ punct.comma 'punct.std := + space.normal 'space.std := + quote.no 'quote.std := + nline.no 'nline.std := + cap.no 'cap.std := +} + +FUNCTION {std.status.using.period} +{ punct.period 'punct.std := + space.normal 'space.std := + quote.no 'quote.std := + nline.no 'nline.std := + cap.yes 'cap.std := +} + +FUNCTION {initialize.prev.this.status} +{ punct.no 'prev.status.punct := + space.no 'prev.status.space := + quote.no 'prev.status.quote := + nline.no 'prev.status.nline := + punct.no 'this.status.punct := + space.no 'this.status.space := + quote.no 'this.status.quote := + nline.no 'this.status.nline := + cap.yes 'status.cap := +} + +FUNCTION {this.status.std} +{ punct.std 'this.status.punct := + space.std 'this.status.space := + quote.std 'this.status.quote := + nline.std 'this.status.nline := +} + +FUNCTION {cap.status.std}{ cap.std 'status.cap := } + +FUNCTION {this.to.prev.status} +{ this.status.punct 'prev.status.punct := + this.status.space 'prev.status.space := + this.status.quote 'prev.status.quote := + this.status.nline 'prev.status.nline := +} + + +FUNCTION {not} +{ { #0 } + { #1 } + if$ +} + +FUNCTION {and} +{ { skip$ } + { pop$ #0 } + if$ +} + +FUNCTION {or} +{ { pop$ #1 } + { skip$ } + if$ +} + + +% convert the strings "yes" or "no" to #1 or #0 respectively +FUNCTION {yes.no.to.int} +{ "l" change.case$ duplicate$ + "yes" = + { pop$ #1 } + { duplicate$ "no" = + { pop$ #0 } + { "unknown boolean " quote$ * swap$ * quote$ * + " in " * cite$ * warning$ + #0 + } + if$ + } + if$ +} + + +% pushes true if the single char string on the stack is in the +% range of "0" to "9" +FUNCTION {is.num} +{ chr.to.int$ + duplicate$ "0" chr.to.int$ < not + swap$ "9" chr.to.int$ > not and +} + +% multiplies the integer on the stack by a factor of 10 +FUNCTION {bump.int.mag} +{ #0 'multiresult := + { duplicate$ #0 > } + { #1 - + multiresult #10 + + 'multiresult := + } + while$ +pop$ +multiresult +} + +% converts a single character string on the stack to an integer +FUNCTION {char.to.integer} +{ duplicate$ + is.num + { chr.to.int$ "0" chr.to.int$ - } + {"noninteger character " quote$ * swap$ * quote$ * + " in integer field of " * cite$ * warning$ + #0 + } + if$ +} + +% converts a string on the stack to an integer +FUNCTION {string.to.integer} +{ duplicate$ text.length$ 'namesleft := + #1 'nameptr := + #0 'numnames := + { nameptr namesleft > not } + { duplicate$ nameptr #1 substring$ + char.to.integer numnames bump.int.mag + + 'numnames := + nameptr #1 + + 'nameptr := + } + while$ +pop$ +numnames +} + + + + +% The output routines write out the *next* to the top (previous) item on the +% stack, adding punctuation and such as needed. Since IEEEtran.bst maintains +% the output status for the top two items on the stack, these output +% routines have to consider the previous output status (which corresponds to +% the item that is being output). Full independent control of punctuation, +% closing quote marks, spacing, and newblock is provided. +% +% "output.nonnull" does not check for the presence of a previous empty +% item. +% +% "output" does check for the presence of a previous empty item and will +% remove an empty item rather than outputing it. +% +% "output.warn" is like "output", but will issue a warning if it detects +% an empty item. + +FUNCTION {output.nonnull} +{ swap$ + prev.status.punct punct.comma = + { "," * } + { skip$ } + if$ + prev.status.punct punct.period = + { add.period$ } + { skip$ } + if$ + prev.status.quote quote.close = + { "''" * } + { skip$ } + if$ + prev.status.space space.normal = + { " " * } + { skip$ } + if$ + prev.status.space space.large = + { large.space * } + { skip$ } + if$ + write$ + prev.status.nline nline.newblock = + { newline$ "\newblock " write$ } + { skip$ } + if$ +} + +FUNCTION {output} +{ duplicate$ empty$ + 'pop$ + 'output.nonnull + if$ +} + +FUNCTION {output.warn} +{ 't := + duplicate$ empty$ + { pop$ "empty " t * " in " * cite$ * warning$ } + 'output.nonnull + if$ +} + +% "fin.entry" is the output routine that handles the last item of the entry +% (which will be on the top of the stack when "fin.entry" is called). + +FUNCTION {fin.entry} +{ this.status.punct punct.no = + { skip$ } + { add.period$ } + if$ + this.status.quote quote.close = + { "''" * } + { skip$ } + if$ +write$ +newline$ +} + + +FUNCTION {is.last.char.not.punct} +{ duplicate$ + "}" * add.period$ + #-1 #1 substring$ "." = +} + +FUNCTION {is.multiple.pages} +{ 't := + #0 'multiresult := + { multiresult not + t empty$ not + and + } + { t #1 #1 substring$ + duplicate$ "-" = + swap$ duplicate$ "," = + swap$ "+" = + or or + { #1 'multiresult := } + { t #2 global.max$ substring$ 't := } + if$ + } + while$ + multiresult +} + +FUNCTION {capitalize}{ "u" change.case$ "t" change.case$ } + +FUNCTION {emphasize} +{ duplicate$ empty$ + { pop$ "" } + { "\emph{" swap$ * "}" * } + if$ +} + +FUNCTION {do.name.latex.cmd} +{ name.latex.cmd + empty$ + { skip$ } + { name.latex.cmd "{" * swap$ * "}" * } + if$ +} + +% IEEEtran.bst uses its own \BIBforeignlanguage command which directly +% invokes the TeX hyphenation patterns without the need of the Babel +% package. Babel does a lot more than switch hyphenation patterns and +% its loading can cause unintended effects in many class files (such as +% IEEEtran.cls). +FUNCTION {select.language} +{ duplicate$ empty$ 'pop$ + { language empty$ 'skip$ + { "\BIBforeignlanguage{" language * "}{" * swap$ * "}" * } + if$ + } + if$ +} + +FUNCTION {tie.or.space.prefix} +{ duplicate$ text.length$ #3 < + { "~" } + { " " } + if$ + swap$ +} + +FUNCTION {get.bbl.editor} +{ editor num.names$ #1 > 'bbl.editors 'bbl.editor if$ } + +FUNCTION {space.word}{ " " swap$ * " " * } + + +% Field Conditioners, Converters, Checkers and External Interfaces + +FUNCTION {empty.field.to.null.string} +{ duplicate$ empty$ + { pop$ "" } + { skip$ } + if$ +} + +FUNCTION {either.or.check} +{ empty$ + { pop$ } + { "can't use both " swap$ * " fields in " * cite$ * warning$ } + if$ +} + +FUNCTION {empty.entry.warn} +{ author empty$ title empty$ howpublished empty$ + month empty$ year empty$ note empty$ url empty$ + and and and and and and + { "all relevant fields are empty in " cite$ * warning$ } + 'skip$ + if$ +} + + +% The bibinfo system provides a way for the electronic parsing/acquisition +% of a bibliography's contents as is done by ReVTeX. For example, a field +% could be entered into the bibliography as: +% \bibinfo{volume}{2} +% Only the "2" would show up in the document, but the LaTeX \bibinfo command +% could do additional things with the information. IEEEtran.bst does provide +% a \bibinfo command via "\providecommand{\bibinfo}[2]{#2}". However, it is +% currently not used as the bogus bibinfo functions defined here output the +% entry values directly without the \bibinfo wrapper. The bibinfo functions +% themselves (and the calls to them) are retained for possible future use. +% +% bibinfo.check avoids acting on missing fields while bibinfo.warn will +% issue a warning message if a missing field is detected. Prior to calling +% the bibinfo functions, the user should push the field value and then its +% name string, in that order. + +FUNCTION {bibinfo.check} +{ swap$ duplicate$ missing$ + { pop$ pop$ "" } + { duplicate$ empty$ + { swap$ pop$ } + { swap$ pop$ } + if$ + } + if$ +} + +FUNCTION {bibinfo.warn} +{ swap$ duplicate$ missing$ + { swap$ "missing " swap$ * " in " * cite$ * warning$ pop$ "" } + { duplicate$ empty$ + { swap$ "empty " swap$ * " in " * cite$ * warning$ } + { swap$ pop$ } + if$ + } + if$ +} + + +% IEEE separates large numbers with more than 4 digits into groups of +% three. IEEE uses a small space to separate these number groups. +% Typical applications include patent and page numbers. + +% number of consecutive digits required to trigger the group separation. +FUNCTION {large.number.trigger}{ #5 } + +% For numbers longer than the trigger, this is the blocksize of the groups. +% The blocksize must be less than the trigger threshold, and 2 * blocksize +% must be greater than the trigger threshold (can't do more than one +% separation on the initial trigger). +FUNCTION {large.number.blocksize}{ #3 } + +% What is actually inserted between the number groups. +FUNCTION {large.number.separator}{ "\," } + +% So as to save on integer variables by reusing existing ones, numnames +% holds the current number of consecutive digits read and nameptr holds +% the number that will trigger an inserted space. +FUNCTION {large.number.separate} +{ 't := + "" + #0 'numnames := + large.number.trigger 'nameptr := + { t empty$ not } + { t #-1 #1 substring$ is.num + { numnames #1 + 'numnames := } + { #0 'numnames := + large.number.trigger 'nameptr := + } + if$ + t #-1 #1 substring$ swap$ * + t #-2 global.max$ substring$ 't := + numnames nameptr = + { duplicate$ #1 nameptr large.number.blocksize - substring$ swap$ + nameptr large.number.blocksize - #1 + global.max$ substring$ + large.number.separator swap$ * * + nameptr large.number.blocksize - 'numnames := + large.number.blocksize #1 + 'nameptr := + } + { skip$ } + if$ + } + while$ +} + +% Converts all single dashes "-" to double dashes "--". +FUNCTION {n.dashify} +{ large.number.separate + 't := + "" + { t empty$ not } + { t #1 #1 substring$ "-" = + { t #1 #2 substring$ "--" = not + { "--" * + t #2 global.max$ substring$ 't := + } + { { t #1 #1 substring$ "-" = } + { "-" * + t #2 global.max$ substring$ 't := + } + while$ + } + if$ + } + { t #1 #1 substring$ * + t #2 global.max$ substring$ 't := + } + if$ + } + while$ +} + + +% This function detects entries with names that are identical to that of +% the previous entry and replaces the repeated names with dashes (if the +% "is.dash.repeated.names" user control is nonzero). +FUNCTION {name.or.dash} +{ 's := + oldname empty$ + { s 'oldname := s } + { s oldname = + { is.dash.repeated.names + { repeated.name.dashes } + { s 'oldname := s } + if$ + } + { s 'oldname := s } + if$ + } + if$ +} + +% Converts the number string on the top of the stack to +% "numerical ordinal form" (e.g., "7" to "7th"). There is +% no artificial limit to the upper bound of the numbers as the +% least significant digit always determines the ordinal form. +FUNCTION {num.to.ordinal} +{ duplicate$ #-1 #1 substring$ "1" = + { bbl.st * } + { duplicate$ #-1 #1 substring$ "2" = + { bbl.nd * } + { duplicate$ #-1 #1 substring$ "3" = + { bbl.rd * } + { bbl.th * } + if$ + } + if$ + } + if$ +} + +% If the string on the top of the stack begins with a number, +% (e.g., 11th) then replace the string with the leading number +% it contains. Otherwise retain the string as-is. s holds the +% extracted number, t holds the part of the string that remains +% to be scanned. +FUNCTION {extract.num} +{ duplicate$ 't := + "" 's := + { t empty$ not } + { t #1 #1 substring$ + t #2 global.max$ substring$ 't := + duplicate$ is.num + { s swap$ * 's := } + { pop$ "" 't := } + if$ + } + while$ + s empty$ + 'skip$ + { pop$ s } + if$ +} + +% Converts the word number string on the top of the stack to +% Arabic string form. Will be successful up to "tenth". +FUNCTION {word.to.num} +{ duplicate$ "l" change.case$ 's := + s "first" = + { pop$ "1" } + { skip$ } + if$ + s "second" = + { pop$ "2" } + { skip$ } + if$ + s "third" = + { pop$ "3" } + { skip$ } + if$ + s "fourth" = + { pop$ "4" } + { skip$ } + if$ + s "fifth" = + { pop$ "5" } + { skip$ } + if$ + s "sixth" = + { pop$ "6" } + { skip$ } + if$ + s "seventh" = + { pop$ "7" } + { skip$ } + if$ + s "eighth" = + { pop$ "8" } + { skip$ } + if$ + s "ninth" = + { pop$ "9" } + { skip$ } + if$ + s "tenth" = + { pop$ "10" } + { skip$ } + if$ +} + + +% Converts the string on the top of the stack to numerical +% ordinal (e.g., "11th") form. +FUNCTION {convert.edition} +{ duplicate$ empty$ 'skip$ + { duplicate$ #1 #1 substring$ is.num + { extract.num + num.to.ordinal + } + { word.to.num + duplicate$ #1 #1 substring$ is.num + { num.to.ordinal } + { "edition ordinal word " quote$ * edition * quote$ * + " may be too high (or improper) for conversion" * " in " * cite$ * warning$ + } + if$ + } + if$ + } + if$ +} + + + + +%%%%%%%%%%%%%%%%%%%%%%%%%%%%% +%% LATEX BIBLIOGRAPHY CODE %% +%%%%%%%%%%%%%%%%%%%%%%%%%%%%% + +FUNCTION {start.entry} +{ newline$ + "\bibitem{" write$ + cite$ write$ + "}" write$ + newline$ + "" + initialize.prev.this.status +} + +% Here we write out all the LaTeX code that we will need. The most involved +% code sequences are those that control the alternate interword spacing and +% foreign language hyphenation patterns. The heavy use of \providecommand +% gives users a way to override the defaults. Special thanks to Javier Bezos, +% Johannes Braams, Robin Fairbairns, Heiko Oberdiek, Donald Arseneau and all +% the other gurus on comp.text.tex for their help and advice on the topic of +% \selectlanguage, Babel and BibTeX. +FUNCTION {begin.bib} +{ "% Generated by IEEEtran.bst, version: " bst.file.version * " (" * bst.file.date * ")" * + write$ newline$ + preamble$ empty$ 'skip$ + { preamble$ write$ newline$ } + if$ + "\begin{thebibliography}{" longest.label * "}" * + write$ newline$ + "\providecommand{\url}[1]{#1}" + write$ newline$ + "\csname url@samestyle\endcsname" + write$ newline$ + "\providecommand{\newblock}{\relax}" + write$ newline$ + "\providecommand{\bibinfo}[2]{#2}" + write$ newline$ + "\providecommand{\BIBentrySTDinterwordspacing}{\spaceskip=0pt\relax}" + write$ newline$ + "\providecommand{\BIBentryALTinterwordstretchfactor}{" + ALTinterwordstretchfactor * "}" * + write$ newline$ + "\providecommand{\BIBentryALTinterwordspacing}{\spaceskip=\fontdimen2\font plus " + write$ newline$ + "\BIBentryALTinterwordstretchfactor\fontdimen3\font minus \fontdimen4\font\relax}" + write$ newline$ + "\providecommand{\BIBforeignlanguage}[2]{{%" + write$ newline$ + "\expandafter\ifx\csname l@#1\endcsname\relax" + write$ newline$ + "\typeout{** WARNING: IEEEtran.bst: No hyphenation pattern has been}%" + write$ newline$ + "\typeout{** loaded for the language `#1'. Using the pattern for}%" + write$ newline$ + "\typeout{** the default language instead.}%" + write$ newline$ + "\else" + write$ newline$ + "\language=\csname l@#1\endcsname" + write$ newline$ + "\fi" + write$ newline$ + "#2}}" + write$ newline$ + "\providecommand{\BIBdecl}{\relax}" + write$ newline$ + "\BIBdecl" + write$ newline$ +} + +FUNCTION {end.bib} +{ newline$ "\end{thebibliography}" write$ newline$ } + +FUNCTION {if.url.alt.interword.spacing} +{ is.use.alt.interword.spacing + {url empty$ 'skip$ {"\BIBentryALTinterwordspacing" write$ newline$} if$} + { skip$ } + if$ +} + +FUNCTION {if.url.std.interword.spacing} +{ is.use.alt.interword.spacing + {url empty$ 'skip$ {"\BIBentrySTDinterwordspacing" write$ newline$} if$} + { skip$ } + if$ +} + + + + +%%%%%%%%%%%%%%%%%%%%%%%% +%% LONGEST LABEL PASS %% +%%%%%%%%%%%%%%%%%%%%%%%% + +FUNCTION {initialize.longest.label} +{ "" 'longest.label := + #1 'number.label := + #0 'longest.label.width := +} + +FUNCTION {longest.label.pass} +{ type$ "ieeetranbstctl" = + { skip$ } + { number.label int.to.str$ 'label := + number.label #1 + 'number.label := + label width$ longest.label.width > + { label 'longest.label := + label width$ 'longest.label.width := + } + { skip$ } + if$ + } + if$ +} + + + + +%%%%%%%%%%%%%%%%%%%%% +%% FORMAT HANDLERS %% +%%%%%%%%%%%%%%%%%%%%% + +%% Lower Level Formats (used by higher level formats) + +FUNCTION {format.address.org.or.pub.date} +{ 't := + "" + year empty$ + { "empty year in " cite$ * warning$ } + { skip$ } + if$ + address empty$ t empty$ and + year empty$ and month empty$ and + { skip$ } + { this.to.prev.status + this.status.std + cap.status.std + address "address" bibinfo.check * + t empty$ + { skip$ } + { punct.period 'prev.status.punct := + space.large 'prev.status.space := + address empty$ + { skip$ } + { ": " * } + if$ + t * + } + if$ + year empty$ month empty$ and + { skip$ } + { t empty$ address empty$ and + { skip$ } + { ", " * } + if$ + month empty$ + { year empty$ + { skip$ } + { year "year" bibinfo.check * } + if$ + } + { month "month" bibinfo.check * + year empty$ + { skip$ } + { " " * year "year" bibinfo.check * } + if$ + } + if$ + } + if$ + } + if$ +} + + +FUNCTION {format.names} +{ 'bibinfo := + duplicate$ empty$ 'skip$ { + this.to.prev.status + this.status.std + 's := + "" 't := + #1 'nameptr := + s num.names$ 'numnames := + numnames 'namesleft := + { namesleft #0 > } + { s nameptr + name.format.string + format.name$ + bibinfo bibinfo.check + 't := + nameptr #1 > + { nameptr num.names.shown.with.forced.et.al #1 + = + numnames max.num.names.before.forced.et.al > + is.forced.et.al and and + { "others" 't := + #1 'namesleft := + } + { skip$ } + if$ + namesleft #1 > + { ", " * t do.name.latex.cmd * } + { s nameptr "{ll}" format.name$ duplicate$ "others" = + { 't := } + { pop$ } + if$ + t "others" = + { " " * bbl.etal emphasize * } + { numnames #2 > + { "," * } + { skip$ } + if$ + bbl.and + space.word * t do.name.latex.cmd * + } + if$ + } + if$ + } + { t do.name.latex.cmd } + if$ + nameptr #1 + 'nameptr := + namesleft #1 - 'namesleft := + } + while$ + cap.status.std + } if$ +} + + + + +%% Higher Level Formats + +%% addresses/locations + +FUNCTION {format.address} +{ address duplicate$ empty$ 'skip$ + { this.to.prev.status + this.status.std + cap.status.std + } + if$ +} + + + +%% author/editor names + +FUNCTION {format.authors}{ author "author" format.names } + +FUNCTION {format.editors} +{ editor "editor" format.names duplicate$ empty$ 'skip$ + { ", " * + get.bbl.editor + capitalize + * + } + if$ +} + + + +%% date + +FUNCTION {format.date} +{ + month "month" bibinfo.check duplicate$ empty$ + year "year" bibinfo.check duplicate$ empty$ + { swap$ 'skip$ + { this.to.prev.status + this.status.std + cap.status.std + "there's a month but no year in " cite$ * warning$ } + if$ + * + } + { this.to.prev.status + this.status.std + cap.status.std + swap$ 'skip$ + { + swap$ + " " * swap$ + } + if$ + * + } + if$ +} + +FUNCTION {format.date.electronic} +{ month "month" bibinfo.check duplicate$ empty$ + year "year" bibinfo.check duplicate$ empty$ + { swap$ + { pop$ } + { "there's a month but no year in " cite$ * warning$ + pop$ ")" * "(" swap$ * + this.to.prev.status + punct.no 'this.status.punct := + space.normal 'this.status.space := + quote.no 'this.status.quote := + cap.yes 'status.cap := + } + if$ + } + { swap$ + { swap$ pop$ ")" * "(" swap$ * } + { "(" swap$ * ", " * swap$ * ")" * } + if$ + this.to.prev.status + punct.no 'this.status.punct := + space.normal 'this.status.space := + quote.no 'this.status.quote := + cap.yes 'status.cap := + } + if$ +} + + + +%% edition/title + +% Note: IEEE considers the edition to be closely associated with +% the title of a book. So, in IEEEtran.bst the edition is normally handled +% within the formatting of the title. The format.edition function is +% retained here for possible future use. +FUNCTION {format.edition} +{ edition duplicate$ empty$ 'skip$ + { this.to.prev.status + this.status.std + convert.edition + status.cap + { "t" } + { "l" } + if$ change.case$ + "edition" bibinfo.check + "~" * bbl.edition * + cap.status.std + } + if$ +} + +% This is used to format the booktitle of a conference proceedings. +% Here we use the "intype" field to provide the user a way to +% override the word "in" (e.g., with things like "presented at") +% Use of intype stops the emphasis of the booktitle to indicate that +% we no longer mean the written conference proceedings, but the +% conference itself. +FUNCTION {format.in.booktitle} +{ booktitle "booktitle" bibinfo.check duplicate$ empty$ 'skip$ + { this.to.prev.status + this.status.std + select.language + intype missing$ + { emphasize + bbl.in " " * + } + { intype " " * } + if$ + swap$ * + cap.status.std + } + if$ +} + +% This is used to format the booktitle of collection. +% Here the "intype" field is not supported, but "edition" is. +FUNCTION {format.in.booktitle.edition} +{ booktitle "booktitle" bibinfo.check duplicate$ empty$ 'skip$ + { this.to.prev.status + this.status.std + select.language + emphasize + edition empty$ 'skip$ + { ", " * + edition + convert.edition + "l" change.case$ + * "~" * bbl.edition * + } + if$ + bbl.in " " * swap$ * + cap.status.std + } + if$ +} + +FUNCTION {format.article.title} +{ title duplicate$ empty$ 'skip$ + { this.to.prev.status + this.status.std + "t" change.case$ + } + if$ + "title" bibinfo.check + duplicate$ empty$ 'skip$ + { quote.close 'this.status.quote := + is.last.char.not.punct + { punct.std 'this.status.punct := } + { punct.no 'this.status.punct := } + if$ + select.language + "``" swap$ * + cap.status.std + } + if$ +} + +FUNCTION {format.article.title.electronic} +{ title duplicate$ empty$ 'skip$ + { this.to.prev.status + this.status.std + cap.status.std + "t" change.case$ + } + if$ + "title" bibinfo.check + duplicate$ empty$ + { skip$ } + { select.language } + if$ +} + +FUNCTION {format.book.title.edition} +{ title "title" bibinfo.check + duplicate$ empty$ + { "empty title in " cite$ * warning$ } + { this.to.prev.status + this.status.std + select.language + emphasize + edition empty$ 'skip$ + { ", " * + edition + convert.edition + status.cap + { "t" } + { "l" } + if$ + change.case$ + * "~" * bbl.edition * + } + if$ + cap.status.std + } + if$ +} + +FUNCTION {format.book.title} +{ title "title" bibinfo.check + duplicate$ empty$ 'skip$ + { this.to.prev.status + this.status.std + cap.status.std + select.language + emphasize + } + if$ +} + + + +%% journal + +FUNCTION {format.journal} +{ journal duplicate$ empty$ 'skip$ + { this.to.prev.status + this.status.std + cap.status.std + select.language + emphasize + } + if$ +} + + + +%% how published + +FUNCTION {format.howpublished} +{ howpublished duplicate$ empty$ 'skip$ + { this.to.prev.status + this.status.std + cap.status.std + } + if$ +} + + + +%% institutions/organization/publishers/school + +FUNCTION {format.institution} +{ institution duplicate$ empty$ 'skip$ + { this.to.prev.status + this.status.std + cap.status.std + } + if$ +} + +FUNCTION {format.organization} +{ organization duplicate$ empty$ 'skip$ + { this.to.prev.status + this.status.std + cap.status.std + } + if$ +} + +FUNCTION {format.address.publisher.date} +{ publisher "publisher" bibinfo.warn format.address.org.or.pub.date } + +FUNCTION {format.address.publisher.date.nowarn} +{ publisher "publisher" bibinfo.check format.address.org.or.pub.date } + +FUNCTION {format.address.organization.date} +{ organization "organization" bibinfo.check format.address.org.or.pub.date } + +FUNCTION {format.school} +{ school duplicate$ empty$ 'skip$ + { this.to.prev.status + this.status.std + cap.status.std + } + if$ +} + + + +%% volume/number/series/chapter/pages + +FUNCTION {format.volume} +{ volume empty.field.to.null.string + duplicate$ empty$ 'skip$ + { this.to.prev.status + this.status.std + bbl.volume + status.cap + { capitalize } + { skip$ } + if$ + swap$ tie.or.space.prefix + "volume" bibinfo.check + * * + cap.status.std + } + if$ +} + +FUNCTION {format.number} +{ number empty.field.to.null.string + duplicate$ empty$ 'skip$ + { this.to.prev.status + this.status.std + status.cap + { bbl.number capitalize } + { bbl.number } + if$ + swap$ tie.or.space.prefix + "number" bibinfo.check + * * + cap.status.std + } + if$ +} + +FUNCTION {format.number.if.use.for.article} +{ is.use.number.for.article + { format.number } + { "" } + if$ +} + +% IEEE does not seem to tie the series so closely with the volume +% and number as is done in other bibliography styles. Instead the +% series is treated somewhat like an extension of the title. +FUNCTION {format.series} +{ series empty$ + { "" } + { this.to.prev.status + this.status.std + bbl.series " " * + series "series" bibinfo.check * + cap.status.std + } + if$ +} + + +FUNCTION {format.chapter} +{ chapter empty$ + { "" } + { this.to.prev.status + this.status.std + type empty$ + { bbl.chapter } + { type "l" change.case$ + "type" bibinfo.check + } + if$ + chapter tie.or.space.prefix + "chapter" bibinfo.check + * * + cap.status.std + } + if$ +} + + +% The intended use of format.paper is for paper numbers of inproceedings. +% The paper type can be overridden via the type field. +% We allow the type to be displayed even if the paper number is absent +% for things like "postdeadline paper" +FUNCTION {format.paper} +{ is.use.paper + { paper empty$ + { type empty$ + { "" } + { this.to.prev.status + this.status.std + type "type" bibinfo.check + cap.status.std + } + if$ + } + { this.to.prev.status + this.status.std + type empty$ + { bbl.paper } + { type "type" bibinfo.check } + if$ + " " * paper + "paper" bibinfo.check + * + cap.status.std + } + if$ + } + { "" } + if$ +} + + +FUNCTION {format.pages} +{ pages duplicate$ empty$ 'skip$ + { this.to.prev.status + this.status.std + duplicate$ is.multiple.pages + { + bbl.pages swap$ + n.dashify + } + { + bbl.page swap$ + } + if$ + tie.or.space.prefix + "pages" bibinfo.check + * * + cap.status.std + } + if$ +} + + + +%% technical report number + +FUNCTION {format.tech.report.number} +{ number "number" bibinfo.check + this.to.prev.status + this.status.std + cap.status.std + type duplicate$ empty$ + { pop$ + bbl.techrep + } + { skip$ } + if$ + "type" bibinfo.check + swap$ duplicate$ empty$ + { pop$ } + { tie.or.space.prefix * * } + if$ +} + + + +%% note + +FUNCTION {format.note} +{ note empty$ + { "" } + { this.to.prev.status + this.status.std + punct.period 'this.status.punct := + note #1 #1 substring$ + duplicate$ "{" = + { skip$ } + { status.cap + { "u" } + { "l" } + if$ + change.case$ + } + if$ + note #2 global.max$ substring$ * "note" bibinfo.check + cap.yes 'status.cap := + } + if$ +} + + + +%% patent + +FUNCTION {format.patent.date} +{ this.to.prev.status + this.status.std + year empty$ + { monthfiled duplicate$ empty$ + { "monthfiled" bibinfo.check pop$ "" } + { "monthfiled" bibinfo.check } + if$ + dayfiled duplicate$ empty$ + { "dayfiled" bibinfo.check pop$ "" * } + { "dayfiled" bibinfo.check + monthfiled empty$ + { "dayfiled without a monthfiled in " cite$ * warning$ + * + } + { " " swap$ * * } + if$ + } + if$ + yearfiled empty$ + { "no year or yearfiled in " cite$ * warning$ } + { yearfiled "yearfiled" bibinfo.check + swap$ + duplicate$ empty$ + { pop$ } + { ", " * swap$ * } + if$ + } + if$ + } + { month duplicate$ empty$ + { "month" bibinfo.check pop$ "" } + { "month" bibinfo.check } + if$ + day duplicate$ empty$ + { "day" bibinfo.check pop$ "" * } + { "day" bibinfo.check + month empty$ + { "day without a month in " cite$ * warning$ + * + } + { " " swap$ * * } + if$ + } + if$ + year "year" bibinfo.check + swap$ + duplicate$ empty$ + { pop$ } + { ", " * swap$ * } + if$ + } + if$ + cap.status.std +} + +FUNCTION {format.patent.nationality.type.number} +{ this.to.prev.status + this.status.std + nationality duplicate$ empty$ + { "nationality" bibinfo.warn pop$ "" } + { "nationality" bibinfo.check + duplicate$ "l" change.case$ "united states" = + { pop$ bbl.patentUS } + { skip$ } + if$ + " " * + } + if$ + type empty$ + { bbl.patent "type" bibinfo.check } + { type "type" bibinfo.check } + if$ + * + number duplicate$ empty$ + { "number" bibinfo.warn pop$ } + { "number" bibinfo.check + large.number.separate + swap$ " " * swap$ * + } + if$ + cap.status.std +} + + + +%% standard + +FUNCTION {format.organization.institution.standard.type.number} +{ this.to.prev.status + this.status.std + organization duplicate$ empty$ + { pop$ + institution duplicate$ empty$ + { "institution" bibinfo.warn } + { "institution" bibinfo.warn " " * } + if$ + } + { "organization" bibinfo.warn " " * } + if$ + type empty$ + { bbl.standard "type" bibinfo.check } + { type "type" bibinfo.check } + if$ + * + number duplicate$ empty$ + { "number" bibinfo.check pop$ } + { "number" bibinfo.check + large.number.separate + swap$ " " * swap$ * + } + if$ + cap.status.std +} + +FUNCTION {format.revision} +{ revision empty$ + { "" } + { this.to.prev.status + this.status.std + bbl.revision + revision tie.or.space.prefix + "revision" bibinfo.check + * * + cap.status.std + } + if$ +} + + +%% thesis + +FUNCTION {format.master.thesis.type} +{ this.to.prev.status + this.status.std + type empty$ + { + bbl.mthesis + } + { + type "type" bibinfo.check + } + if$ +cap.status.std +} + +FUNCTION {format.phd.thesis.type} +{ this.to.prev.status + this.status.std + type empty$ + { + bbl.phdthesis + } + { + type "type" bibinfo.check + } + if$ +cap.status.std +} + + + +%% URL + +FUNCTION {format.url} +{ url empty$ + { "" } + { this.to.prev.status + this.status.std + cap.yes 'status.cap := + name.url.prefix " " * + "\url{" * url * "}" * + punct.no 'this.status.punct := + punct.period 'prev.status.punct := + space.normal 'this.status.space := + space.normal 'prev.status.space := + quote.no 'this.status.quote := + } + if$ +} + + + + +%%%%%%%%%%%%%%%%%%%% +%% ENTRY HANDLERS %% +%%%%%%%%%%%%%%%%%%%% + + +% Note: In many journals, IEEE (or the authors) tend not to show the number +% for articles, so the display of the number is controlled here by the +% switch "is.use.number.for.article" +FUNCTION {article} +{ std.status.using.comma + start.entry + if.url.alt.interword.spacing + format.authors "author" output.warn + name.or.dash + format.article.title "title" output.warn + format.journal "journal" bibinfo.check "journal" output.warn + format.volume output + format.number.if.use.for.article output + format.pages output + format.date "year" output.warn + format.note output + format.url output + fin.entry + if.url.std.interword.spacing +} + +FUNCTION {book} +{ std.status.using.comma + start.entry + if.url.alt.interword.spacing + author empty$ + { format.editors "author and editor" output.warn } + { format.authors output.nonnull } + if$ + name.or.dash + format.book.title.edition output + format.series output + author empty$ + { skip$ } + { format.editors output } + if$ + format.address.publisher.date output + format.volume output + format.number output + format.note output + format.url output + fin.entry + if.url.std.interword.spacing +} + +FUNCTION {booklet} +{ std.status.using.comma + start.entry + if.url.alt.interword.spacing + format.authors output + name.or.dash + format.article.title "title" output.warn + format.howpublished "howpublished" bibinfo.check output + format.organization "organization" bibinfo.check output + format.address "address" bibinfo.check output + format.date output + format.note output + format.url output + fin.entry + if.url.std.interword.spacing +} + +FUNCTION {electronic} +{ std.status.using.period + start.entry + if.url.alt.interword.spacing + format.authors output + name.or.dash + format.date.electronic output + format.article.title.electronic output + format.howpublished "howpublished" bibinfo.check output + format.organization "organization" bibinfo.check output + format.address "address" bibinfo.check output + format.note output + format.url output + fin.entry + empty.entry.warn + if.url.std.interword.spacing +} + +FUNCTION {inbook} +{ std.status.using.comma + start.entry + if.url.alt.interword.spacing + author empty$ + { format.editors "author and editor" output.warn } + { format.authors output.nonnull } + if$ + name.or.dash + format.book.title.edition output + format.series output + format.address.publisher.date output + format.volume output + format.number output + format.chapter output + format.pages output + format.note output + format.url output + fin.entry + if.url.std.interword.spacing +} + +FUNCTION {incollection} +{ std.status.using.comma + start.entry + if.url.alt.interword.spacing + format.authors "author" output.warn + name.or.dash + format.article.title "title" output.warn + format.in.booktitle.edition "booktitle" output.warn + format.series output + format.editors output + format.address.publisher.date.nowarn output + format.volume output + format.number output + format.chapter output + format.pages output + format.note output + format.url output + fin.entry + if.url.std.interword.spacing +} + +FUNCTION {inproceedings} +{ std.status.using.comma + start.entry + if.url.alt.interword.spacing + format.authors "author" output.warn + name.or.dash + format.article.title "title" output.warn + format.in.booktitle "booktitle" output.warn + format.series output + format.editors output + format.volume output + format.number output + publisher empty$ + { format.address.organization.date output } + { format.organization "organization" bibinfo.check output + format.address.publisher.date output + } + if$ + format.paper output + format.pages output + format.note output + format.url output + fin.entry + if.url.std.interword.spacing +} + +FUNCTION {manual} +{ std.status.using.comma + start.entry + if.url.alt.interword.spacing + format.authors output + name.or.dash + format.book.title.edition "title" output.warn + format.howpublished "howpublished" bibinfo.check output + format.organization "organization" bibinfo.check output + format.address "address" bibinfo.check output + format.date output + format.note output + format.url output + fin.entry + if.url.std.interword.spacing +} + +FUNCTION {mastersthesis} +{ std.status.using.comma + start.entry + if.url.alt.interword.spacing + format.authors "author" output.warn + name.or.dash + format.article.title "title" output.warn + format.master.thesis.type output.nonnull + format.school "school" bibinfo.warn output + format.address "address" bibinfo.check output + format.date "year" output.warn + format.note output + format.url output + fin.entry + if.url.std.interword.spacing +} + +FUNCTION {misc} +{ std.status.using.comma + start.entry + if.url.alt.interword.spacing + format.authors output + name.or.dash + format.article.title output + format.howpublished "howpublished" bibinfo.check output + format.organization "organization" bibinfo.check output + format.address "address" bibinfo.check output + format.pages output + format.date output + format.note output + format.url output + fin.entry + empty.entry.warn + if.url.std.interword.spacing +} + +FUNCTION {patent} +{ std.status.using.comma + start.entry + if.url.alt.interword.spacing + format.authors output + name.or.dash + format.article.title output + format.patent.nationality.type.number output + format.patent.date output + format.note output + format.url output + fin.entry + empty.entry.warn + if.url.std.interword.spacing +} + +FUNCTION {periodical} +{ std.status.using.comma + start.entry + if.url.alt.interword.spacing + format.editors output + name.or.dash + format.book.title "title" output.warn + format.series output + format.volume output + format.number output + format.organization "organization" bibinfo.check output + format.date "year" output.warn + format.note output + format.url output + fin.entry + if.url.std.interword.spacing +} + +FUNCTION {phdthesis} +{ std.status.using.comma + start.entry + if.url.alt.interword.spacing + format.authors "author" output.warn + name.or.dash + format.article.title "title" output.warn + format.phd.thesis.type output.nonnull + format.school "school" bibinfo.warn output + format.address "address" bibinfo.check output + format.date "year" output.warn + format.note output + format.url output + fin.entry + if.url.std.interword.spacing +} + +FUNCTION {proceedings} +{ std.status.using.comma + start.entry + if.url.alt.interword.spacing + format.editors output + name.or.dash + format.book.title "title" output.warn + format.series output + format.volume output + format.number output + publisher empty$ + { format.address.organization.date output } + { format.organization "organization" bibinfo.check output + format.address.publisher.date output + } + if$ + format.note output + format.url output + fin.entry + if.url.std.interword.spacing +} + +FUNCTION {standard} +{ std.status.using.comma + start.entry + if.url.alt.interword.spacing + format.authors output + name.or.dash + format.book.title "title" output.warn + format.howpublished "howpublished" bibinfo.check output + format.organization.institution.standard.type.number output + format.revision output + format.date output + format.note output + format.url output + fin.entry + if.url.std.interword.spacing +} + +FUNCTION {techreport} +{ std.status.using.comma + start.entry + if.url.alt.interword.spacing + format.authors "author" output.warn + name.or.dash + format.article.title "title" output.warn + format.howpublished "howpublished" bibinfo.check output + format.institution "institution" bibinfo.warn output + format.address "address" bibinfo.check output + format.tech.report.number output.nonnull + format.date "year" output.warn + format.note output + format.url output + fin.entry + if.url.std.interword.spacing +} + +FUNCTION {unpublished} +{ std.status.using.comma + start.entry + if.url.alt.interword.spacing + format.authors "author" output.warn + name.or.dash + format.article.title "title" output.warn + format.date output + format.note "note" output.warn + format.url output + fin.entry + if.url.std.interword.spacing +} + + +% The special entry type which provides the user interface to the +% BST controls +FUNCTION {IEEEtranBSTCTL} +{ is.print.banners.to.terminal + { "** IEEEtran BST control entry " quote$ * cite$ * quote$ * " detected." * + top$ + } + { skip$ } + if$ + CTLuse_article_number + empty$ + { skip$ } + { CTLuse_article_number + yes.no.to.int + 'is.use.number.for.article := + } + if$ + CTLuse_paper + empty$ + { skip$ } + { CTLuse_paper + yes.no.to.int + 'is.use.paper := + } + if$ + CTLuse_forced_etal + empty$ + { skip$ } + { CTLuse_forced_etal + yes.no.to.int + 'is.forced.et.al := + } + if$ + CTLmax_names_forced_etal + empty$ + { skip$ } + { CTLmax_names_forced_etal + string.to.integer + 'max.num.names.before.forced.et.al := + } + if$ + CTLnames_show_etal + empty$ + { skip$ } + { CTLnames_show_etal + string.to.integer + 'num.names.shown.with.forced.et.al := + } + if$ + CTLuse_alt_spacing + empty$ + { skip$ } + { CTLuse_alt_spacing + yes.no.to.int + 'is.use.alt.interword.spacing := + } + if$ + CTLalt_stretch_factor + empty$ + { skip$ } + { CTLalt_stretch_factor + 'ALTinterwordstretchfactor := + "\renewcommand{\BIBentryALTinterwordstretchfactor}{" + ALTinterwordstretchfactor * "}" * + write$ newline$ + } + if$ + CTLdash_repeated_names + empty$ + { skip$ } + { CTLdash_repeated_names + yes.no.to.int + 'is.dash.repeated.names := + } + if$ + CTLname_format_string + empty$ + { skip$ } + { CTLname_format_string + 'name.format.string := + } + if$ + CTLname_latex_cmd + empty$ + { skip$ } + { CTLname_latex_cmd + 'name.latex.cmd := + } + if$ + CTLname_url_prefix + missing$ + { skip$ } + { CTLname_url_prefix + 'name.url.prefix := + } + if$ + + + num.names.shown.with.forced.et.al max.num.names.before.forced.et.al > + { "CTLnames_show_etal cannot be greater than CTLmax_names_forced_etal in " cite$ * warning$ + max.num.names.before.forced.et.al 'num.names.shown.with.forced.et.al := + } + { skip$ } + if$ +} + + +%%%%%%%%%%%%%%%%%%% +%% ENTRY ALIASES %% +%%%%%%%%%%%%%%%%%%% +FUNCTION {conference}{inproceedings} +FUNCTION {online}{electronic} +FUNCTION {internet}{electronic} +FUNCTION {webpage}{electronic} +FUNCTION {www}{electronic} +FUNCTION {default.type}{misc} + + + +%%%%%%%%%%%%%%%%%% +%% MAIN PROGRAM %% +%%%%%%%%%%%%%%%%%% + +READ + +EXECUTE {initialize.controls} +EXECUTE {initialize.status.constants} +EXECUTE {banner.message} + +EXECUTE {initialize.longest.label} +ITERATE {longest.label.pass} + +EXECUTE {begin.bib} +ITERATE {call.type$} +EXECUTE {end.bib} + +EXECUTE{completed.message} + + +%% That's all folks, mds. diff --git a/IEEEtran.cls b/IEEEtran.cls new file mode 100644 index 0000000..f3a8b5b --- /dev/null +++ b/IEEEtran.cls @@ -0,0 +1,4733 @@ +%% +%% IEEEtran.cls 2011/11/03 version V1.8 based on +%% IEEEtran.cls 2007/03/05 version V1.7a +%% The changes in V1.8 are made with a single goal in mind: +%% to change the look of the output using the [conference] option +%% and the default font size (10pt) to match the Word template more closely. +%% These changes may well have undesired side effects when other options +%% are in force! +%% +%% +%% This is the official IEEE LaTeX class for authors of the Institute of +%% Electrical and Electronics Engineers (IEEE) Transactions journals and +%% conferences. +%% +%% Support sites: +%% http://www.michaelshell.org/tex/ieeetran/ +%% http://www.ctan.org/tex-archive/macros/latex/contrib/IEEEtran/ +%% and +%% http://www.ieee.org/ +%% +%% Based on the original 1993 IEEEtran.cls, but with many bug fixes +%% and enhancements (from both JVH and MDS) over the 1996/7 version. +%% +%% +%% Contributors: +%% Gerry Murray (1993), Silvano Balemi (1993), +%% Jon Dixon (1996), Peter N"uchter (1996), +%% Juergen von Hagen (2000), and Michael Shell (2001-2007) +%% +%% +%% Copyright (c) 1993-2000 by Gerry Murray, Silvano Balemi, +%% Jon Dixon, Peter N"uchter, +%% Juergen von Hagen +%% and +%% Copyright (c) 2001-2007 by Michael Shell +%% +%% Current maintainer (V1.3 to V1.7): Michael Shell +%% See: +%% http://www.michaelshell.org/ +%% for current contact information. +%% +%% Special thanks to Peter Wilson (CUA) and Donald Arseneau +%% for allowing the inclusion of the \@ifmtarg command +%% from their ifmtarg LaTeX package. +%% +%%************************************************************************* +%% Legal Notice: +%% This code is offered as-is without any warranty either expressed or +%% implied; without even the implied warranty of MERCHANTABILITY or +%% FITNESS FOR A PARTICULAR PURPOSE! +%% User assumes all risk. +%% In no event shall IEEE or any contributor to this code be liable for +%% any damages or losses, including, but not limited to, incidental, +%% consequential, or any other damages, resulting from the use or misuse +%% of any information contained here. +%% +%% All comments are the opinions of their respective authors and are not +%% necessarily endorsed by the IEEE. +%% +%% This work is distributed under the LaTeX Project Public License (LPPL) +%% ( http://www.latex-project.org/ ) version 1.3, and may be freely used, +%% distributed and modified. A copy of the LPPL, version 1.3, is included +%% in the base LaTeX documentation of all distributions of LaTeX released +%% 2003/12/01 or later. +%% Retain all contribution notices and credits. +%% ** Modified files should be clearly indicated as such, including ** +%% ** renaming them and changing author support contact information. ** +%% +%% File list of work: IEEEtran.cls, IEEEtran_HOWTO.pdf, bare_adv.tex, +%% bare_conf.tex, bare_jrnl.tex, bare_jrnl_compsoc.tex +%% +%% Major changes to the user interface should be indicated by an +%% increase in the version numbers. If a version is a beta, it will +%% be indicated with a BETA suffix, i.e., 1.4 BETA. +%% Small changes can be indicated by appending letters to the version +%% such as "IEEEtran_v14a.cls". +%% In all cases, \Providesclass, any \typeout messages to the user, +%% \IEEEtransversionmajor and \IEEEtransversionminor must reflect the +%% correct version information. +%% The changes should also be documented via source comments. +%%************************************************************************* +%% +% +% Available class options +% e.g., \documentclass[10pt,conference]{IEEEtran} +% +% *** choose only one from each category *** +% +% 9pt, 10pt, 11pt, 12pt +% Sets normal font size. The default is 10pt. +% +% conference, journal, technote, peerreview, peerreviewca +% determines format mode - conference papers, journal papers, +% correspondence papers (technotes), or peer review papers. The user +% should also select 9pt when using technote. peerreview is like +% journal mode, but provides for a single-column "cover" title page for +% anonymous peer review. The paper title (without the author names) is +% repeated at the top of the page after the cover page. For peer review +% papers, the \IEEEpeerreviewmaketitle command must be executed (will +% automatically be ignored for non-peerreview modes) at the place the +% cover page is to end, usually just after the abstract (keywords are +% not normally used with peer review papers). peerreviewca is like +% peerreview, but allows the author names to be entered and formatted +% as with conference mode so that author affiliation and contact +% information can be easily seen on the cover page. +% The default is journal. +% +% draft, draftcls, draftclsnofoot, final +% determines if paper is formatted as a widely spaced draft (for +% handwritten editor comments) or as a properly typeset final version. +% draftcls restricts draft mode to the class file while all other LaTeX +% packages (i.e., \usepackage{graphicx}) will behave as final - allows +% for a draft paper with visible figures, etc. draftclsnofoot is like +% draftcls, but does not display the date and the word "DRAFT" at the foot +% of the pages. If using one of the draft modes, the user will probably +% also want to select onecolumn. +% The default is final. +% +% letterpaper, a4paper +% determines paper size: 8.5in X 11in or 210mm X 297mm. CHANGING THE PAPER +% SIZE WILL NOT ALTER THE TYPESETTING OF THE DOCUMENT - ONLY THE MARGINS +% WILL BE AFFECTED. In particular, documents using the a4paper option will +% have reduced side margins (A4 is narrower than US letter) and a longer +% bottom margin (A4 is longer than US letter). For both cases, the top +% margins will be the same and the text will be horizontally centered. +% For final submission to IEEE, authors should use US letter (8.5 X 11in) +% paper. Note that authors should ensure that all post-processing +% (ps, pdf, etc.) uses the same paper specificiation as the .tex document. +% Problems here are by far the number one reason for incorrect margins. +% IEEEtran will automatically set the default paper size under pdflatex +% (without requiring a change to pdftex.cfg), so this issue is more +% important to dvips users. Fix config.ps, config.pdf, or ~/.dvipsrc for +% dvips, or use the dvips -t papersize option instead as needed. See the +% testflow documentation +% http://www.ctan.org/tex-archive/macros/latex/contrib/IEEEtran/testflow +% for more details on dvips paper size configuration. +% The default is letterpaper. +% +% oneside, twoside +% determines if layout follows single sided or two sided (duplex) +% printing. The only notable change is with the headings at the top of +% the pages. +% The default is oneside. +% +% onecolumn, twocolumn +% determines if text is organized into one or two columns per page. One +% column mode is usually used only with draft papers. +% The default is twocolumn. +% +% compsoc +% Use the format of the IEEE Computer Society. +% +% romanappendices +% Use the "Appendix I" convention when numbering appendices. IEEEtran.cls +% now defaults to Alpha "Appendix A" convention - the opposite of what +% v1.6b and earlier did. +% +% captionsoff +% disables the display of the figure/table captions. Some IEEE journals +% request that captions be removed and figures/tables be put on pages +% of their own at the end of an initial paper submission. The endfloat +% package can be used with this class option to achieve this format. +% +% nofonttune +% turns off tuning of the font interword spacing. Maybe useful to those +% not using the standard Times fonts or for those who have already "tuned" +% their fonts. +% The default is to enable IEEEtran to tune font parameters. +% +% +%---------- +% Available CLASSINPUTs provided (all are macros unless otherwise noted): +% \CLASSINPUTbaselinestretch +% \CLASSINPUTinnersidemargin +% \CLASSINPUToutersidemargin +% \CLASSINPUTtoptextmargin +% \CLASSINPUTbottomtextmargin +% +% Available CLASSINFOs provided: +% \ifCLASSINFOpdf (TeX if conditional) +% \CLASSINFOpaperwidth (macro) +% \CLASSINFOpaperheight (macro) +% \CLASSINFOnormalsizebaselineskip (length) +% \CLASSINFOnormalsizeunitybaselineskip (length) +% +% Available CLASSOPTIONs provided: +% all class option flags (TeX if conditionals) unless otherwise noted, +% e.g., \ifCLASSOPTIONcaptionsoff +% point size options provided as a single macro: +% \CLASSOPTIONpt +% which will be defined as 9, 10, 11, or 12 depending on the document's +% normalsize point size. +% also, class option peerreviewca implies the use of class option peerreview +% and classoption draft implies the use of class option draftcls + + + + + +\ProvidesClass{IEEEtran}[2012/11/21 V1.8c by Harald Hanche-Olsen and Anders Christensen] +\typeout{-- Based on V1.7a by Michael Shell} +\typeout{-- See the "IEEEtran_HOWTO" manual for usage information.} +\typeout{-- http://www.michaelshell.org/tex/ieeetran/} +\NeedsTeXFormat{LaTeX2e} + +% IEEEtran.cls version numbers, provided as of V1.3 +% These values serve as a way a .tex file can +% determine if the new features are provided. +% The version number of this IEEEtrans.cls can be obtained from +% these values. i.e., V1.4 +% KEEP THESE AS INTEGERS! i.e., NO {4a} or anything like that- +% (no need to enumerate "a" minor changes here) +\def\IEEEtransversionmajor{1} +\def\IEEEtransversionminor{7} + +% These do nothing, but provide them like in article.cls +\newif\if@restonecol +\newif\if@titlepage + + +% class option conditionals +\newif\ifCLASSOPTIONonecolumn \CLASSOPTIONonecolumnfalse +\newif\ifCLASSOPTIONtwocolumn \CLASSOPTIONtwocolumntrue + +\newif\ifCLASSOPTIONoneside \CLASSOPTIONonesidetrue +\newif\ifCLASSOPTIONtwoside \CLASSOPTIONtwosidefalse + +\newif\ifCLASSOPTIONfinal \CLASSOPTIONfinaltrue +\newif\ifCLASSOPTIONdraft \CLASSOPTIONdraftfalse +\newif\ifCLASSOPTIONdraftcls \CLASSOPTIONdraftclsfalse +\newif\ifCLASSOPTIONdraftclsnofoot \CLASSOPTIONdraftclsnofootfalse + +\newif\ifCLASSOPTIONpeerreview \CLASSOPTIONpeerreviewfalse +\newif\ifCLASSOPTIONpeerreviewca \CLASSOPTIONpeerreviewcafalse + +\newif\ifCLASSOPTIONjournal \CLASSOPTIONjournaltrue +\newif\ifCLASSOPTIONconference \CLASSOPTIONconferencefalse +\newif\ifCLASSOPTIONtechnote \CLASSOPTIONtechnotefalse + +\newif\ifCLASSOPTIONnofonttune \CLASSOPTIONnofonttunefalse + +\newif\ifCLASSOPTIONcaptionsoff \CLASSOPTIONcaptionsofffalse + +\newif\ifCLASSOPTIONcompsoc \CLASSOPTIONcompsocfalse + +\newif\ifCLASSOPTIONromanappendices \CLASSOPTIONromanappendicesfalse + + +% class info conditionals + +% indicates if pdf (via pdflatex) output +\newif\ifCLASSINFOpdf \CLASSINFOpdffalse + + +% V1.6b internal flag to show if using a4paper +\newif\if@IEEEusingAfourpaper \@IEEEusingAfourpaperfalse + + + +% IEEEtran class scratch pad registers +% dimen +\newdimen\@IEEEtrantmpdimenA +\newdimen\@IEEEtrantmpdimenB +% count +\newcount\@IEEEtrantmpcountA +\newcount\@IEEEtrantmpcountB +% token list +\newtoks\@IEEEtrantmptoksA + +% we use \CLASSOPTIONpt so that we can ID the point size (even for 9pt docs) +% as well as LaTeX's \@ptsize to retain some compatability with some +% external packages +\def\@ptsize{0} +% LaTeX does not support 9pt, so we set \@ptsize to 0 - same as that of 10pt +\DeclareOption{9pt}{\def\CLASSOPTIONpt{9}\def\@ptsize{0}} +\DeclareOption{10pt}{\def\CLASSOPTIONpt{10}\def\@ptsize{0}} +\DeclareOption{11pt}{\def\CLASSOPTIONpt{11}\def\@ptsize{1}} +\DeclareOption{12pt}{\def\CLASSOPTIONpt{12}\def\@ptsize{2}} + + + +\DeclareOption{letterpaper}{\setlength{\paperheight}{11in}% + \setlength{\paperwidth}{8.5in}% + \@IEEEusingAfourpaperfalse + \def\CLASSOPTIONpaper{letter}% + \def\CLASSINFOpaperwidth{8.5in}% + \def\CLASSINFOpaperheight{11in}} + + +\DeclareOption{a4paper}{\setlength{\paperheight}{297mm}% + \setlength{\paperwidth}{210mm}% + \@IEEEusingAfourpapertrue + \def\CLASSOPTIONpaper{a4}% + \def\CLASSINFOpaperwidth{210mm}% + \def\CLASSINFOpaperheight{297mm}} + +\DeclareOption{oneside}{\@twosidefalse\@mparswitchfalse + \CLASSOPTIONonesidetrue\CLASSOPTIONtwosidefalse} +\DeclareOption{twoside}{\@twosidetrue\@mparswitchtrue + \CLASSOPTIONtwosidetrue\CLASSOPTIONonesidefalse} + +\DeclareOption{onecolumn}{\CLASSOPTIONonecolumntrue\CLASSOPTIONtwocolumnfalse} +\DeclareOption{twocolumn}{\CLASSOPTIONtwocolumntrue\CLASSOPTIONonecolumnfalse} + +% If the user selects draft, then this class AND any packages +% will go into draft mode. +\DeclareOption{draft}{\CLASSOPTIONdrafttrue\CLASSOPTIONdraftclstrue + \CLASSOPTIONdraftclsnofootfalse} +% draftcls is for a draft mode which will not affect any packages +% used by the document. +\DeclareOption{draftcls}{\CLASSOPTIONdraftfalse\CLASSOPTIONdraftclstrue + \CLASSOPTIONdraftclsnofootfalse} +% draftclsnofoot is like draftcls, but without the footer. +\DeclareOption{draftclsnofoot}{\CLASSOPTIONdraftfalse\CLASSOPTIONdraftclstrue + \CLASSOPTIONdraftclsnofoottrue} +\DeclareOption{final}{\CLASSOPTIONdraftfalse\CLASSOPTIONdraftclsfalse + \CLASSOPTIONdraftclsnofootfalse} + +\DeclareOption{journal}{\CLASSOPTIONpeerreviewfalse\CLASSOPTIONpeerreviewcafalse + \CLASSOPTIONjournaltrue\CLASSOPTIONconferencefalse\CLASSOPTIONtechnotefalse} + +\DeclareOption{conference}{\CLASSOPTIONpeerreviewfalse\CLASSOPTIONpeerreviewcafalse + \CLASSOPTIONjournalfalse\CLASSOPTIONconferencetrue\CLASSOPTIONtechnotefalse} + +\DeclareOption{technote}{\CLASSOPTIONpeerreviewfalse\CLASSOPTIONpeerreviewcafalse + \CLASSOPTIONjournalfalse\CLASSOPTIONconferencefalse\CLASSOPTIONtechnotetrue} + +\DeclareOption{peerreview}{\CLASSOPTIONpeerreviewtrue\CLASSOPTIONpeerreviewcafalse + \CLASSOPTIONjournalfalse\CLASSOPTIONconferencefalse\CLASSOPTIONtechnotefalse} + +\DeclareOption{peerreviewca}{\CLASSOPTIONpeerreviewtrue\CLASSOPTIONpeerreviewcatrue + \CLASSOPTIONjournalfalse\CLASSOPTIONconferencefalse\CLASSOPTIONtechnotefalse} + +\DeclareOption{nofonttune}{\CLASSOPTIONnofonttunetrue} + +\DeclareOption{captionsoff}{\CLASSOPTIONcaptionsofftrue} + +\DeclareOption{compsoc}{\CLASSOPTIONcompsoctrue} + +\DeclareOption{romanappendices}{\CLASSOPTIONromanappendicestrue} + + +% default to US letter paper, 10pt, twocolumn, one sided, final, journal +\ExecuteOptions{letterpaper,10pt,twocolumn,oneside,final,journal} +% overrride these defaults per user requests +\ProcessOptions + + + +% Computer Society conditional execution command +\long\def\@IEEEcompsoconly#1{\relax\ifCLASSOPTIONcompsoc\relax#1\relax\fi\relax} +% inverse +\long\def\@IEEEnotcompsoconly#1{\relax\ifCLASSOPTIONcompsoc\else\relax#1\relax\fi\relax} +% compsoc conference +\long\def\@IEEEcompsocconfonly#1{\relax\ifCLASSOPTIONcompsoc\ifCLASSOPTIONconference\relax#1\relax\fi\fi\relax} +% compsoc not conference +\long\def\@IEEEcompsocnotconfonly#1{\relax\ifCLASSOPTIONcompsoc\ifCLASSOPTIONconference\else\relax#1\relax\fi\fi\relax} + + +% IEEE uses Times Roman font, so we'll default to Times. +% These three commands make up the entire times.sty package. +\renewcommand{\sfdefault}{phv} +\renewcommand{\rmdefault}{ptm} +\renewcommand{\ttdefault}{pcr} + +\@IEEEcompsoconly{\typeout{-- Using IEEE Computer Society mode.}} + +% V1.7 compsoc nonconference papers, use Palatino/Palladio as the main text font, +% not Times Roman. +\@IEEEcompsocnotconfonly{\renewcommand{\rmdefault}{ppl}} + +% enable Times/Palatino main text font +\normalfont\selectfont + + + + + +% V1.7 conference notice message hook +\def\@IEEEconsolenoticeconference{\typeout{}% +\typeout{** Conference Paper **}% +\typeout{Before submitting the final camera ready copy, remember to:}% +\typeout{}% +\typeout{ 1. Manually equalize the lengths of two columns on the last page}% +\typeout{ of your paper;}% +\typeout{}% +\typeout{ 2. Ensure that any PostScript and/or PDF output post-processing}% +\typeout{ uses only Type 1 fonts and that every step in the generation}% +\typeout{ process uses the appropriate paper size.}% +\typeout{}} + + +% we can send console reminder messages to the user here +\AtEndDocument{\ifCLASSOPTIONconference\@IEEEconsolenoticeconference\fi} + + +% warn about the use of single column other than for draft mode +\ifCLASSOPTIONtwocolumn\else% + \ifCLASSOPTIONdraftcls\else% + \typeout{** ATTENTION: Single column mode is not typically used with IEEE publications.}% + \fi% +\fi + + +% V1.7 improved paper size setting code. +% Set pdfpage and dvips paper sizes. Conditional tests are similar to that +% of ifpdf.sty. Retain within {} to ensure tested macros are never altered, +% even if only effect is to set them to \relax. +% if \pdfoutput is undefined or equal to relax, output a dvips special +{\@ifundefined{pdfoutput}{\AtBeginDvi{\special{papersize=\CLASSINFOpaperwidth,\CLASSINFOpaperheight}}}{% +% pdfoutput is defined and not equal to \relax +% check for pdfpageheight existence just in case someone sets pdfoutput +% under non-pdflatex. If exists, set them regardless of value of \pdfoutput. +\@ifundefined{pdfpageheight}{\relax}{\global\pdfpagewidth\paperwidth +\global\pdfpageheight\paperheight}% +% if using \pdfoutput=0 under pdflatex, send dvips papersize special +\ifcase\pdfoutput +\AtBeginDvi{\special{papersize=\CLASSINFOpaperwidth,\CLASSINFOpaperheight}}% +\else +% we are using pdf output, set CLASSINFOpdf flag +\global\CLASSINFOpdftrue +\fi}} + +% let the user know the selected papersize +\typeout{-- Using \CLASSINFOpaperwidth\space x \CLASSINFOpaperheight\space +(\CLASSOPTIONpaper)\space paper.} + +\ifCLASSINFOpdf +\typeout{-- Using PDF output.} +\else +\typeout{-- Using DVI output.} +\fi + + +% The idea hinted here is for LaTeX to generate markleft{} and markright{} +% automatically for you after you enter \author{}, \journal{}, +% \journaldate{}, journalvol{}, \journalnum{}, etc. +% However, there may be some backward compatibility issues here as +% well as some special applications for IEEEtran.cls and special issues +% that may require the flexible \markleft{}, \markright{} and/or \markboth{}. +% We'll leave this as an open future suggestion. +%\newcommand{\journal}[1]{\def\@journal{#1}} +%\def\@journal{} + + + +% pointsize values +% used with ifx to determine the document's normal size +\def\@IEEEptsizenine{9} +\def\@IEEEptsizeten{10} +\def\@IEEEptsizeeleven{11} +\def\@IEEEptsizetwelve{12} + + + +% FONT DEFINITIONS (No sizexx.clo file needed) +% V1.6 revised font sizes, displayskip values and +% revised normalsize baselineskip to reduce underfull vbox problems +% on the 58pc = 696pt = 9.5in text height we want +% normalsize #lines/column baselineskip (aka leading) +% 9pt 63 11.0476pt (truncated down) +% 10pt 58 12pt (exact) +% 11pt 52 13.3846pt (truncated down) +% 12pt 50 13.92pt (exact) +% + +% we need to store the nominal baselineskip for the given font size +% in case baselinestretch ever changes. +% this is a dimen, so it will not hold stretch or shrink +\newdimen\@IEEEnormalsizeunitybaselineskip +\@IEEEnormalsizeunitybaselineskip\baselineskip + +\ifx\CLASSOPTIONpt\@IEEEptsizenine +\typeout{-- This is a 9 point document.} +\def\normalsize{\@setfontsize{\normalsize}{9}{11.0476pt}}% +\setlength{\@IEEEnormalsizeunitybaselineskip}{11.0476pt}% +\normalsize +\abovedisplayskip 1.5ex plus3pt minus1pt% +\belowdisplayskip \abovedisplayskip% +\abovedisplayshortskip 0pt plus3pt% +\belowdisplayshortskip 1.5ex plus3pt minus1pt +\def\small{\@setfontsize{\small}{8.5}{10pt}} +\def\footnotesize{\@setfontsize{\footnotesize}{8}{9pt}} +\def\scriptsize{\@setfontsize{\scriptsize}{7}{8pt}} +\def\tiny{\@setfontsize{\tiny}{5}{6pt}} +% sublargesize is the same as large - 10pt +\def\sublargesize{\@setfontsize{\sublargesize}{10}{12pt}} +\def\large{\@setfontsize{\large}{10}{12pt}} +\def\Large{\@setfontsize{\Large}{12}{14pt}} +\def\LARGE{\@setfontsize{\LARGE}{14}{17pt}} +\def\huge{\@setfontsize{\huge}{17}{20pt}} +\def\Huge{\@setfontsize{\Huge}{20}{24pt}} +\fi + + +% Check if we have selected 10 points +\ifx\CLASSOPTIONpt\@IEEEptsizeten +\typeout{-- This is a 10 point document.} +\def\normalsize{\@setfontsize{\normalsize}{10}{11}}% +\setlength{\@IEEEnormalsizeunitybaselineskip}{11pt}% +\normalsize +\abovedisplayskip 1.5ex plus4pt minus2pt% +\belowdisplayskip \abovedisplayskip% +\abovedisplayshortskip 0pt plus4pt% +\belowdisplayshortskip 1.5ex plus4pt minus2pt +\def\small{\@setfontsize{\small}{9}{10pt}} +\def\footnotesize{\@setfontsize{\footnotesize}{8}{9pt}} +\def\scriptsize{\@setfontsize{\scriptsize}{7}{8pt}} +\def\tiny{\@setfontsize{\tiny}{5}{6pt}} +% sublargesize is a tad smaller than large - 11pt +\def\sublargesize{\@setfontsize{\sublargesize}{11}{13.4pt}} +\def\large{\@setfontsize{\large}{12}{14pt}} +\def\Large{\@setfontsize{\Large}{14}{17pt}} +\def\LARGE{\@setfontsize{\LARGE}{17}{20pt}} +\def\huge{\@setfontsize{\huge}{20}{24pt}} +\def\Huge{\@setfontsize{\Huge}{24}{28pt}} +\fi + + +% Check if we have selected 11 points +\ifx\CLASSOPTIONpt\@IEEEptsizeeleven +\typeout{-- This is an 11 point document.} +\def\normalsize{\@setfontsize{\normalsize}{11}{13.3846pt}}% +\setlength{\@IEEEnormalsizeunitybaselineskip}{13.3846pt}% +\normalsize +\abovedisplayskip 1.5ex plus5pt minus3pt% +\belowdisplayskip \abovedisplayskip% +\abovedisplayshortskip 0pt plus5pt% +\belowdisplayshortskip 1.5ex plus5pt minus3pt +\def\small{\@setfontsize{\small}{10}{12pt}} +\def\footnotesize{\@setfontsize{\footnotesize}{9}{10.5pt}} +\def\scriptsize{\@setfontsize{\scriptsize}{8}{9pt}} +\def\tiny{\@setfontsize{\tiny}{6}{7pt}} +% sublargesize is the same as large - 12pt +\def\sublargesize{\@setfontsize{\sublargesize}{12}{14pt}} +\def\large{\@setfontsize{\large}{12}{14pt}} +\def\Large{\@setfontsize{\Large}{14}{17pt}} +\def\LARGE{\@setfontsize{\LARGE}{17}{20pt}} +\def\huge{\@setfontsize{\huge}{20}{24pt}} +\def\Huge{\@setfontsize{\Huge}{24}{28pt}} +\fi + + +% Check if we have selected 12 points +\ifx\CLASSOPTIONpt\@IEEEptsizetwelve +\typeout{-- This is a 12 point document.} +\def\normalsize{\@setfontsize{\normalsize}{12}{13.92pt}}% +\setlength{\@IEEEnormalsizeunitybaselineskip}{13.92pt}% +\normalsize +\abovedisplayskip 1.5ex plus6pt minus4pt% +\belowdisplayskip \abovedisplayskip% +\abovedisplayshortskip 0pt plus6pt% +\belowdisplayshortskip 1.5ex plus6pt minus4pt +\def\small{\@setfontsize{\small}{10}{12pt}} +\def\footnotesize{\@setfontsize{\footnotesize}{9}{10.5pt}} +\def\scriptsize{\@setfontsize{\scriptsize}{8}{9pt}} +\def\tiny{\@setfontsize{\tiny}{6}{7pt}} +% sublargesize is the same as large - 14pt +\def\sublargesize{\@setfontsize{\sublargesize}{14}{17pt}} +\def\large{\@setfontsize{\large}{14}{17pt}} +\def\Large{\@setfontsize{\Large}{17}{20pt}} +\def\LARGE{\@setfontsize{\LARGE}{20}{24pt}} +\def\huge{\@setfontsize{\huge}{22}{26pt}} +\def\Huge{\@setfontsize{\Huge}{24}{28pt}} +\fi + + +% V1.6 The Computer Modern Fonts will issue a substitution warning for +% 24pt titles (24.88pt is used instead) increase the substitution +% tolerance to turn off this warning +\def\fontsubfuzz{.9pt} +% However, the default (and correct) Times font will scale exactly as needed. + + +% warn the user in case they forget to use the 9pt option with +% technote +\ifCLASSOPTIONtechnote% + \ifx\CLASSOPTIONpt\@IEEEptsizenine\else% + \typeout{** ATTENTION: Technotes are normally 9pt documents.}% + \fi% +\fi + + +% V1.7 +% Improved \textunderscore to provide a much better fake _ when used with +% OT1 encoding. Under OT1, detect use of pcr or cmtt \ttfamily and use +% available true _ glyph for those two typewriter fonts. +\def\@IEEEstringptm{ptm} % Times Roman family +\def\@IEEEstringppl{ppl} % Palatino Roman family +\def\@IEEEstringphv{phv} % Helvetica Sans Serif family +\def\@IEEEstringpcr{pcr} % Courier typewriter family +\def\@IEEEstringcmtt{cmtt} % Computer Modern typewriter family +\DeclareTextCommandDefault{\textunderscore}{\leavevmode +\ifx\f@family\@IEEEstringpcr\string_\else +\ifx\f@family\@IEEEstringcmtt\string_\else +\ifx\f@family\@IEEEstringptm\kern 0em\vbox{\hrule\@width 0.5em\@height 0.5pt\kern -0.3ex}\else +\ifx\f@family\@IEEEstringppl\kern 0em\vbox{\hrule\@width 0.5em\@height 0.5pt\kern -0.3ex}\else +\ifx\f@family\@IEEEstringphv\kern -0.03em\vbox{\hrule\@width 0.62em\@height 0.52pt\kern -0.33ex}\kern -0.03em\else +\kern 0.09em\vbox{\hrule\@width 0.6em\@height 0.44pt\kern -0.63pt\kern -0.42ex}\kern 0.09em\fi\fi\fi\fi\fi\relax} + + + + +% set the default \baselinestretch +\def\baselinestretch{1} +\ifCLASSOPTIONdraftcls + \def\baselinestretch{1.5}% default baselinestretch for draft modes +\fi + + +% process CLASSINPUT baselinestretch +\ifx\CLASSINPUTbaselinestretch\@IEEEundefined +\else + \edef\baselinestretch{\CLASSINPUTbaselinestretch} % user CLASSINPUT override + \typeout{** ATTENTION: Overriding \string\baselinestretch\space to + \baselinestretch\space via \string\CLASSINPUT.} +\fi + +\normalsize % make \baselinestretch take affect + + + + +% store the normalsize baselineskip +\newdimen\CLASSINFOnormalsizebaselineskip +\CLASSINFOnormalsizebaselineskip=\baselineskip\relax +% and the normalsize unity (baselinestretch=1) baselineskip +% we could save a register by giving the user access to +% \@IEEEnormalsizeunitybaselineskip. However, let's protect +% its read only internal status +\newdimen\CLASSINFOnormalsizeunitybaselineskip +\CLASSINFOnormalsizeunitybaselineskip=\@IEEEnormalsizeunitybaselineskip\relax +% store the nominal value of jot +\newdimen\IEEEnormaljot +\IEEEnormaljot=0.25\baselineskip\relax + +% set \jot +\jot=\IEEEnormaljot\relax + + + + +% V1.6, we are now going to fine tune the interword spacing +% The default interword glue for Times under TeX appears to use a +% nominal interword spacing of 25% (relative to the font size, i.e., 1em) +% a maximum of 40% and a minimum of 19%. +% For example, 10pt text uses an interword glue of: +% +% 2.5pt plus 1.49998pt minus 0.59998pt +% +% However, IEEE allows for a more generous range which reduces the need +% for hyphenation, especially for two column text. Furthermore, IEEE +% tends to use a little bit more nominal space between the words. +% IEEE's interword spacing percentages appear to be: +% 35% nominal +% 23% minimum +% 50% maximum +% (They may even be using a tad more for the largest fonts such as 24pt.) +% +% for bold text, IEEE increases the spacing a little more: +% 37.5% nominal +% 23% minimum +% 55% maximum + +% here are the interword spacing ratios we'll use +% for medium (normal weight) +\def\@IEEEinterspaceratioM{0.35} +\def\@IEEEinterspaceMINratioM{0.23} +\def\@IEEEinterspaceMAXratioM{0.50} + +% for bold +\def\@IEEEinterspaceratioB{0.375} +\def\@IEEEinterspaceMINratioB{0.23} +\def\@IEEEinterspaceMAXratioB{0.55} + + +% command to revise the interword spacing for the current font under TeX: +% \fontdimen2 = nominal interword space +% \fontdimen3 = interword stretch +% \fontdimen4 = interword shrink +% since all changes to the \fontdimen are global, we can enclose these commands +% in braces to confine any font attribute or length changes +\def\@@@IEEEsetfontdimens#1#2#3{{% +\setlength{\@IEEEtrantmpdimenB}{\f@size pt}% grab the font size in pt, could use 1em instead. +\setlength{\@IEEEtrantmpdimenA}{#1\@IEEEtrantmpdimenB}% +\fontdimen2\font=\@IEEEtrantmpdimenA\relax +\addtolength{\@IEEEtrantmpdimenA}{-#2\@IEEEtrantmpdimenB}% +\fontdimen3\font=-\@IEEEtrantmpdimenA\relax +\setlength{\@IEEEtrantmpdimenA}{#1\@IEEEtrantmpdimenB}% +\addtolength{\@IEEEtrantmpdimenA}{-#3\@IEEEtrantmpdimenB}% +\fontdimen4\font=\@IEEEtrantmpdimenA\relax}} + +% revise the interword spacing for each font weight +\def\@@IEEEsetfontdimens{{% +\mdseries +\@@@IEEEsetfontdimens{\@IEEEinterspaceratioM}{\@IEEEinterspaceMAXratioM}{\@IEEEinterspaceMINratioM}% +\bfseries +\@@@IEEEsetfontdimens{\@IEEEinterspaceratioB}{\@IEEEinterspaceMAXratioB}{\@IEEEinterspaceMINratioB}% +}} + +% revise the interword spacing for each font shape +% \slshape is not often used for IEEE work and is not altered here. The \scshape caps are +% already a tad too large in the free LaTeX fonts (as compared to what IEEE uses) so we +% won't alter these either. +\def\@IEEEsetfontdimens{{% +\normalfont +\@@IEEEsetfontdimens +\normalfont\itshape +\@@IEEEsetfontdimens +}} + +% command to revise the interword spacing for each font size (and shape +% and weight). Only the \rmfamily is done here as \ttfamily uses a +% fixed spacing and \sffamily is not used as the main text of IEEE papers. +\def\@IEEEtunefonts{{\selectfont\rmfamily +\tiny\@IEEEsetfontdimens +\scriptsize\@IEEEsetfontdimens +\footnotesize\@IEEEsetfontdimens +\small\@IEEEsetfontdimens +\normalsize\@IEEEsetfontdimens +\sublargesize\@IEEEsetfontdimens +\large\@IEEEsetfontdimens +\LARGE\@IEEEsetfontdimens +\huge\@IEEEsetfontdimens +\Huge\@IEEEsetfontdimens}} + +% if the nofonttune class option is not given, revise the interword spacing +% now - in case IEEEtran makes any default length measurements, and make +% sure all the default fonts are loaded +\ifCLASSOPTIONnofonttune\else +\@IEEEtunefonts +\fi + +% and again at the start of the document in case the user loaded different fonts +\AtBeginDocument{\ifCLASSOPTIONnofonttune\else\@IEEEtunefonts\fi} + + + +% V1.6 +% LaTeX is a little to quick to use hyphenations +% So, we increase the penalty for their use and raise +% the badness level that triggers an underfull hbox +% warning. The author may still have to tweak things, +% but the appearance will be much better "right out +% of the box" than that under V1.5 and prior. +% TeX default is 50 +\hyphenpenalty=750 +% If we didn't adjust the interword spacing, 2200 might be better. +% The TeX default is 1000 +\hbadness=1350 +% IEEE does not use extra spacing after punctuation +\frenchspacing + +% V1.7 increase this a tad to discourage equation breaks +\binoppenalty=1000 % default 700 +\relpenalty=800 % default 500 + + +% margin note stuff +\marginparsep 10pt +\marginparwidth 20pt +\marginparpush 25pt + + +% if things get too close, go ahead and let them touch +\lineskip 0pt +\normallineskip 0pt +\lineskiplimit 0pt +\normallineskiplimit 0pt + +% The distance from the lower edge of the text body to the +% footline +\footskip 0.4in + +% normally zero, should be relative to font height. +% put in a little rubber to help stop some bad breaks (underfull vboxes) +\parskip 0ex plus 0.2ex minus 0.1ex +\ifCLASSOPTIONconference +\parskip 6pt plus 2pt minus 1pt +\fi + +\parindent 1.0em +\ifCLASSOPTIONconference +\parindent 14.45pt +\fi + +\topmargin -49.0pt +\headheight 12pt +\headsep 0.25in + +% use the normal font baselineskip +% so that \topskip is unaffected by changes in \baselinestretch +\topskip=\@IEEEnormalsizeunitybaselineskip +\textheight 58pc % 9.63in, 696pt +% Tweak textheight to a perfect integer number of lines/page. +% The normal baselineskip for each document point size is used +% to determine these values. +\ifx\CLASSOPTIONpt\@IEEEptsizenine\textheight=63\@IEEEnormalsizeunitybaselineskip\fi % 63 lines/page +\ifx\CLASSOPTIONpt\@IEEEptsizeten\textheight=58\@IEEEnormalsizeunitybaselineskip\fi % 58 lines/page +\ifx\CLASSOPTIONpt\@IEEEptsizeeleven\textheight=52\@IEEEnormalsizeunitybaselineskip\fi % 52 lines/page +\ifx\CLASSOPTIONpt\@IEEEptsizetwelve\textheight=50\@IEEEnormalsizeunitybaselineskip\fi % 50 lines/page + + +\columnsep 1.5pc +\textwidth 184.2mm + + +% the default side margins are equal +\if@IEEEusingAfourpaper +\oddsidemargin 14.32mm +\evensidemargin 14.32mm +\else +\oddsidemargin 0.680in +\evensidemargin 0.680in +\fi +% compensate for LaTeX's 1in offset +\addtolength{\oddsidemargin}{-1in} +\addtolength{\evensidemargin}{-1in} + + + +% adjust margins for conference mode +\ifCLASSOPTIONconference + \topmargin -0.25in + % we retain the reserved, but unused space for headers + \addtolength{\topmargin}{-\headheight} + \addtolength{\topmargin}{-\headsep} + \textheight 9.25in % The standard for conferences (668.4975pt) + % Tweak textheight to a perfect integer number of lines/page. + \ifx\CLASSOPTIONpt\@IEEEptsizenine\textheight=61\@IEEEnormalsizeunitybaselineskip\fi % 61 lines/page + \ifx\CLASSOPTIONpt\@IEEEptsizeten\textheight=62\@IEEEnormalsizeunitybaselineskip\fi % 62 lines/page + \ifx\CLASSOPTIONpt\@IEEEptsizeeleven\textheight=50\@IEEEnormalsizeunitybaselineskip\fi % 50 lines/page + \ifx\CLASSOPTIONpt\@IEEEptsizetwelve\textheight=48\@IEEEnormalsizeunitybaselineskip\fi % 48 lines/page +\fi + + +% compsoc conference +\ifCLASSOPTIONcompsoc +\ifCLASSOPTIONconference + % compsoc conference use a larger value for columnsep + \columnsep 0.375in + % compsoc conferences want 1in top margin, 1.125in bottom margin + \topmargin 0in + \addtolength{\topmargin}{-6pt}% we tweak this a tad to better comply with top of line stuff + % we retain the reserved, but unused space for headers + \addtolength{\topmargin}{-\headheight} + \addtolength{\topmargin}{-\headsep} + \textheight 8.875in % (641.39625pt) + % Tweak textheight to a perfect integer number of lines/page. + \ifx\CLASSOPTIONpt\@IEEEptsizenine\textheight=58\@IEEEnormalsizeunitybaselineskip\fi % 58 lines/page + \ifx\CLASSOPTIONpt\@IEEEptsizeten\textheight=53\@IEEEnormalsizeunitybaselineskip\fi % 53 lines/page + \ifx\CLASSOPTIONpt\@IEEEptsizeeleven\textheight=48\@IEEEnormalsizeunitybaselineskip\fi % 48 lines/page + \ifx\CLASSOPTIONpt\@IEEEptsizetwelve\textheight=46\@IEEEnormalsizeunitybaselineskip\fi % 46 lines/page + \textwidth 6.5in + % the default side margins are equal + \if@IEEEusingAfourpaper + \oddsidemargin 22.45mm + \evensidemargin 22.45mm + \else + \oddsidemargin 1in + \evensidemargin 1in + \fi + % compensate for LaTeX's 1in offset + \addtolength{\oddsidemargin}{-1in} + \addtolength{\evensidemargin}{-1in} +\fi\fi + + + +% draft mode settings override that of all other modes +% provides a nice 1in margin all around the paper and extra +% space between the lines for editor's comments +\ifCLASSOPTIONdraftcls + % want 1in from top of paper to text + \setlength{\topmargin}{-\headsep}% + \addtolength{\topmargin}{-\headheight}% + % we want 1in side margins regardless of paper type + \oddsidemargin 0in + \evensidemargin 0in + % set the text width + \setlength{\textwidth}{\paperwidth}% + \addtolength{\textwidth}{-2.0in}% + \setlength{\textheight}{\paperheight}% + \addtolength{\textheight}{-2.0in}% + % digitize textheight to be an integer number of lines. + % this may cause the bottom margin to be off a tad + \addtolength{\textheight}{-1\topskip}% + \divide\textheight by \baselineskip% + \multiply\textheight by \baselineskip% + \addtolength{\textheight}{\topskip}% +\fi + + + +% process CLASSINPUT inner/outer margin +% if inner margin defined, but outer margin not, set outer to inner. +\ifx\CLASSINPUTinnersidemargin\@IEEEundefined +\else + \ifx\CLASSINPUToutersidemargin\@IEEEundefined + \edef\CLASSINPUToutersidemargin{\CLASSINPUTinnersidemargin} + \fi +\fi + +\ifx\CLASSINPUToutersidemargin\@IEEEundefined +\else + % if outer margin defined, but inner margin not, set inner to outer. + \ifx\CLASSINPUTinnersidemargin\@IEEEundefined + \edef\CLASSINPUTinnersidemargin{\CLASSINPUToutersidemargin} + \fi + \setlength{\oddsidemargin}{\CLASSINPUTinnersidemargin} + \ifCLASSOPTIONtwoside + \setlength{\evensidemargin}{\CLASSINPUToutersidemargin} + \else + \setlength{\evensidemargin}{\CLASSINPUTinnersidemargin} + \fi + \addtolength{\oddsidemargin}{-1in} + \addtolength{\evensidemargin}{-1in} + \setlength{\textwidth}{\paperwidth} + \addtolength{\textwidth}{-\CLASSINPUTinnersidemargin} + \addtolength{\textwidth}{-\CLASSINPUToutersidemargin} + \typeout{** ATTENTION: Overriding inner side margin to \CLASSINPUTinnersidemargin\space and + outer side margin to \CLASSINPUToutersidemargin\space via \string\CLASSINPUT.} +\fi + + + +% process CLASSINPUT top/bottom text margin +% if toptext margin defined, but bottomtext margin not, set bottomtext to toptext margin +\ifx\CLASSINPUTtoptextmargin\@IEEEundefined +\else + \ifx\CLASSINPUTbottomtextmargin\@IEEEundefined + \edef\CLASSINPUTbottomtextmargin{\CLASSINPUTtoptextmargin} + \fi +\fi + +\ifx\CLASSINPUTbottomtextmargin\@IEEEundefined +\else + % if bottomtext margin defined, but toptext margin not, set toptext to bottomtext margin + \ifx\CLASSINPUTtoptextmargin\@IEEEundefined + \edef\CLASSINPUTtoptextmargin{\CLASSINPUTbottomtextmargin} + \fi + \setlength{\topmargin}{\CLASSINPUTtoptextmargin} + \addtolength{\topmargin}{-1in} + \addtolength{\topmargin}{-\headheight} + \addtolength{\topmargin}{-\headsep} + \setlength{\textheight}{\paperheight} + \addtolength{\textheight}{-\CLASSINPUTtoptextmargin} + \addtolength{\textheight}{-\CLASSINPUTbottomtextmargin} + % in the default format we use the normal baselineskip as topskip + % we only need 0.7 of this to clear typical top text and we need + % an extra 0.3 spacing at the bottom for descenders. This will + % correct for both. + \addtolength{\topmargin}{-0.3\@IEEEnormalsizeunitybaselineskip} + \typeout{** ATTENTION: Overriding top text margin to \CLASSINPUTtoptextmargin\space and + bottom text margin to \CLASSINPUTbottomtextmargin\space via \string\CLASSINPUT.} +\fi + + + + + + + +% LIST SPACING CONTROLS + +% Controls the amount of EXTRA spacing +% above and below \trivlist +% Both \list and IED lists override this. +% However, \trivlist will use this as will most +% things built from \trivlist like the \center +% environment. +\topsep 0.5\baselineskip + +% Controls the additional spacing around lists preceded +% or followed by blank lines. IEEE does not increase +% spacing before or after paragraphs so it is set to zero. +% \z@ is the same as zero, but faster. +\partopsep \z@ + +% Controls the spacing between paragraphs in lists. +% IEEE does not increase spacing before or after paragraphs +% so this is also zero. +% With IEEEtran.cls, global changes to +% this value DO affect lists (but not IED lists). +\parsep \z@ + +% Controls the extra spacing between list items. +% IEEE does not put extra spacing between items. +% With IEEEtran.cls, global changes to this value DO affect +% lists (but not IED lists). +\itemsep \z@ + +% \itemindent is the amount to indent the FIRST line of a list +% item. It is auto set to zero within the \list environment. To alter +% it, you have to do so when you call the \list. +% However, IEEE uses this for the theorem environment +% There is an alternative value for this near \leftmargini below +\itemindent -1em + +% \leftmargin, the spacing from the left margin of the main text to +% the left of the main body of a list item is set by \list. +% Hence this statement does nothing for lists. +% But, quote and verse do use it for indention. +\leftmargin 2em + +% we retain this stuff from the older IEEEtran.cls so that \list +% will work the same way as before. However, itemize, enumerate and +% description (IED) could care less about what these are as they +% all are overridden. +\leftmargini 2em +%\itemindent 2em % Alternative values: sometimes used. +%\leftmargini 0em +\leftmarginii 1em +\leftmarginiii 1.5em +\leftmarginiv 1.5em +\leftmarginv 1.0em +\leftmarginvi 1.0em +\labelsep 0.5em +\labelwidth \z@ + + +% The old IEEEtran.cls behavior of \list is retained. +% However, the new V1.3 IED list environments override all the +% @list stuff (\@listX is called within \list for the +% appropriate level just before the user's list_decl is called). +% \topsep is now 2pt as IEEE puts a little extra space around +% lists - used by those non-IED macros that depend on \list. +% Note that \parsep and \itemsep are not redefined as in +% the sizexx.clo \@listX (which article.cls uses) so global changes +% of these values DO affect \list +% +\def\@listi{\leftmargin\leftmargini \topsep 2pt plus 1pt minus 1pt} +\let\@listI\@listi +\def\@listii{\leftmargin\leftmarginii\labelwidth\leftmarginii% + \advance\labelwidth-\labelsep \topsep 2pt} +\def\@listiii{\leftmargin\leftmarginiii\labelwidth\leftmarginiii% + \advance\labelwidth-\labelsep \topsep 2pt} +\def\@listiv{\leftmargin\leftmarginiv\labelwidth\leftmarginiv% + \advance\labelwidth-\labelsep \topsep 2pt} +\def\@listv{\leftmargin\leftmarginv\labelwidth\leftmarginv% + \advance\labelwidth-\labelsep \topsep 2pt} +\def\@listvi{\leftmargin\leftmarginvi\labelwidth\leftmarginvi% + \advance\labelwidth-\labelsep \topsep 2pt} + + +% IEEE uses 5) not 5. +\def\labelenumi{\theenumi)} \def\theenumi{\arabic{enumi}} + +% IEEE uses a) not (a) +\def\labelenumii{\theenumii)} \def\theenumii{\alph{enumii}} + +% IEEE uses iii) not iii. +\def\labelenumiii{\theenumiii)} \def\theenumiii{\roman{enumiii}} + +% IEEE uses A) not A. +\def\labelenumiv{\theenumiv)} \def\theenumiv{\Alph{enumiv}} + +% exactly the same as in article.cls +\def\p@enumii{\theenumi} +\def\p@enumiii{\theenumi(\theenumii)} +\def\p@enumiv{\p@enumiii\theenumiii} + +% itemized list label styles +\def\labelitemi{$\bullet$} +\def\labelitemii{$\circ$} +\def\labelitemiii{\vrule height 0.8ex depth -0.2ex width 0.6ex} +\def\labelitemiv{$\ast$} + + + +% **** V1.3 ENHANCEMENTS **** +% Itemize, Enumerate and Description (IED) List Controls +% *************************** +% +% +% IEEE seems to use at least two different values by +% which ITEMIZED list labels are indented to the right +% For The Journal of Lightwave Technology (JLT) and The Journal +% on Selected Areas in Communications (JSAC), they tend to use +% an indention equal to \parindent. For Transactions on Communications +% they tend to indent ITEMIZED lists a little more--- 1.3\parindent. +% We'll provide both values here for you so that you can choose +% which one you like in your document using a command such as: +% setlength{\IEEEilabelindent}{\IEEEilabelindentB} +\newdimen\IEEEilabelindentA +\IEEEilabelindentA \parindent + +\newdimen\IEEEilabelindentB +\IEEEilabelindentB 1.3\parindent +% However, we'll default to using \parindent +% which makes more sense to me +\newdimen\IEEEilabelindent +\IEEEilabelindent \IEEEilabelindentA + + +% This controls the default amount the enumerated list labels +% are indented to the right. +% Normally, this is the same as the paragraph indention +\newdimen\IEEEelabelindent +\IEEEelabelindent \parindent + +% This controls the default amount the description list labels +% are indented to the right. +% Normally, this is the same as the paragraph indention +\newdimen\IEEEdlabelindent +\IEEEdlabelindent \parindent + +% This is the value actually used within the IED lists. +% The IED environments automatically set its value to +% one of the three values above, so global changes do +% not have any effect +\newdimen\IEEElabelindent +\IEEElabelindent \parindent + +% The actual amount labels will be indented is +% \IEEElabelindent multiplied by the factor below +% corresponding to the level of nesting depth +% This provides a means by which the user can +% alter the effective \IEEElabelindent for deeper +% levels +% There may not be such a thing as correct "standard IEEE" +% values. What IEEE actually does may depend on the specific +% circumstances. +% The first list level almost always has full indention. +% The second levels I've seen have only 75% of the normal indentation +% Three level or greater nestings are very rare. I am guessing +% that they don't use any indentation. +\def\IEEElabelindentfactori{1.0} % almost always one +\def\IEEElabelindentfactorii{0.75} % 0.0 or 1.0 may be used in some cases +\def\IEEElabelindentfactoriii{0.0} % 0.75? 0.5? 0.0? +\def\IEEElabelindentfactoriv{0.0} +\def\IEEElabelindentfactorv{0.0} +\def\IEEElabelindentfactorvi{0.0} + +% value actually used within IED lists, it is auto +% set to one of the 6 values above +% global changes here have no effect +\def\IEEElabelindentfactor{1.0} + +% This controls the default spacing between the end of the IED +% list labels and the list text, when normal text is used for +% the labels. +\newdimen\IEEEiednormlabelsep +\IEEEiednormlabelsep \parindent + +% This controls the default spacing between the end of the IED +% list labels and the list text, when math symbols are used for +% the labels (nomenclature lists). IEEE usually increases the +% spacing in these cases +\newdimen\IEEEiedmathlabelsep +\IEEEiedmathlabelsep 1.2em + +% This controls the extra vertical separation put above and +% below each IED list. IEEE usually puts a little extra spacing +% around each list. However, this spacing is barely noticeable. +\newskip\IEEEiedtopsep +\IEEEiedtopsep 2pt plus 1pt minus 1pt + + +% This command is executed within each IED list environment +% at the beginning of the list. You can use this to set the +% parameters for some/all your IED list(s) without disturbing +% global parameters that affect things other than lists. +% i.e., renewcommand{\IEEEiedlistdecl}{\setlength{\labelsep}{5em}} +% will alter the \labelsep for the next list(s) until +% \IEEEiedlistdecl is redefined. +\def\IEEEiedlistdecl{\relax} + +% This command provides an easy way to set \leftmargin based +% on the \labelwidth, \labelsep and the argument \IEEElabelindent +% Usage: \IEEEcalcleftmargin{width-to-indent-the-label} +% output is in the \leftmargin variable, i.e., effectively: +% \leftmargin = argument + \labelwidth + \labelsep +% Note controlled spacing here, shield end of lines with % +\def\IEEEcalcleftmargin#1{\setlength{\leftmargin}{#1}% +\addtolength{\leftmargin}{\labelwidth}% +\addtolength{\leftmargin}{\labelsep}} + +% This command provides an easy way to set \labelwidth to the +% width of the given text. It is the same as +% \settowidth{\labelwidth}{label-text} +% and useful as a shorter alternative. +% Typically used to set \labelwidth to be the width +% of the longest label in the list +\def\IEEEsetlabelwidth#1{\settowidth{\labelwidth}{#1}} + +% When this command is executed, IED lists will use the +% IEEEiedmathlabelsep label separation rather than the normal +% spacing. To have an effect, this command must be executed via +% the \IEEEiedlistdecl or within the option of the IED list +% environments. +\def\IEEEusemathlabelsep{\setlength{\labelsep}{\IEEEiedmathlabelsep}} + +% A flag which controls whether the IED lists automatically +% calculate \leftmargin from \IEEElabelindent, \labelwidth and \labelsep +% Useful if you want to specify your own \leftmargin +% This flag must be set (\IEEEnocalcleftmargintrue or \IEEEnocalcleftmarginfalse) +% via the \IEEEiedlistdecl or within the option of the IED list +% environments to have an effect. +\newif\ifIEEEnocalcleftmargin +\IEEEnocalcleftmarginfalse + +% A flag which controls whether \IEEElabelindent is multiplied by +% the \IEEElabelindentfactor for each list level. +% This flag must be set via the \IEEEiedlistdecl or within the option +% of the IED list environments to have an effect. +\newif\ifIEEEnolabelindentfactor +\IEEEnolabelindentfactorfalse + + +% internal variable to indicate type of IED label +% justification +% 0 - left; 1 - center; 2 - right +\def\@IEEEiedjustify{0} + + +% commands to allow the user to control IED +% label justifications. Use these commands within +% the IED environment option or in the \IEEEiedlistdecl +% Note that changing the normal list justifications +% is nonstandard and IEEE may not like it if you do so! +% I include these commands as they may be helpful to +% those who are using these enhanced list controls for +% other non-IEEE related LaTeX work. +% itemize and enumerate automatically default to right +% justification, description defaults to left. +\def\IEEEiedlabeljustifyl{\def\@IEEEiedjustify{0}}%left +\def\IEEEiedlabeljustifyc{\def\@IEEEiedjustify{1}}%center +\def\IEEEiedlabeljustifyr{\def\@IEEEiedjustify{2}}%right + + + + +% commands to save to and restore from the list parameter copies +% this allows us to set all the list parameters within +% the list_decl and prevent \list (and its \@list) +% from overriding any of our parameters +% V1.6 use \edefs instead of dimen's to conserve dimen registers +% Note controlled spacing here, shield end of lines with % +\def\@IEEEsavelistparams{\edef\@IEEEiedtopsep{\the\topsep}% +\edef\@IEEEiedlabelwidth{\the\labelwidth}% +\edef\@IEEEiedlabelsep{\the\labelsep}% +\edef\@IEEEiedleftmargin{\the\leftmargin}% +\edef\@IEEEiedpartopsep{\the\partopsep}% +\edef\@IEEEiedparsep{\the\parsep}% +\edef\@IEEEieditemsep{\the\itemsep}% +\edef\@IEEEiedrightmargin{\the\rightmargin}% +\edef\@IEEEiedlistparindent{\the\listparindent}% +\edef\@IEEEieditemindent{\the\itemindent}} + +% Note controlled spacing here +\def\@IEEErestorelistparams{\topsep\@IEEEiedtopsep\relax% +\labelwidth\@IEEEiedlabelwidth\relax% +\labelsep\@IEEEiedlabelsep\relax% +\leftmargin\@IEEEiedleftmargin\relax% +\partopsep\@IEEEiedpartopsep\relax% +\parsep\@IEEEiedparsep\relax% +\itemsep\@IEEEieditemsep\relax% +\rightmargin\@IEEEiedrightmargin\relax% +\listparindent\@IEEEiedlistparindent\relax% +\itemindent\@IEEEieditemindent\relax} + + +% v1.6b provide original LaTeX IED list environments +% note that latex.ltx defines \itemize and \enumerate, but not \description +% which must be created by the base classes +% save original LaTeX itemize and enumerate +\let\LaTeXitemize\itemize +\let\endLaTeXitemize\enditemize +\let\LaTeXenumerate\enumerate +\let\endLaTeXenumerate\endenumerate + +% provide original LaTeX description environment from article.cls +\newenvironment{LaTeXdescription} + {\list{}{\labelwidth\z@ \itemindent-\leftmargin + \let\makelabel\descriptionlabel}} + {\endlist} +\newcommand*\descriptionlabel[1]{\hspace\labelsep + \normalfont\bfseries #1} + + +% override LaTeX's default IED lists +\def\itemize{\@IEEEitemize} +\def\enditemize{\@endIEEEitemize} +\def\enumerate{\@IEEEenumerate} +\def\endenumerate{\@endIEEEenumerate} +\def\description{\@IEEEdescription} +\def\enddescription{\@endIEEEdescription} + +% provide the user with aliases - may help those using packages that +% override itemize, enumerate, or description +\def\IEEEitemize{\@IEEEitemize} +\def\endIEEEitemize{\@endIEEEitemize} +\def\IEEEenumerate{\@IEEEenumerate} +\def\endIEEEenumerate{\@endIEEEenumerate} +\def\IEEEdescription{\@IEEEdescription} +\def\endIEEEdescription{\@endIEEEdescription} + + +% V1.6 we want to keep the IEEEtran IED list definitions as our own internal +% commands so they are protected against redefinition +\def\@IEEEitemize{\@ifnextchar[{\@@IEEEitemize}{\@@IEEEitemize[\relax]}} +\def\@IEEEenumerate{\@ifnextchar[{\@@IEEEenumerate}{\@@IEEEenumerate[\relax]}} +\def\@IEEEdescription{\@ifnextchar[{\@@IEEEdescription}{\@@IEEEdescription[\relax]}} +\def\@endIEEEitemize{\endlist} +\def\@endIEEEenumerate{\endlist} +\def\@endIEEEdescription{\endlist} + + +% DO NOT ALLOW BLANK LINES TO BE IN THESE IED ENVIRONMENTS +% AS THIS WILL FORCE NEW PARAGRAPHS AFTER THE IED LISTS +% IEEEtran itemized list MDS 1/2001 +% Note controlled spacing here, shield end of lines with % +\def\@@IEEEitemize[#1]{% + \ifnum\@itemdepth>3\relax\@toodeep\else% + \ifnum\@listdepth>5\relax\@toodeep\else% + \advance\@itemdepth\@ne% + \edef\@itemitem{labelitem\romannumeral\the\@itemdepth}% + % get the labelindentfactor for this level + \advance\@listdepth\@ne% we need to know what the level WILL be + \edef\IEEElabelindentfactor{\csname IEEElabelindentfactor\romannumeral\the\@listdepth\endcsname}% + \advance\@listdepth-\@ne% undo our increment + \def\@IEEEiedjustify{2}% right justified labels are default + % set other defaults + \IEEEnocalcleftmarginfalse% + \IEEEnolabelindentfactorfalse% + \topsep\IEEEiedtopsep% + \IEEElabelindent\IEEEilabelindent% + \labelsep\IEEEiednormlabelsep% + \partopsep 0ex% + \parsep 0ex% + \itemsep \parskip% + \rightmargin 0em% + \listparindent 0em% + \itemindent 0em% + % calculate the label width + % the user can override this later if + % they specified a \labelwidth + \settowidth{\labelwidth}{\csname labelitem\romannumeral\the\@itemdepth\endcsname}% + \@IEEEsavelistparams% save our list parameters + \list{\csname\@itemitem\endcsname}{% + \@IEEErestorelistparams% override any list{} changes + % to our globals + \let\makelabel\@IEEEiedmakelabel% v1.6b setup \makelabel + \IEEEiedlistdecl% let user alter parameters + #1\relax% + % If the user has requested not to use the + % labelindent factor, don't revise \labelindent + \ifIEEEnolabelindentfactor\relax% + \else\IEEElabelindent=\IEEElabelindentfactor\labelindent% + \fi% + % Unless the user has requested otherwise, + % calculate our left margin based + % on \IEEElabelindent, \labelwidth and + % \labelsep + \ifIEEEnocalcleftmargin\relax% + \else\IEEEcalcleftmargin{\IEEElabelindent}% + \fi}\fi\fi}% + + +% DO NOT ALLOW BLANK LINES TO BE IN THESE IED ENVIRONMENTS +% AS THIS WILL FORCE NEW PARAGRAPHS AFTER THE IED LISTS +% IEEEtran enumerate list MDS 1/2001 +% Note controlled spacing here, shield end of lines with % +\def\@@IEEEenumerate[#1]{% + \ifnum\@enumdepth>3\relax\@toodeep\else% + \ifnum\@listdepth>5\relax\@toodeep\else% + \advance\@enumdepth\@ne% + \edef\@enumctr{enum\romannumeral\the\@enumdepth}% + % get the labelindentfactor for this level + \advance\@listdepth\@ne% we need to know what the level WILL be + \edef\IEEElabelindentfactor{\csname IEEElabelindentfactor\romannumeral\the\@listdepth\endcsname}% + \advance\@listdepth-\@ne% undo our increment + \def\@IEEEiedjustify{2}% right justified labels are default + % set other defaults + \IEEEnocalcleftmarginfalse% + \IEEEnolabelindentfactorfalse% + \topsep\IEEEiedtopsep% + \IEEElabelindent\IEEEelabelindent% + \labelsep\IEEEiednormlabelsep% + \partopsep 0ex% + \parsep 0ex% + \itemsep 0ex% + \rightmargin 0em% + \listparindent 0em% + \itemindent 0em% + % calculate the label width + % We'll set it to the width suitable for all labels using + % normalfont 1) to 9) + % The user can override this later + \settowidth{\labelwidth}{9)}% + \@IEEEsavelistparams% save our list parameters + \list{\csname label\@enumctr\endcsname}{\usecounter{\@enumctr}% + \@IEEErestorelistparams% override any list{} changes + % to our globals + \let\makelabel\@IEEEiedmakelabel% v1.6b setup \makelabel + \IEEEiedlistdecl% let user alter parameters + #1\relax% + % If the user has requested not to use the + % IEEElabelindent factor, don't revise \IEEElabelindent + \ifIEEEnolabelindentfactor\relax% + \else\IEEElabelindent=\IEEElabelindentfactor\IEEElabelindent% + \fi% + % Unless the user has requested otherwise, + % calculate our left margin based + % on \IEEElabelindent, \labelwidth and + % \labelsep + \ifIEEEnocalcleftmargin\relax% + \else\IEEEcalcleftmargin{\IEEElabelindent}% + \fi}\fi\fi}% + + +% DO NOT ALLOW BLANK LINES TO BE IN THESE IED ENVIRONMENTS +% AS THIS WILL FORCE NEW PARAGRAPHS AFTER THE IED LISTS +% IEEEtran description list MDS 1/2001 +% Note controlled spacing here, shield end of lines with % +\def\@@IEEEdescription[#1]{% + \ifnum\@listdepth>5\relax\@toodeep\else% + % get the labelindentfactor for this level + \advance\@listdepth\@ne% we need to know what the level WILL be + \edef\IEEElabelindentfactor{\csname IEEElabelindentfactor\romannumeral\the\@listdepth\endcsname}% + \advance\@listdepth-\@ne% undo our increment + \def\@IEEEiedjustify{0}% left justified labels are default + % set other defaults + \IEEEnocalcleftmarginfalse% + \IEEEnolabelindentfactorfalse% + \topsep\IEEEiedtopsep% + \IEEElabelindent\IEEEdlabelindent% + % assume normal labelsep + \labelsep\IEEEiednormlabelsep% + \partopsep 0ex% + \parsep 0ex% + \itemsep 0ex% + \rightmargin 0em% + \listparindent 0em% + \itemindent 0em% + % Bogus label width in case the user forgets + % to set it. + % TIP: If you want to see what a variable's width is you + % can use the TeX command \showthe\width-variable to + % display it on the screen during compilation + % (This might be helpful to know when you need to find out + % which label is the widest) + \settowidth{\labelwidth}{Hello}% + \@IEEEsavelistparams% save our list parameters + \list{}{\@IEEErestorelistparams% override any list{} changes + % to our globals + \let\makelabel\@IEEEiedmakelabel% v1.6b setup \makelabel + \IEEEiedlistdecl% let user alter parameters + #1\relax% + % If the user has requested not to use the + % labelindent factor, don't revise \IEEElabelindent + \ifIEEEnolabelindentfactor\relax% + \else\IEEElabelindent=\IEEElabelindentfactor\IEEElabelindent% + \fi% + % Unless the user has requested otherwise, + % calculate our left margin based + % on \IEEElabelindent, \labelwidth and + % \labelsep + \ifIEEEnocalcleftmargin\relax% + \else\IEEEcalcleftmargin{\IEEElabelindent}\relax% + \fi}\fi} + +% v1.6b we use one makelabel that does justification as needed. +\def\@IEEEiedmakelabel#1{\relax\if\@IEEEiedjustify 0\relax +\makebox[\labelwidth][l]{\normalfont #1}\else +\if\@IEEEiedjustify 1\relax +\makebox[\labelwidth][c]{\normalfont #1}\else +\makebox[\labelwidth][r]{\normalfont #1}\fi\fi} + + +% VERSE and QUOTE +% V1.7 define environments with newenvironment +\newenvironment{verse}{\let\\=\@centercr + \list{}{\itemsep\z@ \itemindent -1.5em \listparindent \itemindent + \rightmargin\leftmargin\advance\leftmargin 1.5em}\item\relax} + {\endlist} +\newenvironment{quotation}{\list{}{\listparindent 1.5em \itemindent\listparindent + \rightmargin\leftmargin \parsep 0pt plus 1pt}\item\relax} + {\endlist} +\newenvironment{quote}{\list{}{\rightmargin\leftmargin}\item\relax} + {\endlist} + + +% \titlepage +% provided only for backward compatibility. \maketitle is the correct +% way to create the title page. +\newif\if@restonecol +\def\titlepage{\@restonecolfalse\if@twocolumn\@restonecoltrue\onecolumn + \else \newpage \fi \thispagestyle{empty}\c@page\z@} +\def\endtitlepage{\if@restonecol\twocolumn \else \newpage \fi} + +% standard values from article.cls +\arraycolsep 5pt +\arrayrulewidth .4pt +\doublerulesep 2pt + +\tabcolsep 6pt +\tabbingsep 0.5em + + +%% FOOTNOTES +% +%\skip\footins 10pt plus 4pt minus 2pt +% V1.6 respond to changes in font size +% space added above the footnotes (if present) +\skip\footins 0.9\baselineskip plus 0.4\baselineskip minus 0.2\baselineskip + +% V1.6, we need to make \footnotesep responsive to changes +% in \baselineskip or strange spacings will result when in +% draft mode. Here is a little LaTeX secret - \footnotesep +% determines the height of an invisible strut that is placed +% *above* the baseline of footnotes after the first. Since +% LaTeX considers the space for characters to be 0.7/baselineskip +% above the baseline and 0.3/baselineskip below it, we need to +% use 0.7/baselineskip as a \footnotesep to maintain equal spacing +% between all the lines of the footnotes. IEEE often uses a tad +% more, so use 0.8\baselineskip. This slightly larger value also helps +% the text to clear the footnote marks. Note that \thanks in IEEEtran +% uses its own value of \footnotesep which is set in \maketitle. +{\footnotesize +\global\footnotesep 0.8\baselineskip} + +\def\unnumberedfootnote{\gdef\@thefnmark{\quad}\@footnotetext} + +\skip\@mpfootins 0.3\baselineskip +\fboxsep = 3pt +\fboxrule = .4pt +% V1.6 use 1em, then use LaTeX2e's \@makefnmark +% Note that IEEE normally *left* aligns the footnote marks, so we don't need +% box resizing tricks here. +%\long\def\@makefnmark{\scriptsize\normalfont\@thefnmark} +\long\def\@makefntext#1{\parindent 1em\indent\hbox{\@makefnmark}#1}% V1.6 use 1em +\long\def\@maketablefntext#1{\raggedleft\leavevmode\hbox{\@makefnmark}#1} +% V1.7 compsoc does not use superscipts for footnote marks +\ifCLASSOPTIONcompsoc +\def\@IEEEcompsocmakefnmark{\hbox{\normalfont\@thefnmark.\ }} +\long\def\@makefntext#1{\parindent 1em\indent\hbox{\@IEEEcompsocmakefnmark}#1} +\fi + +% IEEE does not use footnote rules. Or do they? +\def\footnoterule{\vskip-2pt \hrule height 0.6pt depth \z@ \vskip1.6pt\relax} +\toks@\expandafter{\@setminipage\let\footnoterule\relax\footnotesep\z@} +\edef\@setminipage{\the\toks@} + +% V1.7 for compsoc, IEEE uses a footnote rule only for \thanks. We devise a "one-shot" +% system to implement this. +\newif\if@IEEEenableoneshotfootnoterule +\@IEEEenableoneshotfootnoterulefalse +\ifCLASSOPTIONcompsoc +\def\footnoterule{\relax\if@IEEEenableoneshotfootnoterule +\kern-5pt +\hbox to \columnwidth{\hfill\vrule width 0.5\columnwidth height 0.4pt\hfill} +\kern4.6pt +\global\@IEEEenableoneshotfootnoterulefalse +\else +\relax +\fi} +\fi + +% V1.6 do not allow LaTeX to break a footnote across multiple pages +\interfootnotelinepenalty=10000 + +% V1.6 discourage breaks within equations +% Note that amsmath normally sets this to 10000, +% but LaTeX2e normally uses 100. +\interdisplaylinepenalty=2500 + +% default allows section depth up to /paragraph +\setcounter{secnumdepth}{4} + +% technotes do not allow /paragraph +\ifCLASSOPTIONtechnote + \setcounter{secnumdepth}{3} +\fi +% neither do compsoc conferences +\@IEEEcompsocconfonly{\setcounter{secnumdepth}{3}} + + +\newcounter{section} +\newcounter{subsection}[section] +\newcounter{subsubsection}[subsection] +\newcounter{paragraph}[subsubsection] + +% used only by IEEEtran's IEEEeqnarray as other packages may +% have their own, different, implementations +\newcounter{IEEEsubequation}[equation] + +% as shown when called by user from \ref, \label and in table of contents +\def\theequation{\arabic{equation}} % 1 +\def\theIEEEsubequation{\theequation\alph{IEEEsubequation}} % 1a (used only by IEEEtran's IEEEeqnarray) +\ifCLASSOPTIONcompsoc +% compsoc is all arabic +\def\thesection{\arabic{section}} +\def\thesubsection{\thesection.\arabic{subsection}} +\def\thesubsubsection{\thesubsection.\arabic{subsubsection}} +\def\theparagraph{\thesubsubsection.\arabic{paragraph}} +\else +\def\thesection{\Roman{section}} % I +% V1.7, \mbox prevents breaks around - +\def\thesubsection{\mbox{\thesection-\Alph{subsection}}} % I-A +% V1.7 use I-A1 format used by IEEE rather than I-A.1 +\def\thesubsubsection{\thesubsection\arabic{subsubsection}} % I-A1 +\def\theparagraph{\thesubsubsection\alph{paragraph}} % I-A1a +\fi + +% From Heiko Oberdiek. Because of the \mbox in \thesubsection, we need to +% tell hyperref to disable the \mbox command when making PDF bookmarks. +% This done already with hyperref.sty version 6.74o and later, but +% it will not hurt to do it here again for users of older versions. +\@ifundefined{pdfstringdefPreHook}{\let\pdfstringdefPreHook\@empty}{}% +\g@addto@macro\pdfstringdefPreHook{\let\mbox\relax} + + +% Main text forms (how shown in main text headings) +% V1.6, using \thesection in \thesectiondis allows changes +% in the former to automatically appear in the latter +\ifCLASSOPTIONcompsoc + \ifCLASSOPTIONconference% compsoc conference + \def\thesectiondis{\thesection.} + \def\thesubsectiondis{\thesectiondis\arabic{subsection}.} + \def\thesubsubsectiondis{\thesubsectiondis\arabic{subsubsection}.} + \def\theparagraphdis{\thesubsubsectiondis\arabic{paragraph}.} + \else% compsoc not conferencs + \def\thesectiondis{\thesection} + \def\thesubsectiondis{\thesectiondis.\arabic{subsection}} + \def\thesubsubsectiondis{\thesubsectiondis.\arabic{subsubsection}} + \def\theparagraphdis{\thesubsubsectiondis.\arabic{paragraph}} + \fi +\else% not compsoc + \def\thesectiondis{\thesection.} % I. + \def\thesubsectiondis{\Alph{subsection}.} % B. + \def\thesubsubsectiondis{\arabic{subsubsection})} % 3) + \def\theparagraphdis{\alph{paragraph})} % d) +\fi + +% just like LaTeX2e's \@eqnnum +\def\theequationdis{{\normalfont \normalcolor (\theequation)}}% (1) +% IEEEsubequation used only by IEEEtran's IEEEeqnarray +\def\theIEEEsubequationdis{{\normalfont \normalcolor (\theIEEEsubequation)}}% (1a) +% redirect LaTeX2e's equation number display and all that depend on +% it, through IEEEtran's \theequationdis +\def\@eqnnum{\theequationdis} + + + +% V1.7 provide string macros as article.cls does +\def\contentsname{Contents} +\def\listfigurename{List of Figures} +\def\listtablename{List of Tables} +\def\refname{References} +\def\indexname{Index} +\def\figurename{Fig.} +\def\tablename{TABLE} +\@IEEEcompsocconfonly{\def\figurename{Figure}\def\tablename{Table}} +\def\partname{Part} +\def\appendixname{Appendix} +\def\abstractname{Abstract} +% IEEE specific names +\def\IEEEkeywordsname{Keywords} +\def\IEEEproofname{Proof} + + +% LIST OF FIGURES AND TABLES AND TABLE OF CONTENTS +% +\def\@pnumwidth{1.55em} +\def\@tocrmarg{2.55em} +\def\@dotsep{4.5} +\setcounter{tocdepth}{3} + +% adjusted some spacings here so that section numbers will not easily +% collide with the section titles. +% VIII; VIII-A; and VIII-A.1 are usually the worst offenders. +% MDS 1/2001 +\def\tableofcontents{\section*{\contentsname}\@starttoc{toc}} +\def\l@section#1#2{\addpenalty{\@secpenalty}\addvspace{1.0em plus 1pt}% + \@tempdima 2.75em \begingroup \parindent \z@ \rightskip \@pnumwidth% + \parfillskip-\@pnumwidth {\bfseries\leavevmode #1}\hfil\hbox to\@pnumwidth{\hss #2}\par% + \endgroup} +% argument format #1:level, #2:labelindent,#3:labelsep +\def\l@subsection{\@dottedtocline{2}{2.75em}{3.75em}} +\def\l@subsubsection{\@dottedtocline{3}{6.5em}{4.5em}} +% must provide \l@ defs for ALL sublevels EVEN if tocdepth +% is such as they will not appear in the table of contents +% these defs are how TOC knows what level these things are! +\def\l@paragraph{\@dottedtocline{4}{6.5em}{5.5em}} +\def\l@subparagraph{\@dottedtocline{5}{6.5em}{6.5em}} +\def\listoffigures{\section*{\listfigurename}\@starttoc{lof}} +\def\l@figure{\@dottedtocline{1}{0em}{2.75em}} +\def\listoftables{\section*{\listtablename}\@starttoc{lot}} +\let\l@table\l@figure + + +%% Definitions for floats +%% +%% Normal Floats +\floatsep 1\baselineskip plus 0.2\baselineskip minus 0.2\baselineskip +\textfloatsep 1.7\baselineskip plus 0.2\baselineskip minus 0.4\baselineskip +\@fptop 0pt plus 1fil +\@fpsep 0.75\baselineskip plus 2fil +\@fpbot 0pt plus 1fil +\def\topfraction{0.9} +\def\bottomfraction{0.4} +\def\floatpagefraction{0.8} +% V1.7, let top floats approach 90% of page +\def\textfraction{0.1} + +%% Double Column Floats +\dblfloatsep 1\baselineskip plus 0.2\baselineskip minus 0.2\baselineskip + +\dbltextfloatsep 1.7\baselineskip plus 0.2\baselineskip minus 0.4\baselineskip +% Note that it would be nice if the rubber here actually worked in LaTeX2e. +% There is a long standing limitation in LaTeX, first discovered (to the best +% of my knowledge) by Alan Jeffrey in 1992. LaTeX ignores the stretchable +% portion of \dbltextfloatsep, and as a result, double column figures can and +% do result in an non-integer number of lines in the main text columns with +% underfull vbox errors as a consequence. A post to comp.text.tex +% by Donald Arseneau confirms that this had not yet been fixed in 1998. +% IEEEtran V1.6 will fix this problem for you in the titles, but it doesn't +% protect you from other double floats. Happy vspace'ing. + +\@dblfptop 0pt plus 1fil +\@dblfpsep 0.75\baselineskip plus 2fil +\@dblfpbot 0pt plus 1fil +\def\dbltopfraction{0.8} +\def\dblfloatpagefraction{0.8} +\setcounter{dbltopnumber}{4} + +\intextsep 1\baselineskip plus 0.2\baselineskip minus 0.2\baselineskip +\setcounter{topnumber}{2} +\setcounter{bottomnumber}{2} +\setcounter{totalnumber}{4} + + + +% article class provides these, we should too. +\newlength\abovecaptionskip +\newlength\belowcaptionskip +% but only \abovecaptionskip is used above figure captions and *below* table +% captions +\setlength\abovecaptionskip{0.65\baselineskip} +\setlength\belowcaptionskip{0.75\baselineskip} +% V1.6 create hooks in case the caption spacing ever needs to be +% overridden by a user +\def\@IEEEfigurecaptionsepspace{\vskip\abovecaptionskip\relax}% +\def\@IEEEtablecaptionsepspace{\vskip\belowcaptionskip\relax}% + + +% 1.6b revise caption system so that \@makecaption uses two arguments +% as with LaTeX2e. Otherwise, there will be problems when using hyperref. +\def\@IEEEtablestring{table} + +\ifCLASSOPTIONcompsoc +% V1.7 compsoc \@makecaption +\ifCLASSOPTIONconference% compsoc conference +\long\def\@makecaption#1#2{% +% test if is a for a figure or table +\ifx\@captype\@IEEEtablestring% +% if a table, do table caption +\normalsize\begin{center}{\normalfont\sffamily\normalsize {#1.}~ #2}\end{center}% +\@IEEEtablecaptionsepspace +% if not a table, format it as a figure +\else +\@IEEEfigurecaptionsepspace +\setbox\@tempboxa\hbox{\normalfont\sffamily\normalsize {#1.}~ #2}% +\ifdim \wd\@tempboxa >\hsize% +% if caption is longer than a line, let it wrap around +\setbox\@tempboxa\hbox{\normalfont\sffamily\normalsize {#1.}~ }% +\parbox[t]{\hsize}{\normalfont\sffamily\normalsize \noindent\unhbox\@tempboxa#2}% +% if caption is shorter than a line, center +\else% +\hbox to\hsize{\normalfont\sffamily\normalsize\hfil\box\@tempboxa\hfil}% +\fi\fi} +\else% nonconference compsoc +\long\def\@makecaption#1#2{% +% test if is a for a figure or table +\ifx\@captype\@IEEEtablestring% +% if a table, do table caption +\normalsize\begin{center}{\normalfont\sffamily\normalsize #1}\\{\normalfont\sffamily\normalsize #2}\end{center}% +\@IEEEtablecaptionsepspace +% if not a table, format it as a figure +\else +\@IEEEfigurecaptionsepspace +\setbox\@tempboxa\hbox{\normalfont\sffamily\normalsize {#1.}~ #2}% +\ifdim \wd\@tempboxa >\hsize% +% if caption is longer than a line, let it wrap around +\setbox\@tempboxa\hbox{\normalfont\sffamily\normalsize {#1.}~ }% +\parbox[t]{\hsize}{\normalfont\sffamily\normalsize \noindent\unhbox\@tempboxa#2}% +% if caption is shorter than a line, left justify +\else% +\hbox to\hsize{\normalfont\sffamily\normalsize\box\@tempboxa\hfil}% +\fi\fi} +\fi + +\else% traditional noncompsoc \@makecaption +\long\def\@makecaption#1#2{% +% test if is a for a figure or table +\ifx\@captype\@IEEEtablestring% +% if a table, do table caption +\footnotesize{\centering\normalfont\footnotesize#1.\qquad\scshape #2\par}% +\@IEEEtablecaptionsepspace +% if not a table, format it as a figure +\else +\@IEEEfigurecaptionsepspace +% 3/2001 use footnotesize, not small; use two nonbreaking spaces, not one +\setbox\@tempboxa\hbox{\normalfont\footnotesize {#1.}~~ #2}% +\ifdim \wd\@tempboxa >\hsize% +% if caption is longer than a line, let it wrap around +\setbox\@tempboxa\hbox{\normalfont\footnotesize {#1.}~~ }% +\parbox[t]{\hsize}{\normalfont\footnotesize\noindent\unhbox\@tempboxa#2}% +% if caption is shorter than a line, center if conference, left justify otherwise +\else% +\ifCLASSOPTIONconference \hbox to\hsize{\normalfont\footnotesize\box\@tempboxa\hfil}% +\else \hbox to\hsize{\normalfont\footnotesize\box\@tempboxa\hfil}% +\fi\fi\fi} +\fi + + + +% V1.7 disable captions class option, do so in a way that retains operation of \label +% within \caption +\ifCLASSOPTIONcaptionsoff +\long\def\@makecaption#1#2{\vspace*{2em}\footnotesize\begin{center}{\footnotesize #1}\end{center}% +\let\@IEEEtemporiglabeldefsave\label +\let\@IEEEtemplabelargsave\relax +\def\label##1{\gdef\@IEEEtemplabelargsave{##1}}% +\setbox\@tempboxa\hbox{#2}% +\let\label\@IEEEtemporiglabeldefsave +\ifx\@IEEEtemplabelargsave\relax\else\label{\@IEEEtemplabelargsave}\fi} +\fi + + +% V1.7 define end environments with \def not \let so as to work OK with +% preview-latex +\newcounter{figure} +\def\thefigure{\@arabic\c@figure} +\def\fps@figure{tbp} +\def\ftype@figure{1} +\def\ext@figure{lof} +\def\fnum@figure{\figurename~\thefigure} +\def\figure{\@float{figure}} +\def\endfigure{\end@float} +\@namedef{figure*}{\@dblfloat{figure}} +\@namedef{endfigure*}{\end@dblfloat} +\newcounter{table} +\ifCLASSOPTIONcompsoc +\def\thetable{\arabic{table}} +\else +\def\thetable{\@Roman\c@table} +\fi +\def\fps@table{tbp} +\def\ftype@table{2} +\def\ext@table{lot} +\def\fnum@table{\tablename~\thetable} +% V1.6 IEEE uses 8pt text for tables +% to default to footnotesize, we hack into LaTeX2e's \@floatboxreset and pray +\def\table{\def\@floatboxreset{\reset@font\scriptsize\@setminipage}% + \let\@makefntext\@maketablefntext + \@float{table}} +\def\endtable{\end@float} +% v1.6b double column tables need to default to footnotesize as well. +\@namedef{table*}{\def\@floatboxreset{\reset@font\scriptsize\@setminipage}\@dblfloat{table}} +\@namedef{endtable*}{\end@dblfloat} + + + + +%% +%% START OF IEEEeqnarry DEFINITIONS +%% +%% Inspired by the concepts, examples, and previous works of LaTeX +%% coders and developers such as Donald Arseneau, Fred Bartlett, +%% David Carlisle, Tony Liu, Frank Mittelbach, Piet van Oostrum, +%% Roland Winkler and Mark Wooding. +%% I don't make the claim that my work here is even near their calibre. ;) + + +% hook to allow easy changeover to IEEEtran.cls/tools.sty error reporting +\def\@IEEEclspkgerror{\ClassError{IEEEtran}} + +\newif\if@IEEEeqnarraystarform% flag to indicate if the environment was called as the star form +\@IEEEeqnarraystarformfalse + +\newif\if@advanceIEEEeqncolcnt% tracks if the environment should advance the col counter +% allows a way to make an \IEEEeqnarraybox that can be used within an \IEEEeqnarray +% used by IEEEeqnarraymulticol so that it can work properly in both +\@advanceIEEEeqncolcnttrue + +\newcount\@IEEEeqnnumcols % tracks how many IEEEeqnarray cols are defined +\newcount\@IEEEeqncolcnt % tracks how many IEEEeqnarray cols the user actually used + + +% The default math style used by the columns +\def\IEEEeqnarraymathstyle{\displaystyle} +% The default text style used by the columns +% default to using the current font +\def\IEEEeqnarraytextstyle{\relax} + +% like the iedlistdecl but for \IEEEeqnarray +\def\IEEEeqnarraydecl{\relax} +\def\IEEEeqnarrayboxdecl{\relax} + +% \yesnumber is the opposite of \nonumber +% a novel concept with the same def as the equationarray package +% However, we give IEEE versions too since some LaTeX packages such as +% the MDWtools mathenv.sty redefine \nonumber to something else. +\providecommand{\yesnumber}{\global\@eqnswtrue} +\def\IEEEyesnumber{\global\@eqnswtrue} +\def\IEEEnonumber{\global\@eqnswfalse} + + +\def\IEEEyessubnumber{\global\@IEEEissubequationtrue\global\@eqnswtrue% +\if@IEEEeqnarrayISinner% only do something inside an IEEEeqnarray +\if@IEEElastlinewassubequation\addtocounter{equation}{-1}\else\setcounter{IEEEsubequation}{1}\fi% +\def\@currentlabel{\p@IEEEsubequation\theIEEEsubequation}\fi} + +% flag to indicate that an equation is a sub equation +\newif\if@IEEEissubequation% +\@IEEEissubequationfalse + +% allows users to "push away" equations that get too close to the equation numbers +\def\IEEEeqnarraynumspace{\hphantom{\if@IEEEissubequation\theIEEEsubequationdis\else\theequationdis\fi}} + +% provides a way to span multiple columns within IEEEeqnarray environments +% will consider \if@advanceIEEEeqncolcnt before globally advancing the +% column counter - so as to work within \IEEEeqnarraybox +% usage: \IEEEeqnarraymulticol{number cols. to span}{col type}{cell text} +\long\def\IEEEeqnarraymulticol#1#2#3{\multispan{#1}% +% check if column is defined +\relax\expandafter\ifx\csname @IEEEeqnarraycolDEF#2\endcsname\@IEEEeqnarraycolisdefined% +\csname @IEEEeqnarraycolPRE#2\endcsname#3\relax\relax\relax\relax\relax% +\relax\relax\relax\relax\relax\csname @IEEEeqnarraycolPOST#2\endcsname% +\else% if not, error and use default type +\@IEEEclspkgerror{Invalid column type "#2" in \string\IEEEeqnarraymulticol.\MessageBreak +Using a default centering column instead}% +{You must define IEEEeqnarray column types before use.}% +\csname @IEEEeqnarraycolPRE@IEEEdefault\endcsname#3\relax\relax\relax\relax\relax% +\relax\relax\relax\relax\relax\csname @IEEEeqnarraycolPOST@IEEEdefault\endcsname% +\fi% +% advance column counter only if the IEEEeqnarray environment wants it +\if@advanceIEEEeqncolcnt\global\advance\@IEEEeqncolcnt by #1\relax\fi} + +% like \omit, but maintains track of the column counter for \IEEEeqnarray +\def\IEEEeqnarrayomit{\omit\if@advanceIEEEeqncolcnt\global\advance\@IEEEeqncolcnt by 1\relax\fi} + + +% provides a way to define a letter referenced column type +% usage: \IEEEeqnarraydefcol{col. type letter/name}{pre insertion text}{post insertion text} +\def\IEEEeqnarraydefcol#1#2#3{\expandafter\def\csname @IEEEeqnarraycolPRE#1\endcsname{#2}% +\expandafter\def\csname @IEEEeqnarraycolPOST#1\endcsname{#3}% +\expandafter\def\csname @IEEEeqnarraycolDEF#1\endcsname{1}} + + +% provides a way to define a numerically referenced inter-column glue types +% usage: \IEEEeqnarraydefcolsep{col. glue number}{glue definition} +\def\IEEEeqnarraydefcolsep#1#2{\expandafter\def\csname @IEEEeqnarraycolSEP\romannumeral #1\endcsname{#2}% +\expandafter\def\csname @IEEEeqnarraycolSEPDEF\romannumeral #1\endcsname{1}} + + +\def\@IEEEeqnarraycolisdefined{1}% just a macro for 1, used for checking undefined column types + + +% expands and appends the given argument to the \@IEEEtrantmptoksA token list +% used to build up the \halign preamble +\def\@IEEEappendtoksA#1{\edef\@@IEEEappendtoksA{\@IEEEtrantmptoksA={\the\@IEEEtrantmptoksA #1}}% +\@@IEEEappendtoksA} + +% also appends to \@IEEEtrantmptoksA, but does not expand the argument +% uses \toks8 as a scratchpad register +\def\@IEEEappendNOEXPANDtoksA#1{\toks8={#1}% +\edef\@@IEEEappendNOEXPANDtoksA{\@IEEEtrantmptoksA={\the\@IEEEtrantmptoksA\the\toks8}}% +\@@IEEEappendNOEXPANDtoksA} + +% define some common column types for the user +% math +\IEEEeqnarraydefcol{l}{$\IEEEeqnarraymathstyle}{$\hfil} +\IEEEeqnarraydefcol{c}{\hfil$\IEEEeqnarraymathstyle}{$\hfil} +\IEEEeqnarraydefcol{r}{\hfil$\IEEEeqnarraymathstyle}{$} +\IEEEeqnarraydefcol{L}{$\IEEEeqnarraymathstyle{}}{{}$\hfil} +\IEEEeqnarraydefcol{C}{\hfil$\IEEEeqnarraymathstyle{}}{{}$\hfil} +\IEEEeqnarraydefcol{R}{\hfil$\IEEEeqnarraymathstyle{}}{{}$} +% text +\IEEEeqnarraydefcol{s}{\IEEEeqnarraytextstyle}{\hfil} +\IEEEeqnarraydefcol{t}{\hfil\IEEEeqnarraytextstyle}{\hfil} +\IEEEeqnarraydefcol{u}{\hfil\IEEEeqnarraytextstyle}{} + +% vertical rules +\IEEEeqnarraydefcol{v}{}{\vrule width\arrayrulewidth} +\IEEEeqnarraydefcol{vv}{\vrule width\arrayrulewidth\hfil}{\hfil\vrule width\arrayrulewidth} +\IEEEeqnarraydefcol{V}{}{\vrule width\arrayrulewidth\hskip\doublerulesep\vrule width\arrayrulewidth} +\IEEEeqnarraydefcol{VV}{\vrule width\arrayrulewidth\hskip\doublerulesep\vrule width\arrayrulewidth\hfil}% +{\hfil\vrule width\arrayrulewidth\hskip\doublerulesep\vrule width\arrayrulewidth} + +% horizontal rules +\IEEEeqnarraydefcol{h}{}{\leaders\hrule height\arrayrulewidth\hfil} +\IEEEeqnarraydefcol{H}{}{\leaders\vbox{\hrule width\arrayrulewidth\vskip\doublerulesep\hrule width\arrayrulewidth}\hfil} + +% plain +\IEEEeqnarraydefcol{x}{}{} +\IEEEeqnarraydefcol{X}{$}{$} + +% the default column type to use in the event a column type is not defined +\IEEEeqnarraydefcol{@IEEEdefault}{\hfil$\IEEEeqnarraymathstyle}{$\hfil} + + +% a zero tabskip (used for "-" col types) +\def\@IEEEeqnarraycolSEPzero{0pt plus 0pt minus 0pt} +% a centering tabskip (used for "+" col types) +\def\@IEEEeqnarraycolSEPcenter{1000pt plus 0pt minus 1000pt} + +% top level default tabskip glues for the start, end, and inter-column +% may be reset within environments not always at the top level, e.g., \IEEEeqnarraybox +\edef\@IEEEeqnarraycolSEPdefaultstart{\@IEEEeqnarraycolSEPcenter}% default start glue +\edef\@IEEEeqnarraycolSEPdefaultend{\@IEEEeqnarraycolSEPcenter}% default end glue +\edef\@IEEEeqnarraycolSEPdefaultmid{\@IEEEeqnarraycolSEPzero}% default inter-column glue + + + +% creates a vertical rule that extends from the bottom to the top a a cell +% Provided in case other packages redefine \vline some other way. +% usage: \IEEEeqnarrayvrule[rule thickness] +% If no argument is provided, \arrayrulewidth will be used for the rule thickness. +\newcommand\IEEEeqnarrayvrule[1][\arrayrulewidth]{\vrule\@width#1\relax} + +% creates a blank separator row +% usage: \IEEEeqnarrayseprow[separation length][font size commands] +% default is \IEEEeqnarrayseprow[0.25\normalbaselineskip][\relax] +% blank arguments inherit the default values +% uses \skip5 as a scratch register - calls \@IEEEeqnarraystrutsize which uses more scratch registers +\def\IEEEeqnarrayseprow{\relax\@ifnextchar[{\@IEEEeqnarrayseprow}{\@IEEEeqnarrayseprow[0.25\normalbaselineskip]}} +\def\@IEEEeqnarrayseprow[#1]{\relax\@ifnextchar[{\@@IEEEeqnarrayseprow[#1]}{\@@IEEEeqnarrayseprow[#1][\relax]}} +\def\@@IEEEeqnarrayseprow[#1][#2]{\def\@IEEEeqnarrayseprowARGONE{#1}% +\ifx\@IEEEeqnarrayseprowARGONE\@empty% +% get the skip value, based on the font commands +% use skip5 because \IEEEeqnarraystrutsize uses \skip0, \skip2, \skip3 +% assign within a bogus box to confine the font changes +{\setbox0=\hbox{#2\relax\global\skip5=0.25\normalbaselineskip}}% +\else% +{\setbox0=\hbox{#2\relax\global\skip5=#1}}% +\fi% +\@IEEEeqnarrayhoptolastcolumn\IEEEeqnarraystrutsize{\skip5}{0pt}[\relax]\relax} + +% creates a blank separator row, but omits all the column templates +% usage: \IEEEeqnarrayseprowcut[separation length][font size commands] +% default is \IEEEeqnarrayseprowcut[0.25\normalbaselineskip][\relax] +% blank arguments inherit the default values +% uses \skip5 as a scratch register - calls \@IEEEeqnarraystrutsize which uses more scratch registers +\def\IEEEeqnarrayseprowcut{\multispan{\@IEEEeqnnumcols}\relax% span all the cols +% advance column counter only if the IEEEeqnarray environment wants it +\if@advanceIEEEeqncolcnt\global\advance\@IEEEeqncolcnt by \@IEEEeqnnumcols\relax\fi% +\@ifnextchar[{\@IEEEeqnarrayseprowcut}{\@IEEEeqnarrayseprowcut[0.25\normalbaselineskip]}} +\def\@IEEEeqnarrayseprowcut[#1]{\relax\@ifnextchar[{\@@IEEEeqnarrayseprowcut[#1]}{\@@IEEEeqnarrayseprowcut[#1][\relax]}} +\def\@@IEEEeqnarrayseprowcut[#1][#2]{\def\@IEEEeqnarrayseprowARGONE{#1}% +\ifx\@IEEEeqnarrayseprowARGONE\@empty% +% get the skip value, based on the font commands +% use skip5 because \IEEEeqnarraystrutsize uses \skip0, \skip2, \skip3 +% assign within a bogus box to confine the font changes +{\setbox0=\hbox{#2\relax\global\skip5=0.25\normalbaselineskip}}% +\else% +{\setbox0=\hbox{#2\relax\global\skip5=#1}}% +\fi% +\IEEEeqnarraystrutsize{\skip5}{0pt}[\relax]\relax} + + + +% draws a single rule across all the columns optional +% argument determines the rule width, \arrayrulewidth is the default +% updates column counter as needed and turns off struts +% usage: \IEEEeqnarrayrulerow[rule line thickness] +\def\IEEEeqnarrayrulerow{\multispan{\@IEEEeqnnumcols}\relax% span all the cols +% advance column counter only if the IEEEeqnarray environment wants it +\if@advanceIEEEeqncolcnt\global\advance\@IEEEeqncolcnt by \@IEEEeqnnumcols\relax\fi% +\@ifnextchar[{\@IEEEeqnarrayrulerow}{\@IEEEeqnarrayrulerow[\arrayrulewidth]}} +\def\@IEEEeqnarrayrulerow[#1]{\leaders\hrule height#1\hfil\relax% put in our rule +% turn off any struts +\IEEEeqnarraystrutsize{0pt}{0pt}[\relax]\relax} + + +% draws a double rule by using a single rule row, a separator row, and then +% another single rule row +% first optional argument determines the rule thicknesses, \arrayrulewidth is the default +% second optional argument determines the rule spacing, \doublerulesep is the default +% usage: \IEEEeqnarraydblrulerow[rule line thickness][rule spacing] +\def\IEEEeqnarraydblrulerow{\multispan{\@IEEEeqnnumcols}\relax% span all the cols +% advance column counter only if the IEEEeqnarray environment wants it +\if@advanceIEEEeqncolcnt\global\advance\@IEEEeqncolcnt by \@IEEEeqnnumcols\relax\fi% +\@ifnextchar[{\@IEEEeqnarraydblrulerow}{\@IEEEeqnarraydblrulerow[\arrayrulewidth]}} +\def\@IEEEeqnarraydblrulerow[#1]{\relax\@ifnextchar[{\@@IEEEeqnarraydblrulerow[#1]}% +{\@@IEEEeqnarraydblrulerow[#1][\doublerulesep]}} +\def\@@IEEEeqnarraydblrulerow[#1][#2]{\def\@IEEEeqnarraydblrulerowARG{#1}% +% we allow the user to say \IEEEeqnarraydblrulerow[][] +\ifx\@IEEEeqnarraydblrulerowARG\@empty% +\@IEEEeqnarrayrulerow[\arrayrulewidth]% +\else% +\@IEEEeqnarrayrulerow[#1]\relax% +\fi% +\def\@IEEEeqnarraydblrulerowARG{#2}% +\ifx\@IEEEeqnarraydblrulerowARG\@empty% +\\\IEEEeqnarrayseprow[\doublerulesep][\relax]% +\else% +\\\IEEEeqnarrayseprow[#2][\relax]% +\fi% +\\\multispan{\@IEEEeqnnumcols}% +% advance column counter only if the IEEEeqnarray environment wants it +\if@advanceIEEEeqncolcnt\global\advance\@IEEEeqncolcnt by \@IEEEeqnnumcols\relax\fi% +\def\@IEEEeqnarraydblrulerowARG{#1}% +\ifx\@IEEEeqnarraydblrulerowARG\@empty% +\@IEEEeqnarrayrulerow[\arrayrulewidth]% +\else% +\@IEEEeqnarrayrulerow[#1]% +\fi% +} + +% draws a double rule by using a single rule row, a separator (cutting) row, and then +% another single rule row +% first optional argument determines the rule thicknesses, \arrayrulewidth is the default +% second optional argument determines the rule spacing, \doublerulesep is the default +% usage: \IEEEeqnarraydblrulerow[rule line thickness][rule spacing] +\def\IEEEeqnarraydblrulerowcut{\multispan{\@IEEEeqnnumcols}\relax% span all the cols +% advance column counter only if the IEEEeqnarray environment wants it +\if@advanceIEEEeqncolcnt\global\advance\@IEEEeqncolcnt by \@IEEEeqnnumcols\relax\fi% +\@ifnextchar[{\@IEEEeqnarraydblrulerowcut}{\@IEEEeqnarraydblrulerowcut[\arrayrulewidth]}} +\def\@IEEEeqnarraydblrulerowcut[#1]{\relax\@ifnextchar[{\@@IEEEeqnarraydblrulerowcut[#1]}% +{\@@IEEEeqnarraydblrulerowcut[#1][\doublerulesep]}} +\def\@@IEEEeqnarraydblrulerowcut[#1][#2]{\def\@IEEEeqnarraydblrulerowARG{#1}% +% we allow the user to say \IEEEeqnarraydblrulerow[][] +\ifx\@IEEEeqnarraydblrulerowARG\@empty% +\@IEEEeqnarrayrulerow[\arrayrulewidth]% +\else% +\@IEEEeqnarrayrulerow[#1]% +\fi% +\def\@IEEEeqnarraydblrulerowARG{#2}% +\ifx\@IEEEeqnarraydblrulerowARG\@empty% +\\\IEEEeqnarrayseprowcut[\doublerulesep][\relax]% +\else% +\\\IEEEeqnarrayseprowcut[#2][\relax]% +\fi% +\\\multispan{\@IEEEeqnnumcols}% +% advance column counter only if the IEEEeqnarray environment wants it +\if@advanceIEEEeqncolcnt\global\advance\@IEEEeqncolcnt by \@IEEEeqnnumcols\relax\fi% +\def\@IEEEeqnarraydblrulerowARG{#1}% +\ifx\@IEEEeqnarraydblrulerowARG\@empty% +\@IEEEeqnarrayrulerow[\arrayrulewidth]% +\else% +\@IEEEeqnarrayrulerow[#1]% +\fi% +} + + + +% inserts a full row's worth of &'s +% relies on \@IEEEeqnnumcols to provide the correct number of columns +% uses \@IEEEtrantmptoksA, \count0 as scratch registers +\def\@IEEEeqnarrayhoptolastcolumn{\@IEEEtrantmptoksA={}\count0=1\relax% +\loop% add cols if the user did not use them all +\ifnum\count0<\@IEEEeqnnumcols\relax% +\@IEEEappendtoksA{&}% +\advance\count0 by 1\relax% update the col count +\repeat% +\the\@IEEEtrantmptoksA%execute the &'s +} + + + +\newif\if@IEEEeqnarrayISinner % flag to indicate if we are within the lines +\@IEEEeqnarrayISinnerfalse % of an IEEEeqnarray - after the IEEEeqnarraydecl + +\edef\@IEEEeqnarrayTHEstrutheight{0pt} % height and depth of IEEEeqnarray struts +\edef\@IEEEeqnarrayTHEstrutdepth{0pt} + +\edef\@IEEEeqnarrayTHEmasterstrutheight{0pt} % default height and depth of +\edef\@IEEEeqnarrayTHEmasterstrutdepth{0pt} % struts within an IEEEeqnarray + +\edef\@IEEEeqnarrayTHEmasterstrutHSAVE{0pt} % saved master strut height +\edef\@IEEEeqnarrayTHEmasterstrutDSAVE{0pt} % and depth + +\newif\if@IEEEeqnarrayusemasterstrut % flag to indicate that the master strut value +\@IEEEeqnarrayusemasterstruttrue % is to be used + + + +% saves the strut height and depth of the master strut +\def\@IEEEeqnarraymasterstrutsave{\relax% +\expandafter\skip0=\@IEEEeqnarrayTHEmasterstrutheight\relax% +\expandafter\skip2=\@IEEEeqnarrayTHEmasterstrutdepth\relax% +% remove stretchability +\dimen0\skip0\relax% +\dimen2\skip2\relax% +% save values +\edef\@IEEEeqnarrayTHEmasterstrutHSAVE{\the\dimen0}% +\edef\@IEEEeqnarrayTHEmasterstrutDSAVE{\the\dimen2}} + +% restores the strut height and depth of the master strut +\def\@IEEEeqnarraymasterstrutrestore{\relax% +\expandafter\skip0=\@IEEEeqnarrayTHEmasterstrutHSAVE\relax% +\expandafter\skip2=\@IEEEeqnarrayTHEmasterstrutDSAVE\relax% +% remove stretchability +\dimen0\skip0\relax% +\dimen2\skip2\relax% +% restore values +\edef\@IEEEeqnarrayTHEmasterstrutheight{\the\dimen0}% +\edef\@IEEEeqnarrayTHEmasterstrutdepth{\the\dimen2}} + + +% globally restores the strut height and depth to the +% master values and sets the master strut flag to true +\def\@IEEEeqnarraystrutreset{\relax% +\expandafter\skip0=\@IEEEeqnarrayTHEmasterstrutheight\relax% +\expandafter\skip2=\@IEEEeqnarrayTHEmasterstrutdepth\relax% +% remove stretchability +\dimen0\skip0\relax% +\dimen2\skip2\relax% +% restore values +\xdef\@IEEEeqnarrayTHEstrutheight{\the\dimen0}% +\xdef\@IEEEeqnarrayTHEstrutdepth{\the\dimen2}% +\global\@IEEEeqnarrayusemasterstruttrue} + + +% if the master strut is not to be used, make the current +% values of \@IEEEeqnarrayTHEstrutheight, \@IEEEeqnarrayTHEstrutdepth +% and the use master strut flag, global +% this allows user strut commands issued in the last column to be carried +% into the isolation/strut column +\def\@IEEEeqnarrayglobalizestrutstatus{\relax% +\if@IEEEeqnarrayusemasterstrut\else% +\xdef\@IEEEeqnarrayTHEstrutheight{\@IEEEeqnarrayTHEstrutheight}% +\xdef\@IEEEeqnarrayTHEstrutdepth{\@IEEEeqnarrayTHEstrutdepth}% +\global\@IEEEeqnarrayusemasterstrutfalse% +\fi} + + + +% usage: \IEEEeqnarraystrutsize{height}{depth}[font size commands] +% If called outside the lines of an IEEEeqnarray, sets the height +% and depth of both the master and local struts. If called inside +% an IEEEeqnarray line, sets the height and depth of the local strut +% only and sets the flag to indicate the use of the local strut +% values. If the height or depth is left blank, 0.7\normalbaselineskip +% and 0.3\normalbaselineskip will be used, respectively. +% The optional argument can be used to evaluate the lengths under +% a different font size and styles. If none is specified, the current +% font is used. +% uses scratch registers \skip0, \skip2, \skip3, \dimen0, \dimen2 +\def\IEEEeqnarraystrutsize#1#2{\relax\@ifnextchar[{\@IEEEeqnarraystrutsize{#1}{#2}}{\@IEEEeqnarraystrutsize{#1}{#2}[\relax]}} +\def\@IEEEeqnarraystrutsize#1#2[#3]{\def\@IEEEeqnarraystrutsizeARG{#1}% +\ifx\@IEEEeqnarraystrutsizeARG\@empty% +{\setbox0=\hbox{#3\relax\global\skip3=0.7\normalbaselineskip}}% +\skip0=\skip3\relax% +\else% arg one present +{\setbox0=\hbox{#3\relax\global\skip3=#1\relax}}% +\skip0=\skip3\relax% +\fi% if null arg +\def\@IEEEeqnarraystrutsizeARG{#2}% +\ifx\@IEEEeqnarraystrutsizeARG\@empty% +{\setbox0=\hbox{#3\relax\global\skip3=0.3\normalbaselineskip}}% +\skip2=\skip3\relax% +\else% arg two present +{\setbox0=\hbox{#3\relax\global\skip3=#2\relax}}% +\skip2=\skip3\relax% +\fi% if null arg +% remove stretchability, just to be safe +\dimen0\skip0\relax% +\dimen2\skip2\relax% +% dimen0 = height, dimen2 = depth +\if@IEEEeqnarrayISinner% inner does not touch master strut size +\edef\@IEEEeqnarrayTHEstrutheight{\the\dimen0}% +\edef\@IEEEeqnarrayTHEstrutdepth{\the\dimen2}% +\@IEEEeqnarrayusemasterstrutfalse% do not use master +\else% outer, have to set master strut too +\edef\@IEEEeqnarrayTHEmasterstrutheight{\the\dimen0}% +\edef\@IEEEeqnarrayTHEmasterstrutdepth{\the\dimen2}% +\edef\@IEEEeqnarrayTHEstrutheight{\the\dimen0}% +\edef\@IEEEeqnarrayTHEstrutdepth{\the\dimen2}% +\@IEEEeqnarrayusemasterstruttrue% use master strut +\fi} + + +% usage: \IEEEeqnarraystrutsizeadd{added height}{added depth}[font size commands] +% If called outside the lines of an IEEEeqnarray, adds the given height +% and depth to both the master and local struts. +% If called inside an IEEEeqnarray line, adds the given height and depth +% to the local strut only and sets the flag to indicate the use +% of the local strut values. +% In both cases, if a height or depth is left blank, 0pt is used instead. +% The optional argument can be used to evaluate the lengths under +% a different font size and styles. If none is specified, the current +% font is used. +% uses scratch registers \skip0, \skip2, \skip3, \dimen0, \dimen2 +\def\IEEEeqnarraystrutsizeadd#1#2{\relax\@ifnextchar[{\@IEEEeqnarraystrutsizeadd{#1}{#2}}{\@IEEEeqnarraystrutsizeadd{#1}{#2}[\relax]}} +\def\@IEEEeqnarraystrutsizeadd#1#2[#3]{\def\@IEEEeqnarraystrutsizearg{#1}% +\ifx\@IEEEeqnarraystrutsizearg\@empty% +\skip0=0pt\relax% +\else% arg one present +{\setbox0=\hbox{#3\relax\global\skip3=#1}}% +\skip0=\skip3\relax% +\fi% if null arg +\def\@IEEEeqnarraystrutsizearg{#2}% +\ifx\@IEEEeqnarraystrutsizearg\@empty% +\skip2=0pt\relax% +\else% arg two present +{\setbox0=\hbox{#3\relax\global\skip3=#2}}% +\skip2=\skip3\relax% +\fi% if null arg +% remove stretchability, just to be safe +\dimen0\skip0\relax% +\dimen2\skip2\relax% +% dimen0 = height, dimen2 = depth +\if@IEEEeqnarrayISinner% inner does not touch master strut size +% get local strut size +\expandafter\skip0=\@IEEEeqnarrayTHEstrutheight\relax% +\expandafter\skip2=\@IEEEeqnarrayTHEstrutdepth\relax% +% add it to the user supplied values +\advance\dimen0 by \skip0\relax% +\advance\dimen2 by \skip2\relax% +% update the local strut size +\edef\@IEEEeqnarrayTHEstrutheight{\the\dimen0}% +\edef\@IEEEeqnarrayTHEstrutdepth{\the\dimen2}% +\@IEEEeqnarrayusemasterstrutfalse% do not use master +\else% outer, have to set master strut too +% get master strut size +\expandafter\skip0=\@IEEEeqnarrayTHEmasterstrutheight\relax% +\expandafter\skip2=\@IEEEeqnarrayTHEmasterstrutdepth\relax% +% add it to the user supplied values +\advance\dimen0 by \skip0\relax% +\advance\dimen2 by \skip2\relax% +% update the local and master strut sizes +\edef\@IEEEeqnarrayTHEmasterstrutheight{\the\dimen0}% +\edef\@IEEEeqnarrayTHEmasterstrutdepth{\the\dimen2}% +\edef\@IEEEeqnarrayTHEstrutheight{\the\dimen0}% +\edef\@IEEEeqnarrayTHEstrutdepth{\the\dimen2}% +\@IEEEeqnarrayusemasterstruttrue% use master strut +\fi} + + +% allow user a way to see the struts +\newif\ifIEEEvisiblestruts +\IEEEvisiblestrutsfalse + +% inserts an invisible strut using the master or local strut values +% uses scratch registers \skip0, \skip2, \dimen0, \dimen2 +\def\@IEEEeqnarrayinsertstrut{\relax% +\if@IEEEeqnarrayusemasterstrut +% get master strut size +\expandafter\skip0=\@IEEEeqnarrayTHEmasterstrutheight\relax% +\expandafter\skip2=\@IEEEeqnarrayTHEmasterstrutdepth\relax% +\else% +% get local strut size +\expandafter\skip0=\@IEEEeqnarrayTHEstrutheight\relax% +\expandafter\skip2=\@IEEEeqnarrayTHEstrutdepth\relax% +\fi% +% remove stretchability, probably not needed +\dimen0\skip0\relax% +\dimen2\skip2\relax% +% dimen0 = height, dimen2 = depth +% allow user to see struts if desired +\ifIEEEvisiblestruts% +\vrule width0.2pt height\dimen0 depth\dimen2\relax% +\else% +\vrule width0pt height\dimen0 depth\dimen2\relax\fi} + + +% creates an invisible strut, useable even outside \IEEEeqnarray +% if \IEEEvisiblestrutstrue, the strut will be visible and 0.2pt wide. +% usage: \IEEEstrut[height][depth][font size commands] +% default is \IEEEstrut[0.7\normalbaselineskip][0.3\normalbaselineskip][\relax] +% blank arguments inherit the default values +% uses \dimen0, \dimen2, \skip0, \skip2 +\def\IEEEstrut{\relax\@ifnextchar[{\@IEEEstrut}{\@IEEEstrut[0.7\normalbaselineskip]}} +\def\@IEEEstrut[#1]{\relax\@ifnextchar[{\@@IEEEstrut[#1]}{\@@IEEEstrut[#1][0.3\normalbaselineskip]}} +\def\@@IEEEstrut[#1][#2]{\relax\@ifnextchar[{\@@@IEEEstrut[#1][#2]}{\@@@IEEEstrut[#1][#2][\relax]}} +\def\@@@IEEEstrut[#1][#2][#3]{\mbox{#3\relax% +\def\@IEEEstrutARG{#1}% +\ifx\@IEEEstrutARG\@empty% +\skip0=0.7\normalbaselineskip\relax% +\else% +\skip0=#1\relax% +\fi% +\def\@IEEEstrutARG{#2}% +\ifx\@IEEEstrutARG\@empty% +\skip2=0.3\normalbaselineskip\relax% +\else% +\skip2=#2\relax% +\fi% +% remove stretchability, probably not needed +\dimen0\skip0\relax% +\dimen2\skip2\relax% +\ifIEEEvisiblestruts% +\vrule width0.2pt height\dimen0 depth\dimen2\relax% +\else% +\vrule width0.0pt height\dimen0 depth\dimen2\relax\fi}} + + +% enables strut mode by setting a default strut size and then zeroing the +% \baselineskip, \lineskip, \lineskiplimit and \jot +\def\IEEEeqnarraystrutmode{\IEEEeqnarraystrutsize{0.7\normalbaselineskip}{0.3\normalbaselineskip}[\relax]% +\baselineskip=0pt\lineskip=0pt\lineskiplimit=0pt\jot=0pt} + + + +\def\IEEEeqnarray{\@IEEEeqnarraystarformfalse\@IEEEeqnarray} +\def\endIEEEeqnarray{\end@IEEEeqnarray} + +\@namedef{IEEEeqnarray*}{\@IEEEeqnarraystarformtrue\@IEEEeqnarray} +\@namedef{endIEEEeqnarray*}{\end@IEEEeqnarray} + + +% \IEEEeqnarray is an enhanced \eqnarray. +% The star form defaults to not putting equation numbers at the end of each row. +% usage: \IEEEeqnarray[decl]{cols} +\def\@IEEEeqnarray{\relax\@ifnextchar[{\@@IEEEeqnarray}{\@@IEEEeqnarray[\relax]}} +\def\@@IEEEeqnarray[#1]#2{% + % default to showing the equation number or not based on whether or not + % the star form was involked + \if@IEEEeqnarraystarform\global\@eqnswfalse + \else% not the star form + \global\@eqnswtrue + \fi% if star form + \@IEEEissubequationfalse% default to no subequations + \@IEEElastlinewassubequationfalse% assume last line is not a sub equation + \@IEEEeqnarrayISinnerfalse% not yet within the lines of the halign + \@IEEEeqnarraystrutsize{0pt}{0pt}[\relax]% turn off struts by default + \@IEEEeqnarrayusemasterstruttrue% use master strut till user asks otherwise + \IEEEvisiblestrutsfalse% diagnostic mode defaults to off + % no extra space unless the user specifically requests it + \lineskip=0pt\relax + \lineskiplimit=0pt\relax + \baselineskip=\normalbaselineskip\relax% + \jot=\IEEEnormaljot\relax% + \mathsurround\z@\relax% no extra spacing around math + \@advanceIEEEeqncolcnttrue% advance the col counter for each col the user uses, + % used in \IEEEeqnarraymulticol and in the preamble build + \stepcounter{equation}% advance equation counter before first line + \setcounter{IEEEsubequation}{0}% no subequation yet + \def\@currentlabel{\p@equation\theequation}% redefine the ref label + \IEEEeqnarraydecl\relax% allow a way for the user to make global overrides + #1\relax% allow user to override defaults + \let\\\@IEEEeqnarraycr% replace newline with one that can put in eqn. numbers + \global\@IEEEeqncolcnt\z@% col. count = 0 for first line + \@IEEEbuildpreamble #2\end\relax% build the preamble and put it into \@IEEEtrantmptoksA + % put in the column for the equation number + \ifnum\@IEEEeqnnumcols>0\relax\@IEEEappendtoksA{&}\fi% col separator for those after the first + \toks0={##}% + % advance the \@IEEEeqncolcnt for the isolation col, this helps with error checking + \@IEEEappendtoksA{\global\advance\@IEEEeqncolcnt by 1\relax}% + % add the isolation column + \@IEEEappendtoksA{\tabskip\z@skip\bgroup\the\toks0\egroup}% + % advance the \@IEEEeqncolcnt for the equation number col, this helps with error checking + \@IEEEappendtoksA{&\global\advance\@IEEEeqncolcnt by 1\relax}% + % add the equation number col to the preamble + \@IEEEappendtoksA{\tabskip\z@skip\hb@xt@\z@\bgroup\hss\the\toks0\egroup}% + % note \@IEEEeqnnumcols does not count the equation col or isolation col + % set the starting tabskip glue as determined by the preamble build + \tabskip=\@IEEEBPstartglue\relax + % begin the display alignment + \@IEEEeqnarrayISinnertrue% commands are now within the lines + $$\everycr{}\halign to\displaywidth\bgroup + % "exspand" the preamble + \span\the\@IEEEtrantmptoksA\cr} + +% enter isolation/strut column (or the next column if the user did not use +% every column), record the strut status, complete the columns, do the strut if needed, +% restore counters to correct values and exit +\def\end@IEEEeqnarray{\@IEEEeqnarrayglobalizestrutstatus&\@@IEEEeqnarraycr\egroup% +\if@IEEElastlinewassubequation\global\advance\c@IEEEsubequation\m@ne\fi% +\global\advance\c@equation\m@ne% +$$\@ignoretrue} + +% need a way to remember if last line is a subequation +\newif\if@IEEElastlinewassubequation% +\@IEEElastlinewassubequationfalse + +% IEEEeqnarray uses a modifed \\ instead of the plain \cr to +% end rows. This allows for things like \\*[vskip amount] +% This "cr" macros are modified versions those for LaTeX2e's eqnarray +% the {\ifnum0=`} braces must be kept away from the last column to avoid +% altering spacing of its math, so we use & to advance to the next column +% as there is an isolation/strut column after the user's columns +\def\@IEEEeqnarraycr{\@IEEEeqnarrayglobalizestrutstatus&% save strut status and advance to next column + {\ifnum0=`}\fi + \@ifstar{% + \global\@eqpen\@M\@IEEEeqnarrayYCR + }{% + \global\@eqpen\interdisplaylinepenalty \@IEEEeqnarrayYCR + }% +} + +\def\@IEEEeqnarrayYCR{\@testopt\@IEEEeqnarrayXCR\z@skip} + +\def\@IEEEeqnarrayXCR[#1]{% + \ifnum0=`{\fi}% + \@@IEEEeqnarraycr + \noalign{\penalty\@eqpen\vskip\jot\vskip #1\relax}}% + +\def\@@IEEEeqnarraycr{\@IEEEtrantmptoksA={}% clear token register + \advance\@IEEEeqncolcnt by -1\relax% adjust col count because of the isolation column + \ifnum\@IEEEeqncolcnt>\@IEEEeqnnumcols\relax + \@IEEEclspkgerror{Too many columns within the IEEEeqnarray\MessageBreak + environment}% + {Use fewer \string &'s or put more columns in the IEEEeqnarry column\MessageBreak + specifications.}\relax% + \else + \loop% add cols if the user did not use them all + \ifnum\@IEEEeqncolcnt<\@IEEEeqnnumcols\relax + \@IEEEappendtoksA{&}% + \advance\@IEEEeqncolcnt by 1\relax% update the col count + \repeat + % this number of &'s will take us the the isolation column + \fi + % execute the &'s + \the\@IEEEtrantmptoksA% + % handle the strut/isolation column + \@IEEEeqnarrayinsertstrut% do the strut if needed + \@IEEEeqnarraystrutreset% reset the strut system for next line or IEEEeqnarray + &% and enter the equation number column + % is this line needs an equation number, display it and advance the + % (sub)equation counters, record what type this line was + \if@eqnsw% + \if@IEEEissubequation\theIEEEsubequationdis\addtocounter{equation}{1}\stepcounter{IEEEsubequation}% + \global\@IEEElastlinewassubequationtrue% + \else% display a standard equation number, initialize the IEEEsubequation counter + \theequationdis\stepcounter{equation}\setcounter{IEEEsubequation}{0}% + \global\@IEEElastlinewassubequationfalse\fi% + \fi% + % reset the eqnsw flag to indicate default preference of the display of equation numbers + \if@IEEEeqnarraystarform\global\@eqnswfalse\else\global\@eqnswtrue\fi + \global\@IEEEissubequationfalse% reset the subequation flag + % reset the number of columns the user actually used + \global\@IEEEeqncolcnt\z@\relax + % the real end of the line + \cr} + + + + + +% \IEEEeqnarraybox is like \IEEEeqnarray except the box form puts everything +% inside a vtop, vbox, or vcenter box depending on the letter in the second +% optional argument (t,b,c). Vbox is the default. Unlike \IEEEeqnarray, +% equation numbers are not displayed and \IEEEeqnarraybox can be nested. +% \IEEEeqnarrayboxm is for math mode (like \array) and does not put the vbox +% within an hbox. +% \IEEEeqnarrayboxt is for text mode (like \tabular) and puts the vbox within +% a \hbox{$ $} construct. +% \IEEEeqnarraybox will auto detect whether to use \IEEEeqnarrayboxm or +% \IEEEeqnarrayboxt depending on the math mode. +% The third optional argument specifies the width this box is to be set to - +% natural width is the default. +% The * forms do not add \jot line spacing +% usage: \IEEEeqnarraybox[decl][pos][width]{cols} +\def\IEEEeqnarrayboxm{\@IEEEeqnarraystarformfalse\@IEEEeqnarrayboxHBOXSWfalse\@IEEEeqnarraybox} +\def\endIEEEeqnarrayboxm{\end@IEEEeqnarraybox} +\@namedef{IEEEeqnarrayboxm*}{\@IEEEeqnarraystarformtrue\@IEEEeqnarrayboxHBOXSWfalse\@IEEEeqnarraybox} +\@namedef{endIEEEeqnarrayboxm*}{\end@IEEEeqnarraybox} + +\def\IEEEeqnarrayboxt{\@IEEEeqnarraystarformfalse\@IEEEeqnarrayboxHBOXSWtrue\@IEEEeqnarraybox} +\def\endIEEEeqnarrayboxt{\end@IEEEeqnarraybox} +\@namedef{IEEEeqnarrayboxt*}{\@IEEEeqnarraystarformtrue\@IEEEeqnarrayboxHBOXSWtrue\@IEEEeqnarraybox} +\@namedef{endIEEEeqnarrayboxt*}{\end@IEEEeqnarraybox} + +\def\IEEEeqnarraybox{\@IEEEeqnarraystarformfalse\ifmmode\@IEEEeqnarrayboxHBOXSWfalse\else\@IEEEeqnarrayboxHBOXSWtrue\fi% +\@IEEEeqnarraybox} +\def\endIEEEeqnarraybox{\end@IEEEeqnarraybox} + +\@namedef{IEEEeqnarraybox*}{\@IEEEeqnarraystarformtrue\ifmmode\@IEEEeqnarrayboxHBOXSWfalse\else\@IEEEeqnarrayboxHBOXSWtrue\fi% +\@IEEEeqnarraybox} +\@namedef{endIEEEeqnarraybox*}{\end@IEEEeqnarraybox} + +% flag to indicate if the \IEEEeqnarraybox needs to put things into an hbox{$ $} +% for \vcenter in non-math mode +\newif\if@IEEEeqnarrayboxHBOXSW% +\@IEEEeqnarrayboxHBOXSWfalse + +\def\@IEEEeqnarraybox{\relax\@ifnextchar[{\@@IEEEeqnarraybox}{\@@IEEEeqnarraybox[\relax]}} +\def\@@IEEEeqnarraybox[#1]{\relax\@ifnextchar[{\@@@IEEEeqnarraybox[#1]}{\@@@IEEEeqnarraybox[#1][b]}} +\def\@@@IEEEeqnarraybox[#1][#2]{\relax\@ifnextchar[{\@@@@IEEEeqnarraybox[#1][#2]}{\@@@@IEEEeqnarraybox[#1][#2][\relax]}} + +% #1 = decl; #2 = t,b,c; #3 = width, #4 = col specs +\def\@@@@IEEEeqnarraybox[#1][#2][#3]#4{\@IEEEeqnarrayISinnerfalse % not yet within the lines of the halign + \@IEEEeqnarraymasterstrutsave% save current master strut values + \@IEEEeqnarraystrutsize{0pt}{0pt}[\relax]% turn off struts by default + \@IEEEeqnarrayusemasterstruttrue% use master strut till user asks otherwise + \IEEEvisiblestrutsfalse% diagnostic mode defaults to off + % no extra space unless the user specifically requests it + \lineskip=0pt\relax% + \lineskiplimit=0pt\relax% + \baselineskip=\normalbaselineskip\relax% + \jot=\IEEEnormaljot\relax% + \mathsurround\z@\relax% no extra spacing around math + % the default end glues are zero for an \IEEEeqnarraybox + \edef\@IEEEeqnarraycolSEPdefaultstart{\@IEEEeqnarraycolSEPzero}% default start glue + \edef\@IEEEeqnarraycolSEPdefaultend{\@IEEEeqnarraycolSEPzero}% default end glue + \edef\@IEEEeqnarraycolSEPdefaultmid{\@IEEEeqnarraycolSEPzero}% default inter-column glue + \@advanceIEEEeqncolcntfalse% do not advance the col counter for each col the user uses, + % used in \IEEEeqnarraymulticol and in the preamble build + \IEEEeqnarrayboxdecl\relax% allow a way for the user to make global overrides + #1\relax% allow user to override defaults + \let\\\@IEEEeqnarrayboxcr% replace newline with one that allows optional spacing + \@IEEEbuildpreamble #4\end\relax% build the preamble and put it into \@IEEEtrantmptoksA + % add an isolation column to the preamble to stop \\'s {} from getting into the last col + \ifnum\@IEEEeqnnumcols>0\relax\@IEEEappendtoksA{&}\fi% col separator for those after the first + \toks0={##}% + % add the isolation column to the preamble + \@IEEEappendtoksA{\tabskip\z@skip\bgroup\the\toks0\egroup}% + % set the starting tabskip glue as determined by the preamble build + \tabskip=\@IEEEBPstartglue\relax + % begin the alignment + \everycr{}% + % use only the very first token to determine the positioning + % this stops some problems when the user uses more than one letter, + % but is probably not worth the effort + % \noindent is used as a delimiter + \def\@IEEEgrabfirstoken##1##2\noindent{\let\@IEEEgrabbedfirstoken=##1}% + \@IEEEgrabfirstoken#2\relax\relax\noindent + % \@IEEEgrabbedfirstoken has the first token, the rest are discarded + % if we need to put things into and hbox and go into math mode, do so now + \if@IEEEeqnarrayboxHBOXSW \leavevmode \hbox \bgroup $\fi% + % use the appropriate vbox type + \if\@IEEEgrabbedfirstoken t\relax\vtop\else\if\@IEEEgrabbedfirstoken c\relax% + \vcenter\else\vbox\fi\fi\bgroup% + \@IEEEeqnarrayISinnertrue% commands are now within the lines + \ifx#3\relax\halign\else\halign to #3\relax\fi% + \bgroup + % "exspand" the preamble + \span\the\@IEEEtrantmptoksA\cr} + +% carry strut status and enter the isolation/strut column, +% exit from math mode if needed, and exit +\def\end@IEEEeqnarraybox{\@IEEEeqnarrayglobalizestrutstatus% carry strut status +&% enter isolation/strut column +\@IEEEeqnarrayinsertstrut% do strut if needed +\@IEEEeqnarraymasterstrutrestore% restore the previous master strut values +% reset the strut system for next IEEEeqnarray +% (sets local strut values back to previous master strut values) +\@IEEEeqnarraystrutreset% +% ensure last line, exit from halign, close vbox +\crcr\egroup\egroup% +% exit from math mode and close hbox if needed +\if@IEEEeqnarrayboxHBOXSW $\egroup\fi} + + + +% IEEEeqnarraybox uses a modifed \\ instead of the plain \cr to +% end rows. This allows for things like \\[vskip amount] +% This "cr" macros are modified versions those for LaTeX2e's eqnarray +% For IEEEeqnarraybox, \\* is the same as \\ +% the {\ifnum0=`} braces must be kept away from the last column to avoid +% altering spacing of its math, so we use & to advance to the isolation/strut column +% carry strut status into isolation/strut column +\def\@IEEEeqnarrayboxcr{\@IEEEeqnarrayglobalizestrutstatus% carry strut status +&% enter isolation/strut column +\@IEEEeqnarrayinsertstrut% do strut if needed +% reset the strut system for next line or IEEEeqnarray +\@IEEEeqnarraystrutreset% +{\ifnum0=`}\fi% +\@ifstar{\@IEEEeqnarrayboxYCR}{\@IEEEeqnarrayboxYCR}} + +% test and setup the optional argument to \\[] +\def\@IEEEeqnarrayboxYCR{\@testopt\@IEEEeqnarrayboxXCR\z@skip} + +% IEEEeqnarraybox does not automatically increase line spacing by \jot +\def\@IEEEeqnarrayboxXCR[#1]{\ifnum0=`{\fi}% +\cr\noalign{\if@IEEEeqnarraystarform\else\vskip\jot\fi\vskip#1\relax}} + + + +% starts the halign preamble build +\def\@IEEEbuildpreamble{\@IEEEtrantmptoksA={}% clear token register +\let\@IEEEBPcurtype=u%current column type is not yet known +\let\@IEEEBPprevtype=s%the previous column type was the start +\let\@IEEEBPnexttype=u%next column type is not yet known +% ensure these are valid +\def\@IEEEBPcurglue={0pt plus 0pt minus 0pt}% +\def\@IEEEBPcurcolname{@IEEEdefault}% name of current column definition +% currently acquired numerically referenced glue +% use a name that is easier to remember +\let\@IEEEBPcurnum=\@IEEEtrantmpcountA% +\@IEEEBPcurnum=0% +% tracks number of columns in the preamble +\@IEEEeqnnumcols=0% +% record the default end glues +\edef\@IEEEBPstartglue{\@IEEEeqnarraycolSEPdefaultstart}% +\edef\@IEEEBPendglue{\@IEEEeqnarraycolSEPdefaultend}% +% now parse the user's column specifications +\@@IEEEbuildpreamble} + + +% parses and builds the halign preamble +\def\@@IEEEbuildpreamble#1#2{\let\@@nextIEEEbuildpreamble=\@@IEEEbuildpreamble% +% use only the very first token to check the end +% \noindent is used as a delimiter as \end can be present here +\def\@IEEEgrabfirstoken##1##2\noindent{\let\@IEEEgrabbedfirstoken=##1}% +\@IEEEgrabfirstoken#1\relax\relax\noindent +\ifx\@IEEEgrabbedfirstoken\end\let\@@nextIEEEbuildpreamble=\@@IEEEfinishpreamble\else% +% identify current and next token type +\@IEEEgetcoltype{#1}{\@IEEEBPcurtype}{1}% current, error on invalid +\@IEEEgetcoltype{#2}{\@IEEEBPnexttype}{0}% next, no error on invalid next +% if curtype is a glue, get the glue def +\if\@IEEEBPcurtype g\@IEEEgetcurglue{#1}{\@IEEEBPcurglue}\fi% +% if curtype is a column, get the column def and set the current column name +\if\@IEEEBPcurtype c\@IEEEgetcurcol{#1}\fi% +% if curtype is a numeral, acquire the user defined glue +\if\@IEEEBPcurtype n\@IEEEprocessNcol{#1}\fi% +% process the acquired glue +\if\@IEEEBPcurtype g\@IEEEprocessGcol\fi% +% process the acquired col +\if\@IEEEBPcurtype c\@IEEEprocessCcol\fi% +% ready prevtype for next col spec. +\let\@IEEEBPprevtype=\@IEEEBPcurtype% +% be sure and put back the future token(s) as a group +\fi\@@nextIEEEbuildpreamble{#2}} + + +% executed just after preamble build is completed +% warn about zero cols, and if prevtype type = u, put in end tabskip glue +\def\@@IEEEfinishpreamble#1{\ifnum\@IEEEeqnnumcols<1\relax +\@IEEEclspkgerror{No column specifiers declared for IEEEeqnarray}% +{At least one column type must be declared for each IEEEeqnarray.}% +\fi%num cols less than 1 +%if last type undefined, set default end tabskip glue +\if\@IEEEBPprevtype u\@IEEEappendtoksA{\tabskip=\@IEEEBPendglue}\fi} + + +% Identify and return the column specifier's type code +\def\@IEEEgetcoltype#1#2#3{% +% use only the very first token to determine the type +% \noindent is used as a delimiter as \end can be present here +\def\@IEEEgrabfirstoken##1##2\noindent{\let\@IEEEgrabbedfirstoken=##1}% +\@IEEEgrabfirstoken#1\relax\relax\noindent +% \@IEEEgrabfirstoken has the first token, the rest are discarded +% n = number +% g = glue (any other char in catagory 12) +% c = letter +% e = \end +% u = undefined +% third argument: 0 = no error message, 1 = error on invalid char +\let#2=u\relax% assume invalid until know otherwise +\ifx\@IEEEgrabbedfirstoken\end\let#2=e\else +\ifcat\@IEEEgrabbedfirstoken\relax\else% screen out control sequences +\if0\@IEEEgrabbedfirstoken\let#2=n\else +\if1\@IEEEgrabbedfirstoken\let#2=n\else +\if2\@IEEEgrabbedfirstoken\let#2=n\else +\if3\@IEEEgrabbedfirstoken\let#2=n\else +\if4\@IEEEgrabbedfirstoken\let#2=n\else +\if5\@IEEEgrabbedfirstoken\let#2=n\else +\if6\@IEEEgrabbedfirstoken\let#2=n\else +\if7\@IEEEgrabbedfirstoken\let#2=n\else +\if8\@IEEEgrabbedfirstoken\let#2=n\else +\if9\@IEEEgrabbedfirstoken\let#2=n\else +\ifcat,\@IEEEgrabbedfirstoken\let#2=g\relax +\else\ifcat a\@IEEEgrabbedfirstoken\let#2=c\relax\fi\fi\fi\fi\fi\fi\fi\fi\fi\fi\fi\fi\fi\fi +\if#2u\relax +\if0\noexpand#3\relax\else\@IEEEclspkgerror{Invalid character in column specifications}% +{Only letters, numerals and certain other symbols are allowed \MessageBreak +as IEEEeqnarray column specifiers.}\fi\fi} + + +% identify the current letter referenced column +% if invalid, use a default column +\def\@IEEEgetcurcol#1{\expandafter\ifx\csname @IEEEeqnarraycolDEF#1\endcsname\@IEEEeqnarraycolisdefined% +\def\@IEEEBPcurcolname{#1}\else% invalid column name +\@IEEEclspkgerror{Invalid column type "#1" in column specifications.\MessageBreak +Using a default centering column instead}% +{You must define IEEEeqnarray column types before use.}% +\def\@IEEEBPcurcolname{@IEEEdefault}\fi} + + +% identify and return the predefined (punctuation) glue value +\def\@IEEEgetcurglue#1#2{% +% ! = \! (neg small) -0.16667em (-3/18 em) +% , = \, (small) 0.16667em ( 3/18 em) +% : = \: (med) 0.22222em ( 4/18 em) +% ; = \; (large) 0.27778em ( 5/18 em) +% ' = \quad 1em +% " = \qquad 2em +% . = 0.5\arraycolsep +% / = \arraycolsep +% ? = 2\arraycolsep +% * = 1fil +% + = \@IEEEeqnarraycolSEPcenter +% - = \@IEEEeqnarraycolSEPzero +% Note that all em values are referenced to the math font (textfont2) fontdimen6 +% value for 1em. +% +% use only the very first token to determine the type +% this prevents errant tokens from getting in the main text +% \noindent is used as a delimiter here +\def\@IEEEgrabfirstoken##1##2\noindent{\let\@IEEEgrabbedfirstoken=##1}% +\@IEEEgrabfirstoken#1\relax\relax\noindent +% get the math font 1em value +% LaTeX2e's NFSS2 does not preload the fonts, but \IEEEeqnarray needs +% to gain access to the math (\textfont2) font's spacing parameters. +% So we create a bogus box here that uses the math font to ensure +% that \textfont2 is loaded and ready. If this is not done, +% the \textfont2 stuff here may not work. +% Thanks to Bernd Raichle for his 1997 post on this topic. +{\setbox0=\hbox{$\displaystyle\relax$}}% +% fontdimen6 has the width of 1em (a quad). +\@IEEEtrantmpdimenA=\fontdimen6\textfont2\relax% +% identify the glue value based on the first token +% we discard anything after the first +\if!\@IEEEgrabbedfirstoken\@IEEEtrantmpdimenA=-0.16667\@IEEEtrantmpdimenA\edef#2{\the\@IEEEtrantmpdimenA}\else +\if,\@IEEEgrabbedfirstoken\@IEEEtrantmpdimenA=0.16667\@IEEEtrantmpdimenA\edef#2{\the\@IEEEtrantmpdimenA}\else +\if:\@IEEEgrabbedfirstoken\@IEEEtrantmpdimenA=0.22222\@IEEEtrantmpdimenA\edef#2{\the\@IEEEtrantmpdimenA}\else +\if;\@IEEEgrabbedfirstoken\@IEEEtrantmpdimenA=0.27778\@IEEEtrantmpdimenA\edef#2{\the\@IEEEtrantmpdimenA}\else +\if'\@IEEEgrabbedfirstoken\@IEEEtrantmpdimenA=1\@IEEEtrantmpdimenA\edef#2{\the\@IEEEtrantmpdimenA}\else +\if"\@IEEEgrabbedfirstoken\@IEEEtrantmpdimenA=2\@IEEEtrantmpdimenA\edef#2{\the\@IEEEtrantmpdimenA}\else +\if.\@IEEEgrabbedfirstoken\@IEEEtrantmpdimenA=0.5\arraycolsep\edef#2{\the\@IEEEtrantmpdimenA}\else +\if/\@IEEEgrabbedfirstoken\edef#2{\the\arraycolsep}\else +\if?\@IEEEgrabbedfirstoken\@IEEEtrantmpdimenA=2\arraycolsep\edef#2{\the\@IEEEtrantmpdimenA}\else +\if *\@IEEEgrabbedfirstoken\edef#2{0pt plus 1fil minus 0pt}\else +\if+\@IEEEgrabbedfirstoken\edef#2{\@IEEEeqnarraycolSEPcenter}\else +\if-\@IEEEgrabbedfirstoken\edef#2{\@IEEEeqnarraycolSEPzero}\else +\edef#2{\@IEEEeqnarraycolSEPzero}% +\@IEEEclspkgerror{Invalid predefined inter-column glue type "#1" in\MessageBreak +column specifications. Using a default value of\MessageBreak +0pt instead}% +{Only !,:;'"./?*+ and - are valid predefined glue types in the\MessageBreak +IEEEeqnarray column specifications.}\fi\fi\fi\fi\fi\fi\fi\fi\fi\fi\fi\fi} + + + +% process a numerical digit from the column specification +% and look up the corresponding user defined glue value +% can transform current type from n to g or a as the user defined glue is acquired +\def\@IEEEprocessNcol#1{\if\@IEEEBPprevtype g% +\@IEEEclspkgerror{Back-to-back inter-column glue specifiers in column\MessageBreak +specifications. Ignoring consecutive glue specifiers\MessageBreak +after the first}% +{You cannot have two or more glue types next to each other\MessageBreak +in the IEEEeqnarray column specifications.}% +\let\@IEEEBPcurtype=a% abort this glue, future digits will be discarded +\@IEEEBPcurnum=0\relax% +\else% if we previously aborted a glue +\if\@IEEEBPprevtype a\@IEEEBPcurnum=0\let\@IEEEBPcurtype=a%maintain digit abortion +\else%acquire this number +% save the previous type before the numerical digits started +\if\@IEEEBPprevtype n\else\let\@IEEEBPprevsavedtype=\@IEEEBPprevtype\fi% +\multiply\@IEEEBPcurnum by 10\relax% +\advance\@IEEEBPcurnum by #1\relax% add in number, \relax is needed to stop TeX's number scan +\if\@IEEEBPnexttype n\else%close acquisition +\expandafter\ifx\csname @IEEEeqnarraycolSEPDEF\expandafter\romannumeral\number\@IEEEBPcurnum\endcsname\@IEEEeqnarraycolisdefined% +\edef\@IEEEBPcurglue{\csname @IEEEeqnarraycolSEP\expandafter\romannumeral\number\@IEEEBPcurnum\endcsname}% +\else%user glue not defined +\@IEEEclspkgerror{Invalid user defined inter-column glue type "\number\@IEEEBPcurnum" in\MessageBreak +column specifications. Using a default value of\MessageBreak +0pt instead}% +{You must define all IEEEeqnarray numerical inter-column glue types via\MessageBreak +\string\IEEEeqnarraydefcolsep \space before they are used in column specifications.}% +\edef\@IEEEBPcurglue{\@IEEEeqnarraycolSEPzero}% +\fi% glue defined or not +\let\@IEEEBPcurtype=g% change the type to reflect the acquired glue +\let\@IEEEBPprevtype=\@IEEEBPprevsavedtype% restore the prev type before this number glue +\@IEEEBPcurnum=0\relax%ready for next acquisition +\fi%close acquisition, get glue +\fi%discard or acquire number +\fi%prevtype glue or not +} + + +% process an acquired glue +% add any acquired column/glue pair to the preamble +\def\@IEEEprocessGcol{\if\@IEEEBPprevtype a\let\@IEEEBPcurtype=a%maintain previous glue abortions +\else +% if this is the start glue, save it, but do nothing else +% as this is not used in the preamble, but before +\if\@IEEEBPprevtype s\edef\@IEEEBPstartglue{\@IEEEBPcurglue}% +\else%not the start glue +\if\@IEEEBPprevtype g%ignore if back to back glues +\@IEEEclspkgerror{Back-to-back inter-column glue specifiers in column\MessageBreak +specifications. Ignoring consecutive glue specifiers\MessageBreak +after the first}% +{You cannot have two or more glue types next to each other\MessageBreak +in the IEEEeqnarray column specifications.}% +\let\@IEEEBPcurtype=a% abort this glue +\else% not a back to back glue +\if\@IEEEBPprevtype c\relax% if the previoustype was a col, add column/glue pair to preamble +\ifnum\@IEEEeqnnumcols>0\relax\@IEEEappendtoksA{&}\fi +\toks0={##}% +% make preamble advance col counter if this environment needs this +\if@advanceIEEEeqncolcnt\@IEEEappendtoksA{\global\advance\@IEEEeqncolcnt by 1\relax}\fi +% insert the column defintion into the preamble, being careful not to expand +% the column definition +\@IEEEappendtoksA{\tabskip=\@IEEEBPcurglue}% +\@IEEEappendNOEXPANDtoksA{\begingroup\csname @IEEEeqnarraycolPRE}% +\@IEEEappendtoksA{\@IEEEBPcurcolname}% +\@IEEEappendNOEXPANDtoksA{\endcsname}% +\@IEEEappendtoksA{\the\toks0}% +\@IEEEappendNOEXPANDtoksA{\relax\relax\relax\relax\relax% +\relax\relax\relax\relax\relax\csname @IEEEeqnarraycolPOST}% +\@IEEEappendtoksA{\@IEEEBPcurcolname}% +\@IEEEappendNOEXPANDtoksA{\endcsname\relax\relax\relax\relax\relax% +\relax\relax\relax\relax\relax\endgroup}% +\advance\@IEEEeqnnumcols by 1\relax%one more column in the preamble +\else% error: non-start glue with no pending column +\@IEEEclspkgerror{Inter-column glue specifier without a prior column\MessageBreak +type in the column specifications. Ignoring this glue\MessageBreak +specifier}% +{Except for the first and last positions, glue can be placed only\MessageBreak +between column types.}% +\let\@IEEEBPcurtype=a% abort this glue +\fi% previous was a column +\fi% back-to-back glues +\fi% is start column glue +\fi% prev type not a +} + + +% process an acquired letter referenced column and, if necessary, add it to the preamble +\def\@IEEEprocessCcol{\if\@IEEEBPnexttype g\else +\if\@IEEEBPnexttype n\else +% we have a column followed by something other than a glue (or numeral glue) +% so we must add this column to the preamble now +\ifnum\@IEEEeqnnumcols>0\relax\@IEEEappendtoksA{&}\fi%col separator for those after the first +\if\@IEEEBPnexttype e\@IEEEappendtoksA{\tabskip=\@IEEEBPendglue\relax}\else%put in end glue +\@IEEEappendtoksA{\tabskip=\@IEEEeqnarraycolSEPdefaultmid\relax}\fi% or default mid glue +\toks0={##}% +% make preamble advance col counter if this environment needs this +\if@advanceIEEEeqncolcnt\@IEEEappendtoksA{\global\advance\@IEEEeqncolcnt by 1\relax}\fi +% insert the column definition into the preamble, being careful not to expand +% the column definition +\@IEEEappendNOEXPANDtoksA{\begingroup\csname @IEEEeqnarraycolPRE}% +\@IEEEappendtoksA{\@IEEEBPcurcolname}% +\@IEEEappendNOEXPANDtoksA{\endcsname}% +\@IEEEappendtoksA{\the\toks0}% +\@IEEEappendNOEXPANDtoksA{\relax\relax\relax\relax\relax% +\relax\relax\relax\relax\relax\csname @IEEEeqnarraycolPOST}% +\@IEEEappendtoksA{\@IEEEBPcurcolname}% +\@IEEEappendNOEXPANDtoksA{\endcsname\relax\relax\relax\relax\relax% +\relax\relax\relax\relax\relax\endgroup}% +\advance\@IEEEeqnnumcols by 1\relax%one more column in the preamble +\fi%next type not numeral +\fi%next type not glue +} + + +%% +%% END OF IEEEeqnarry DEFINITIONS +%% + + + + +% set up the running headings, this complex because of all the different +% modes IEEEtran supports +\if@twoside + \ifCLASSOPTIONtechnote + \def\ps@headings{% + \def\@oddhead{\hbox{}\scriptsize\leftmark \hfil \thepage} + \def\@evenhead{\scriptsize\thepage \hfil \leftmark\hbox{}} + \ifCLASSOPTIONdraftcls + \ifCLASSOPTIONdraftclsnofoot + \def\@oddfoot{}\def\@evenfoot{}% + \else + \def\@oddfoot{\scriptsize\@date\hfil DRAFT} + \def\@evenfoot{\scriptsize DRAFT\hfil\@date} + \fi + \else + \def\@oddfoot{}\def\@evenfoot{} + \fi} + \else % not a technote + \def\ps@headings{% + \ifCLASSOPTIONconference + \def\@oddhead{} + \def\@evenhead{} + \else + \def\@oddhead{\hbox{}\scriptsize\rightmark \hfil \thepage} + \def\@evenhead{\scriptsize\thepage \hfil \leftmark\hbox{}} + \fi + \ifCLASSOPTIONdraftcls + \def\@oddhead{\hbox{}\scriptsize\rightmark \hfil \thepage} + \def\@evenhead{\scriptsize\thepage \hfil \leftmark\hbox{}} + \ifCLASSOPTIONdraftclsnofoot + \def\@oddfoot{}\def\@evenfoot{}% + \else + \def\@oddfoot{\scriptsize\@date\hfil DRAFT} + \def\@evenfoot{\scriptsize DRAFT\hfil\@date} + \fi + \else + \def\@oddfoot{}\def\@evenfoot{}% + \fi} + \fi +\else % single side +\def\ps@headings{% + \ifCLASSOPTIONconference + \def\@oddhead{} + \def\@evenhead{} + \else + \def\@oddhead{\hbox{}\scriptsize\leftmark \hfil \thepage} + \def\@evenhead{} + \fi + \ifCLASSOPTIONdraftcls + \def\@oddhead{\hbox{}\scriptsize\leftmark \hfil \thepage} + \def\@evenhead{} + \ifCLASSOPTIONdraftclsnofoot + \def\@oddfoot{} + \else + \def\@oddfoot{\scriptsize \@date \hfil DRAFT} + \fi + \else + \def\@oddfoot{} + \fi + \def\@evenfoot{}} +\fi + + +% title page style +\def\ps@IEEEtitlepagestyle{\def\@oddfoot{}\def\@evenfoot{}% +\ifCLASSOPTIONconference + \def\@oddhead{}% + \def\@evenhead{}% +\else + \def\@oddhead{\hbox{}\scriptsize\leftmark \hfil \thepage}% + \def\@evenhead{\scriptsize\thepage \hfil \leftmark\hbox{}}% +\fi +\ifCLASSOPTIONdraftcls + \def\@oddhead{\hbox{}\scriptsize\leftmark \hfil \thepage}% + \def\@evenhead{\scriptsize\thepage \hfil \leftmark\hbox{}}% + \ifCLASSOPTIONdraftclsnofoot\else + \def\@oddfoot{\scriptsize \@date\hfil DRAFT}% + \def\@evenfoot{\scriptsize DRAFT\hfil \@date}% + \fi +\else + % all non-draft mode footers + \if@IEEEusingpubid + % for title pages that are using a pubid + % do not repeat pubid if using peer review option + \ifCLASSOPTIONpeerreview + \else + \footskip 0pt% + \ifCLASSOPTIONcompsoc + \def\@oddfoot{\hss\normalfont\scriptsize\raisebox{-1.5\@IEEEnormalsizeunitybaselineskip}[0ex][0ex]{\@IEEEpubid}\hss}% + \def\@evenfoot{\hss\normalfont\scriptsize\raisebox{-1.5\@IEEEnormalsizeunitybaselineskip}[0ex][0ex]{\@IEEEpubid}\hss}% + \else + \def\@oddfoot{\hss\normalfont\footnotesize\raisebox{1.5ex}[1.5ex]{\@IEEEpubid}\hss}% + \def\@evenfoot{\hss\normalfont\footnotesize\raisebox{1.5ex}[1.5ex]{\@IEEEpubid}\hss}% + \fi + \fi + \fi +\fi} + + +% peer review cover page style +\def\ps@IEEEpeerreviewcoverpagestyle{% +\def\@oddhead{}\def\@evenhead{}% +\def\@oddfoot{}\def\@evenfoot{}% +\ifCLASSOPTIONdraftcls + \ifCLASSOPTIONdraftclsnofoot\else + \def\@oddfoot{\scriptsize \@date\hfil DRAFT}% + \def\@evenfoot{\scriptsize DRAFT\hfil \@date}% + \fi +\else + % non-draft mode footers + \if@IEEEusingpubid + \footskip 0pt% + \ifCLASSOPTIONcompsoc + \def\@oddfoot{\hss\normalfont\scriptsize\raisebox{-1.5\@IEEEnormalsizeunitybaselineskip}[0ex][0ex]{\@IEEEpubid}\hss}% + \def\@evenfoot{\hss\normalfont\scriptsize\raisebox{-1.5\@IEEEnormalsizeunitybaselineskip}[0ex][0ex]{\@IEEEpubid}\hss}% + \else + \def\@oddfoot{\hss\normalfont\footnotesize\raisebox{1.5ex}[1.5ex]{\@IEEEpubid}\hss}% + \def\@evenfoot{\hss\normalfont\footnotesize\raisebox{1.5ex}[1.5ex]{\@IEEEpubid}\hss}% + \fi + \fi +\fi} + + +% start with empty headings +\def\rightmark{}\def\leftmark{} + + +%% Defines the command for putting the header. \footernote{TEXT} is the same +%% as \markboth{TEXT}{TEXT}. +%% Note that all the text is forced into uppercase, if you have some text +%% that needs to be in lower case, for instance et. al., then either manually +%% set \leftmark and \rightmark or use \MakeLowercase{et. al.} within the +%% arguments to \markboth. +\def\markboth#1#2{\def\leftmark{\@IEEEcompsoconly{\sffamily}\MakeUppercase{#1}}% +\def\rightmark{\@IEEEcompsoconly{\sffamily}\MakeUppercase{#2}}} +\def\footernote#1{\markboth{#1}{#1}} + +\def\today{\ifcase\month\or + January\or February\or March\or April\or May\or June\or + July\or August\or September\or October\or November\or December\fi + \space\number\day, \number\year} + + + + +%% CITATION AND BIBLIOGRAPHY COMMANDS +%% +%% V1.6 no longer supports the older, nonstandard \shortcite and \citename setup stuff +% +% +% Modify Latex2e \@citex to separate citations with "], [" +\def\@citex[#1]#2{% + \let\@citea\@empty + \@cite{\@for\@citeb:=#2\do + {\@citea\def\@citea{], [}% + \edef\@citeb{\expandafter\@firstofone\@citeb\@empty}% + \if@filesw\immediate\write\@auxout{\string\citation{\@citeb}}\fi + \@ifundefined{b@\@citeb}{\mbox{\reset@font\bfseries ?}% + \G@refundefinedtrue + \@latex@warning + {Citation `\@citeb' on page \thepage \space undefined}}% + {\hbox{\csname b@\@citeb\endcsname}}}}{#1}} + +% V1.6 we create hooks for the optional use of Donald Arseneau's +% cite.sty package. cite.sty is "smart" and will notice that the +% following format controls are already defined and will not +% redefine them. The result will be the proper sorting of the +% citation numbers and auto detection of 3 or more entry "ranges" - +% all in IEEE style: [1], [2], [5]--[7], [12] +% This also allows for an optional note, i.e., \cite[mynote]{..}. +% If the \cite with note has more than one reference, the note will +% be applied to the last of the listed references. It is generally +% desired that if a note is given, only one reference is listed in +% that \cite. +% Thanks to Mr. Arseneau for providing the required format arguments +% to produce the IEEE style. +\def\citepunct{], [} +\def\citedash{]--[} + +% V1.7 default to using same font for urls made by url.sty +\AtBeginDocument{\csname url@samestyle\endcsname} + +% V1.6 class files should always provide these +\def\newblock{\hskip .11em\@plus.33em\@minus.07em} +\let\@openbib@code\@empty + + +% Provide support for the control entries of IEEEtran.bst V1.00 and later. +% V1.7 optional argument allows for a different aux file to be specified in +% order to handle multiple bibliographies. For example, with multibib.sty: +% \newcites{sec}{Secondary Literature} +% \bstctlcite[@auxoutsec]{BSTcontrolhak} +\def\bstctlcite{\@ifnextchar[{\@bstctlcite}{\@bstctlcite[@auxout]}} +\def\@bstctlcite[#1]#2{\@bsphack + \@for\@citeb:=#2\do{% + \edef\@citeb{\expandafter\@firstofone\@citeb}% + \if@filesw\immediate\write\csname #1\endcsname{\string\citation{\@citeb}}\fi}% + \@esphack} + +% V1.6 provide a way for a user to execute a command just before +% a given reference number - used to insert a \newpage to balance +% the columns on the last page +\edef\@IEEEtriggerrefnum{0} % the default of zero means that + % the command is not executed +\def\@IEEEtriggercmd{\newpage} + +% allow the user to alter the triggered command +\long\def\IEEEtriggercmd#1{\long\def\@IEEEtriggercmd{#1}} + +% allow user a way to specify the reference number just before the +% command is executed +\def\IEEEtriggeratref#1{\@IEEEtrantmpcountA=#1% +\edef\@IEEEtriggerrefnum{\the\@IEEEtrantmpcountA}}% + +% trigger command at the given reference +\def\@IEEEbibitemprefix{\@IEEEtrantmpcountA=\@IEEEtriggerrefnum\relax% +\advance\@IEEEtrantmpcountA by -1\relax% +\ifnum\c@enumiv=\@IEEEtrantmpcountA\relax\@IEEEtriggercmd\relax\fi} + + +\def\@biblabel#1{[#1]} + +% compsoc journals left align the reference numbers +\@IEEEcompsocnotconfonly{\def\@biblabel#1{[#1]\hfill}} + +% controls bib item spacing +\def\IEEEbibitemsep{2.5pt plus .5pt} + +\@IEEEcompsocconfonly{\def\IEEEbibitemsep{1\baselineskip plus 0.25\baselineskip minus 0.25\baselineskip}} + + +\def\thebibliography#1{\section*{\refname}% + \addcontentsline{toc}{section}{\refname}% + % V1.6 add some rubber space here and provide a command trigger + \footnotesize\@IEEEcompsocconfonly{\small}\vskip 0.3\baselineskip plus 0.1\baselineskip minus 0.1\baselineskip% + \list{\@biblabel{\@arabic\c@enumiv}}% + {\settowidth\labelwidth{\@biblabel{#1}}% + \leftmargin\labelwidth + \labelsep 1em + \advance\leftmargin\labelsep\relax + \itemsep \IEEEbibitemsep\relax + \usecounter{enumiv}% + \let\p@enumiv\@empty + \renewcommand\theenumiv{\@arabic\c@enumiv}}% + \let\@IEEElatexbibitem\bibitem% + \def\bibitem{\@IEEEbibitemprefix\@IEEElatexbibitem}% +\def\newblock{\hskip .11em plus .33em minus .07em}% +% originally: +% \sloppy\clubpenalty4000\widowpenalty4000% +% by adding the \interlinepenalty here, we make it more +% difficult, but not impossible, for LaTeX to break within a reference. +% IEEE almost never breaks a reference (but they do it more often with +% technotes). You may get an underfull vbox warning around the bibliography, +% but the final result will be much more like what IEEE will publish. +% MDS 11/2000 +\ifCLASSOPTIONtechnote\sloppy\clubpenalty4000\widowpenalty4000\interlinepenalty100% +\else\sloppy\clubpenalty4000\widowpenalty4000\interlinepenalty500\fi% + \sfcode`\.=1000\relax} +\let\endthebibliography=\endlist + + + + +% TITLE PAGE COMMANDS +% +% +% \IEEEmembership is used to produce the sublargesize italic font used to indicate author +% IEEE membership. compsoc uses a large size sans slant font +\def\IEEEmembership#1{{\@IEEEnotcompsoconly{\sublargesize}\normalfont\@IEEEcompsoconly{\sffamily}\textit{#1}}} + + +% \IEEEauthorrefmark{} produces a footnote type symbol to indicate author affiliation. +% When given an argument of 1 to 9, \IEEEauthorrefmark{} follows the standard LaTeX footnote +% symbol sequence convention. However, for arguments 10 and above, \IEEEauthorrefmark{} +% reverts to using lower case roman numerals, so it cannot overflow. Do note that you +% cannot use \footnotemark[] in place of \IEEEauthorrefmark{} within \author as the footnote +% symbols will have been turned off to prevent \thanks from creating footnote marks. +% \IEEEauthorrefmark{} produces a symbol that appears to LaTeX as having zero vertical +% height - this allows for a more compact line packing, but the user must ensure that +% the interline spacing is large enough to prevent \IEEEauthorrefmark{} from colliding +% with the text above. +% V1.7 make this a robust command +\DeclareRobustCommand*{\IEEEauthorrefmark}[1]{\raisebox{0pt}[0pt][0pt]{\textsuperscript{\footnotesize\ensuremath{\ifcase#1\or *\or \dagger\or \ddagger\or% + \mathsection\or \mathparagraph\or \|\or **\or \dagger\dagger% + \or \ddagger\ddagger \else\textsuperscript{\expandafter\romannumeral#1}\fi}}}} + + +% FONT CONTROLS AND SPACINGS FOR CONFERENCE MODE AUTHOR NAME AND AFFILIATION BLOCKS +% +% The default font styles for the author name and affiliation blocks (confmode) +\def\@IEEEauthorblockNstyle{\normalfont\@IEEEcompsocnotconfonly{\sffamily}\sublargesize\@IEEEcompsocconfonly{\large}} +\def\@IEEEauthorblockAstyle{\normalfont\@IEEEcompsocnotconfonly{\sffamily}\@IEEEcompsocconfonly{\itshape}\normalsize\@IEEEcompsocconfonly{\large}} +% The default if the user does not use an author block +\def\@IEEEauthordefaulttextstyle{\normalfont\@IEEEcompsocnotconfonly{\sffamily}\sublargesize} + +% spacing from title (or special paper notice) to author name blocks (confmode) +% can be negative +\def\@IEEEauthorblockconfadjspace{-0.25em} +% compsoc conferences need more space here +\@IEEEcompsocconfonly{\def\@IEEEauthorblockconfadjspace{0.75\@IEEEnormalsizeunitybaselineskip}} +\ifCLASSOPTIONconference\def\@IEEEauthorblockconfadjspace{20pt}\fi + +% spacing between name and affiliation blocks (confmode) +% This can be negative. +% IEEE doesn't want any added spacing here, but I will leave these +% controls in place in case they ever change their mind. +% Personally, I like 0.75ex. +%\def\@IEEEauthorblockNtopspace{0.75ex} +%\def\@IEEEauthorblockAtopspace{0.75ex} +\def\@IEEEauthorblockNtopspace{0.0ex} +\def\@IEEEauthorblockAtopspace{0.0ex} +% baseline spacing within name and affiliation blocks (confmode) +% must be positive, spacings below certain values will make +% the position of line of text sensitive to the contents of the +% line above it i.e., whether or not the prior line has descenders, +% subscripts, etc. For this reason it is a good idea to keep +% these above 2.6ex +\def\@IEEEauthorblockNinterlinespace{2.6ex} +\def\@IEEEauthorblockAinterlinespace{2.75ex} + +% This tracks the required strut size. +% See the \@IEEEauthorhalign command for the actual default value used. +\def\@IEEEauthorblockXinterlinespace{2.7ex} + +% variables to retain font size and style across groups +% values given here have no effect as they will be overwritten later +\gdef\@IEEESAVESTATEfontsize{10} +\gdef\@IEEESAVESTATEfontbaselineskip{12} +\gdef\@IEEESAVESTATEfontencoding{OT1} +\gdef\@IEEESAVESTATEfontfamily{ptm} +\gdef\@IEEESAVESTATEfontseries{m} +\gdef\@IEEESAVESTATEfontshape{n} + +% saves the current font attributes +\def\@IEEEcurfontSAVE{\global\let\@IEEESAVESTATEfontsize\f@size% +\global\let\@IEEESAVESTATEfontbaselineskip\f@baselineskip% +\global\let\@IEEESAVESTATEfontencoding\f@encoding% +\global\let\@IEEESAVESTATEfontfamily\f@family% +\global\let\@IEEESAVESTATEfontseries\f@series% +\global\let\@IEEESAVESTATEfontshape\f@shape} + +% restores the saved font attributes +\def\@IEEEcurfontRESTORE{\fontsize{\@IEEESAVESTATEfontsize}{\@IEEESAVESTATEfontbaselineskip}% +\fontencoding{\@IEEESAVESTATEfontencoding}% +\fontfamily{\@IEEESAVESTATEfontfamily}% +\fontseries{\@IEEESAVESTATEfontseries}% +\fontshape{\@IEEESAVESTATEfontshape}% +\selectfont} + + +% variable to indicate if the current block is the first block in the column +\newif\if@IEEEprevauthorblockincol \@IEEEprevauthorblockincolfalse + + +% the command places a strut with height and depth = \@IEEEauthorblockXinterlinespace +% we use this technique to have complete manual control over the spacing of the lines +% within the halign environment. +% We set the below baseline portion at 30%, the above +% baseline portion at 70% of the total length. +% Responds to changes in the document's \baselinestretch +\def\@IEEEauthorstrutrule{\@IEEEtrantmpdimenA\@IEEEauthorblockXinterlinespace% +\@IEEEtrantmpdimenA=\baselinestretch\@IEEEtrantmpdimenA% +\rule[-0.3\@IEEEtrantmpdimenA]{0pt}{\@IEEEtrantmpdimenA}} + + +% blocks to hold the authors' names and affilations. +% Makes formatting easy for conferences +% +% use real definitions in conference mode +% name block +\def\IEEEauthorblockN#1{\relax\@IEEEauthorblockNstyle% set the default text style +\gdef\@IEEEauthorblockXinterlinespace{0pt}% disable strut for spacer row +% the \expandafter hides the \cr in conditional tex, see the array.sty docs +% for details, probably not needed here as the \cr is in a macro +% do a spacer row if needed +\if@IEEEprevauthorblockincol\expandafter\@IEEEauthorblockNtopspaceline\fi +\global\@IEEEprevauthorblockincoltrue% we now have a block in this column +%restore the correct strut value +\gdef\@IEEEauthorblockXinterlinespace{\@IEEEauthorblockNinterlinespace}% +% input the author names +#1% +% end the row if the user did not already +\crcr} +% spacer row for names +\def\@IEEEauthorblockNtopspaceline{\cr\noalign{\vskip\@IEEEauthorblockNtopspace}} +% +% affiliation block +\def\IEEEauthorblockA#1{\relax\@IEEEauthorblockAstyle% set the default text style +\gdef\@IEEEauthorblockXinterlinespace{0pt}%disable strut for spacer row +% the \expandafter hides the \cr in conditional tex, see the array.sty docs +% for details, probably not needed here as the \cr is in a macro +% do a spacer row if needed +\if@IEEEprevauthorblockincol\expandafter\@IEEEauthorblockAtopspaceline\fi +\global\@IEEEprevauthorblockincoltrue% we now have a block in this column +%restore the correct strut value +\gdef\@IEEEauthorblockXinterlinespace{\@IEEEauthorblockAinterlinespace}% +% input the author affiliations +#1% +% end the row if the user did not already +\crcr} +% spacer row for affiliations +\def\@IEEEauthorblockAtopspaceline{\cr\noalign{\vskip\@IEEEauthorblockAtopspace}} + + +% allow papers to compile even if author blocks are used in modes other +% than conference or peerreviewca. For such cases, we provide dummy blocks. +\ifCLASSOPTIONconference +\else + \ifCLASSOPTIONpeerreviewca\else + % not conference or peerreviewca mode + \def\IEEEauthorblockN#1{#1}% + \def\IEEEauthorblockA#1{#1}% + \fi +\fi + + + +% we provide our own halign so as not to have to depend on tabular +\def\@IEEEauthorhalign{\@IEEEauthordefaulttextstyle% default text style + \lineskip=0pt\relax% disable line spacing + \lineskiplimit=0pt\relax% + \baselineskip=0pt\relax% + \@IEEEcurfontSAVE% save the current font + \mathsurround\z@\relax% no extra spacing around math + \let\\\@IEEEauthorhaligncr% replace newline with halign friendly one + \tabskip=0pt\relax% no column spacing + \everycr{}% ensure no problems here + \@IEEEprevauthorblockincolfalse% no author blocks yet + \def\@IEEEauthorblockXinterlinespace{2.7ex}% default interline space + \vtop\bgroup%vtop box + \halign\bgroup&\relax\hfil\@IEEEcurfontRESTORE\relax ##\relax + \hfil\@IEEEcurfontSAVE\@IEEEauthorstrutrule\cr} + +% ensure last line, exit from halign, close vbox +\def\end@IEEEauthorhalign{\crcr\egroup\egroup} + +% handle bogus star form +\def\@IEEEauthorhaligncr{{\ifnum0=`}\fi\@ifstar{\@@IEEEauthorhaligncr}{\@@IEEEauthorhaligncr}} + +% test and setup the optional argument to \\[] +\def\@@IEEEauthorhaligncr{\@testopt\@@@IEEEauthorhaligncr\z@skip} + +% end the line and do the optional spacer +\def\@@@IEEEauthorhaligncr[#1]{\ifnum0=`{\fi}\cr\noalign{\vskip#1\relax}} + + + +% flag to prevent multiple \and warning messages +\newif\if@IEEEWARNand +\@IEEEWARNandtrue + +% if in conference or peerreviewca modes, we support the use of \and as \author is a +% tabular environment, otherwise we warn the user that \and is invalid +% outside of conference or peerreviewca modes. +\def\and{\relax} % provide a bogus \and that we will then override + +\renewcommand{\and}[1][\relax]{\if@IEEEWARNand\typeout{** WARNING: \noexpand\and is valid only + when in conference or peerreviewca}\typeout{modes (line \the\inputlineno).}\fi\global\@IEEEWARNandfalse} + +\ifCLASSOPTIONconference% +\renewcommand{\and}[1][\hfill]{\end{@IEEEauthorhalign}#1\begin{@IEEEauthorhalign}}% +\fi +\ifCLASSOPTIONpeerreviewca +\renewcommand{\and}[1][\hfill]{\end{@IEEEauthorhalign}#1\begin{@IEEEauthorhalign}}% +\fi + + +% page clearing command +% based on LaTeX2e's \cleardoublepage, but allows different page styles +% for the inserted blank pages +\def\@IEEEcleardoublepage#1{\clearpage\if@twoside\ifodd\c@page\else +\hbox{}\thispagestyle{#1}\newpage\if@twocolumn\hbox{}\thispagestyle{#1}\newpage\fi\fi\fi} + + +% user command to invoke the title page +\def\maketitle{\par% + \begingroup% + \normalfont% + \def\thefootnote{}% the \thanks{} mark type is empty + \def\footnotemark{}% and kill space from \thanks within author + \let\@makefnmark\relax% V1.7, must *really* kill footnotemark to remove all \textsuperscript spacing as well. + \footnotesize% equal spacing between thanks lines + \footnotesep 0.7\baselineskip%see global setting of \footnotesep for more info + % V1.7 disable \thanks note indention for compsoc + \@IEEEcompsoconly{\long\def\@makefntext##1{\parindent 1em\noindent\hbox{\@makefnmark}##1}}% + \normalsize% + \ifCLASSOPTIONpeerreview + \newpage\global\@topnum\z@ \@maketitle\@IEEEstatictitlevskip\@IEEEaftertitletext% + \thispagestyle{IEEEpeerreviewcoverpagestyle}\@thanks% + \else + \if@twocolumn% + \ifCLASSOPTIONtechnote% + \newpage\global\@topnum\z@ \@maketitle\@IEEEstatictitlevskip\@IEEEaftertitletext% + \else + \twocolumn[\@maketitle\@IEEEstatictitlevskip\@IEEEaftertitletext]% + \fi + \else + \newpage\global\@topnum\z@ \@maketitle\@IEEEstatictitlevskip\@IEEEaftertitletext% + \fi + \thispagestyle{IEEEtitlepagestyle}\@thanks% + \fi + % pullup page for pubid if used. + \if@IEEEusingpubid + \enlargethispage{-\@IEEEpubidpullup}% + \fi + \endgroup + \setcounter{footnote}{0}\let\maketitle\relax\let\@maketitle\relax + \gdef\@thanks{}% + % v1.6b do not clear these as we will need the title again for peer review papers + % \gdef\@author{}\gdef\@title{}% + \let\thanks\relax} + + + +% V1.7 parbox to format \@IEEEcompsoctitleabstractindextext +\long\def\@IEEEcompsoctitleabstractindextextbox#1{\parbox{0.915\textwidth}{#1}} + +% formats the Title, authors names, affiliations and special paper notice +% THIS IS A CONTROLLED SPACING COMMAND! Do not allow blank lines or unintentional +% spaces to enter the definition - use % at the end of each line +\def\@maketitle{\newpage +\begingroup\centering +\ifCLASSOPTIONtechnote% technotes + {\bfseries\large\@IEEEcompsoconly{\sffamily}\@title\par}\vskip 1.3em{\lineskip .5em\@IEEEcompsoconly{\sffamily}\@author + \@IEEEspecialpapernotice\par{\@IEEEcompsoconly{\vskip 1.5em\relax + \@IEEEcompsoctitleabstractindextextbox{\@IEEEcompsoctitleabstractindextext}\par + \hfill\@IEEEcompsocdiamondline\hfill\hbox{}\par}}}\relax +\else% not a technote + \vskip0.2em{\Huge\@IEEEcompsoconly{\sffamily}\@IEEEcompsocconfonly{\normalfont\normalsize\vskip 2\@IEEEnormalsizeunitybaselineskip + \bfseries\Large}\@title\par}\vskip1.0em\par% + % V1.6 handle \author differently if in conference mode + \ifCLASSOPTIONconference% + {\@IEEEspecialpapernotice\mbox{}\vskip\@IEEEauthorblockconfadjspace% + \mbox{}\hfill\begin{@IEEEauthorhalign}\@author\end{@IEEEauthorhalign}\hfill\mbox{}\par}\relax + \else% peerreviewca, peerreview or journal + \ifCLASSOPTIONpeerreviewca + % peerreviewca handles author names just like conference mode + {\@IEEEcompsoconly{\sffamily}\@IEEEspecialpapernotice\mbox{}\vskip\@IEEEauthorblockconfadjspace% + \mbox{}\hfill\begin{@IEEEauthorhalign}\@author\end{@IEEEauthorhalign}\hfill\mbox{}\par + {\@IEEEcompsoconly{\vskip 1.5em\relax + \@IEEEcompsoctitleabstractindextextbox{\@IEEEcompsoctitleabstractindextext}\par\hfill + \@IEEEcompsocdiamondline\hfill\hbox{}\par}}}\relax + \else% journal or peerreview + {\lineskip.5em\@IEEEcompsoconly{\sffamily}\sublargesize\@author\@IEEEspecialpapernotice\par + {\@IEEEcompsoconly{\vskip 1.5em\relax + \@IEEEcompsoctitleabstractindextextbox{\@IEEEcompsoctitleabstractindextext}\par\hfill + \@IEEEcompsocdiamondline\hfill\hbox{}\par}}}\relax + \fi + \fi +\fi\par\endgroup} + + + +% V1.7 Computer Society "diamond line" which follows index terms for nonconference papers +\def\@IEEEcompsocdiamondline{\vrule depth 0pt height 0.5pt width 4cm\hspace{7.5pt}% +\raisebox{-3.5pt}{\fontfamily{pzd}\fontencoding{U}\fontseries{m}\fontshape{n}\fontsize{11}{12}\selectfont\char70}% +\hspace{7.5pt}\vrule depth 0pt height 0.5pt width 4cm\relax} + +% V1.7 standard LateX2e \thanks, but with \itshape under compsoc. Also make it a \long\def +% We also need to trigger the one-shot footnote rule +\def\@IEEEtriggeroneshotfootnoterule{\global\@IEEEenableoneshotfootnoteruletrue} + + +\long\def\thanks#1{\footnotemark + \protected@xdef\@thanks{\@thanks + \protect\footnotetext[\the\c@footnote]{\@IEEEcompsoconly{\itshape + \protect\@IEEEtriggeroneshotfootnoterule\relax}\ignorespaces#1}}} +\let\@thanks\@empty + +% V1.7 allow \author to contain \par's. This is needed to allow \thanks to contain \par. +\long\def\author#1{\gdef\@author{#1}} + + +% in addition to setting up IEEEitemize, we need to remove a baselineskip space above and +% below it because \list's \pars introduce blank lines because of the footnote struts. +\def\@IEEEsetupcompsocitemizelist{\def\labelitemi{$\bullet$}% +\setlength{\IEEElabelindent}{0pt}\setlength{\parskip}{0pt}% +\setlength{\partopsep}{0pt}\setlength{\topsep}{0.5\baselineskip}\vspace{-1\baselineskip}\relax} + + +% flag for fake non-compsoc \IEEEcompsocthanksitem - prevents line break on very first item +\newif\if@IEEEbreakcompsocthanksitem \@IEEEbreakcompsocthanksitemfalse + +\ifCLASSOPTIONcompsoc +% V1.7 compsoc bullet item \thanks +% also, we need to redefine this to destroy the argument in \@IEEEdynamictitlevspace +\long\def\IEEEcompsocitemizethanks#1{\relax\@IEEEbreakcompsocthanksitemfalse\footnotemark + \protected@xdef\@thanks{\@thanks + \protect\footnotetext[\the\c@footnote]{\itshape\protect\@IEEEtriggeroneshotfootnoterule + {\let\IEEEiedlistdecl\relax\protect\begin{IEEEitemize}[\protect\@IEEEsetupcompsocitemizelist]\ignorespaces#1\relax + \protect\end{IEEEitemize}}\protect\vspace{-1\baselineskip}}}} +\DeclareRobustCommand*{\IEEEcompsocthanksitem}{\item} +\else +% non-compsoc, allow for dual compilation via rerouting to normal \thanks +\long\def\IEEEcompsocitemizethanks#1{\thanks{#1}} +% redirect to "pseudo-par" \hfil\break\indent after swallowing [] from \IEEEcompsocthanksitem[] +\DeclareRobustCommand{\IEEEcompsocthanksitem}{\@ifnextchar [{\@IEEEthanksswallowoptionalarg}% +{\@IEEEthanksswallowoptionalarg[\relax]}} +% be sure and break only after first item, be sure and ignore spaces after optional argument +\def\@IEEEthanksswallowoptionalarg[#1]{\relax\if@IEEEbreakcompsocthanksitem\hfil\break +\indent\fi\@IEEEbreakcompsocthanksitemtrue\ignorespaces} +\fi + + +% V1.6b define the \IEEEpeerreviewmaketitle as needed +\ifCLASSOPTIONpeerreview +\def\IEEEpeerreviewmaketitle{\@IEEEcleardoublepage{empty}% +\ifCLASSOPTIONtwocolumn +\twocolumn[\@IEEEpeerreviewmaketitle\@IEEEdynamictitlevspace] +\else +\newpage\@IEEEpeerreviewmaketitle\@IEEEstatictitlevskip +\fi +\thispagestyle{IEEEtitlepagestyle}} +\else +% \IEEEpeerreviewmaketitle does nothing if peer review option has not been selected +\def\IEEEpeerreviewmaketitle{\relax} +\fi + +% peerreview formats the repeated title like the title in journal papers. +\def\@IEEEpeerreviewmaketitle{\begin{center}\@IEEEcompsoconly{\sffamily}% +\normalfont\normalsize\vskip0.2em{\Huge\@title\par}\vskip1.0em\par +\end{center}} + + + +% V1.6 +% this is a static rubber spacer between the title/authors and the main text +% used for single column text, or when the title appears in the first column +% of two column text (technotes). +\def\@IEEEstatictitlevskip{{\normalfont\normalsize +% adjust spacing to next text +% v1.6b handle peer review papers +\ifCLASSOPTIONpeerreview +% for peer review papers, the same value is used for both title pages +% regardless of the other paper modes + \vskip 1\baselineskip plus 0.375\baselineskip minus 0.1875\baselineskip +\else + \ifCLASSOPTIONconference% conference + \vskip 0.6\baselineskip + \else% + \ifCLASSOPTIONtechnote% technote + \vskip 1\baselineskip plus 0.375\baselineskip minus 0.1875\baselineskip% + \else% journal uses more space + \vskip 2.5\baselineskip plus 0.75\baselineskip minus 0.375\baselineskip% + \fi + \fi +\fi}} + + +% V1.6 +% This is a dynamically determined rigid spacer between the title/authors +% and the main text. This is used only for single column titles over two +% column text (most common) +% This is bit tricky because we have to ensure that the textheight of the +% main text is an integer multiple of \baselineskip +% otherwise underfull vbox problems may develop in the second column of the +% text on the titlepage +% The possible use of \IEEEpubid must also be taken into account. +\def\@IEEEdynamictitlevspace{{% + % we run within a group so that all the macros can be forgotten when we are done + \long\def\thanks##1{\relax}%don't allow \thanks to run when we evaluate the vbox height + \long\def\IEEEcompsocitemizethanks##1{\relax}%don't allow \IEEEcompsocitemizethanks to run when we evaluate the vbox height + \normalfont\normalsize% we declare more descriptive variable names + \let\@IEEEmaintextheight=\@IEEEtrantmpdimenA%height of the main text columns + \let\@IEEEINTmaintextheight=\@IEEEtrantmpdimenB%height of the main text columns with integer # lines + % set the nominal and minimum values for the title spacer + % the dynamic algorithm will not allow the spacer size to + % become less than \@IEEEMINtitlevspace - instead it will be + % lengthened + % default to journal values + \def\@IEEENORMtitlevspace{2.5\baselineskip}% + \def\@IEEEMINtitlevspace{2\baselineskip}% + % conferences and technotes need tighter spacing + \ifCLASSOPTIONconference%conference + \def\@IEEENORMtitlevspace{1\baselineskip}% + \def\@IEEEMINtitlevspace{0.75\baselineskip}% + \fi + \ifCLASSOPTIONtechnote%technote + \def\@IEEENORMtitlevspace{1\baselineskip}% + \def\@IEEEMINtitlevspace{0.75\baselineskip}% + \fi% + % get the height that the title will take up + \ifCLASSOPTIONpeerreview + \settoheight{\@IEEEmaintextheight}{\vbox{\hsize\textwidth \@IEEEpeerreviewmaketitle}}% + \else + \settoheight{\@IEEEmaintextheight}{\vbox{\hsize\textwidth \@maketitle}}% + \fi + \@IEEEmaintextheight=-\@IEEEmaintextheight% title takes away from maintext, so reverse sign + % add the height of the page textheight + \advance\@IEEEmaintextheight by \textheight% + % correct for title pages using pubid + \ifCLASSOPTIONpeerreview\else + % peerreview papers use the pubid on the cover page only. + % And the cover page uses a static spacer. + \if@IEEEusingpubid\advance\@IEEEmaintextheight by -\@IEEEpubidpullup\fi + \fi% + % subtract off the nominal value of the title bottom spacer + \advance\@IEEEmaintextheight by -\@IEEENORMtitlevspace% + % \topskip takes away some too + \advance\@IEEEmaintextheight by -\topskip% + % calculate the column height of the main text for lines + % now we calculate the main text height as if holding + % an integer number of \normalsize lines after the first + % and discard any excess fractional remainder + % we subtracted the first line, because the first line + % is placed \topskip into the maintext, not \baselineskip like the + % rest of the lines. + \@IEEEINTmaintextheight=\@IEEEmaintextheight% + \divide\@IEEEINTmaintextheight by \baselineskip% + \multiply\@IEEEINTmaintextheight by \baselineskip% + % now we calculate how much the title spacer height will + % have to be reduced from nominal (\@IEEEREDUCEmaintextheight is always + % a positive value) so that the maintext area will contain an integer + % number of normal size lines + % we change variable names here (to avoid confusion) as we no longer + % need \@IEEEINTmaintextheight and can reuse its dimen register + \let\@IEEEREDUCEmaintextheight=\@IEEEINTmaintextheight% + \advance\@IEEEREDUCEmaintextheight by -\@IEEEmaintextheight% + \advance\@IEEEREDUCEmaintextheight by \baselineskip% + % this is the calculated height of the spacer + % we change variable names here (to avoid confusion) as we no longer + % need \@IEEEmaintextheight and can reuse its dimen register + \let\@IEEECOMPENSATElen=\@IEEEmaintextheight% + \@IEEECOMPENSATElen=\@IEEENORMtitlevspace% set the nominal value + % we go with the reduced length if it is smaller than an increase + \ifdim\@IEEEREDUCEmaintextheight < 0.5\baselineskip\relax% + \advance\@IEEECOMPENSATElen by -\@IEEEREDUCEmaintextheight% + % if the resulting spacer is too small back out and go with an increase instead + \ifdim\@IEEECOMPENSATElen<\@IEEEMINtitlevspace\relax% + \advance\@IEEECOMPENSATElen by \baselineskip% + \fi% + \else% + % go with an increase because it is closer to the nominal than a decrease + \advance\@IEEECOMPENSATElen by -\@IEEEREDUCEmaintextheight% + \advance\@IEEECOMPENSATElen by \baselineskip% + \fi% + % set the calculated rigid spacer + \vspace{\@IEEECOMPENSATElen}}} + + + +% V1.6 +% we allow the user access to the last part of the title area +% useful in emergencies such as when a different spacing is needed +% This text is NOT compensated for in the dynamic sizer. +\let\@IEEEaftertitletext=\relax +\long\def\IEEEaftertitletext#1{\def\@IEEEaftertitletext{#1}} + +% V1.7 provide a way for users to enter abstract and keywords +% into the onecolumn title are. This text is compensated for +% in the dynamic sizer. +\let\@IEEEcompsoctitleabstractindextext=\relax +\long\def\IEEEcompsoctitleabstractindextext#1{\def\@IEEEcompsoctitleabstractindextext{#1}} +% V1.7 provide a way for users to get the \@IEEEcompsoctitleabstractindextext if +% not in compsoc journal mode - this way abstract and keywords can be placed +% in their conventional position if not in compsoc mode. +\def\IEEEdisplaynotcompsoctitleabstractindextext{% +\ifCLASSOPTIONcompsoc% display if compsoc conf +\ifCLASSOPTIONconference\@IEEEcompsoctitleabstractindextext\fi +\else% or if not compsoc +\@IEEEcompsoctitleabstractindextext\fi} + + +% command to allow alteration of baselinestretch, but only if the current +% baselineskip is unity. Used to tweak the compsoc abstract and keywords line spacing. +\def\@IEEEtweakunitybaselinestretch#1{{\def\baselinestretch{1}\selectfont +\global\@tempskipa\baselineskip}\ifnum\@tempskipa=\baselineskip% +\def\baselinestretch{#1}\selectfont\fi\relax} + + +% abstract and keywords are in \small, except +% for 9pt docs in which they are in \footnotesize +% Because 9pt docs use an 8pt footnotesize, \small +% becomes a rather awkward 8.5pt +\def\@IEEEabskeysecsize{\small} +\ifx\CLASSOPTIONpt\@IEEEptsizenine + \def\@IEEEabskeysecsize{\footnotesize} +\fi + +% compsoc journals use \footnotesize, compsoc conferences use normalsize +\@IEEEcompsoconly{\def\@IEEEabskeysecsize{\footnotesize}} +\@IEEEcompsocconfonly{\def\@IEEEabskeysecsize{\normalsize}} + + + + +% V1.6 have abstract and keywords strip leading spaces, pars and newlines +% so that spacing is more tightly controlled. +\def\abstract{\normalfont + \if@twocolumn + \par\@IEEEabskeysecsize\bfseries\leavevmode\kern-1pt\textit{\abstractname}---\relax + \else + \begin{center}\vspace{-1.78ex}\@IEEEabskeysecsize\textbf{\abstractname}\end{center}\quotation\@IEEEabskeysecsize + \fi\@IEEEgobbleleadPARNLSP} +% V1.6 IEEE wants only 1 pica from end of abstract to introduction heading when in +% conference mode (the heading already has this much above it) +\def\endabstract{\relax\ifCLASSOPTIONconference\vspace{0ex}\else\vspace{1.34ex}\fi\par\if@twocolumn\else\endquotation\fi + \normalfont\normalsize} + +\def\IEEEkeywords{\normalfont + \if@twocolumn + \@IEEEabskeysecsize\bfseries\leavevmode\kern-1pt\textit{\IEEEkeywordsname}---\relax + \else + \begin{center}\@IEEEabskeysecsize\textbf{\IEEEkeywordsname}\end{center}\quotation\@IEEEabskeysecsize + \fi\itshape\@IEEEgobbleleadPARNLSP} +\def\endIEEEkeywords{\relax\ifCLASSOPTIONtechnote\vspace{1.34ex}\else\vspace{0.5ex}\fi + \par\if@twocolumn\else\endquotation\fi% + \normalfont\normalsize} + +% V1.7 compsoc keywords index terms +\ifCLASSOPTIONcompsoc + \ifCLASSOPTIONconference% compsoc conference +\def\abstract{\normalfont + \begin{center}\@IEEEabskeysecsize\textbf{\large\abstractname}\end{center}\vskip 0.5\baselineskip plus 0.1\baselineskip minus 0.1\baselineskip + \if@twocolumn\else\quotation\fi\itshape\@IEEEabskeysecsize% + \par\@IEEEgobbleleadPARNLSP} +\def\IEEEkeywords{\normalfont\vskip 1.5\baselineskip plus 0.25\baselineskip minus 0.25\baselineskip + \begin{center}\@IEEEabskeysecsize\textbf{\large\IEEEkeywordsname}\end{center}\vskip 0.5\baselineskip plus 0.1\baselineskip minus 0.1\baselineskip + \if@twocolumn\else\quotation\fi\itshape\@IEEEabskeysecsize% + \par\@IEEEgobbleleadPARNLSP} + \else% compsoc not conference +\def\abstract{\normalfont\@IEEEtweakunitybaselinestretch{1.15}\sffamily + \if@twocolumn + \@IEEEabskeysecsize\noindent\textbf{\abstractname}---\relax + \else + \begin{center}\vspace{-1.78ex}\@IEEEabskeysecsize\textbf{\abstractname}\end{center}\quotation\@IEEEabskeysecsize% + \fi\@IEEEgobbleleadPARNLSP} +\def\IEEEkeywords{\normalfont\@IEEEtweakunitybaselinestretch{1.15}\sffamily + \if@twocolumn + \@IEEEabskeysecsize\vskip 0.5\baselineskip plus 0.25\baselineskip minus 0.25\baselineskip\noindent + \textbf{\IEEEkeywordsname}---\relax + \else + \begin{center}\@IEEEabskeysecsize\textbf{\IEEEkeywordsname}\end{center}\quotation\@IEEEabskeysecsize% + \fi\@IEEEgobbleleadPARNLSP} + \fi +\fi + + + +% gobbles all leading \, \\ and \par, upon finding first token that +% is not a \ , \\ or a \par, it ceases and returns that token +% +% used to strip leading \, \\ and \par from the input +% so that such things in the beginning of an environment will not +% affect the formatting of the text +\long\def\@IEEEgobbleleadPARNLSP#1{\let\@IEEEswallowthistoken=0% +\let\@IEEEgobbleleadPARNLSPtoken#1% +\let\@IEEEgobbleleadPARtoken=\par% +\let\@IEEEgobbleleadNLtoken=\\% +\let\@IEEEgobbleleadSPtoken=\ % +\def\@IEEEgobbleleadSPMACRO{\ }% +\ifx\@IEEEgobbleleadPARNLSPtoken\@IEEEgobbleleadPARtoken% +\let\@IEEEswallowthistoken=1% +\fi% +\ifx\@IEEEgobbleleadPARNLSPtoken\@IEEEgobbleleadNLtoken% +\let\@IEEEswallowthistoken=1% +\fi% +\ifx\@IEEEgobbleleadPARNLSPtoken\@IEEEgobbleleadSPtoken% +\let\@IEEEswallowthistoken=1% +\fi% +% a control space will come in as a macro +% when it is the last one on a line +\ifx\@IEEEgobbleleadPARNLSPtoken\@IEEEgobbleleadSPMACRO% +\let\@IEEEswallowthistoken=1% +\fi% +% if we have to swallow this token, do so and taste the next one +% else spit it out and stop gobbling +\ifx\@IEEEswallowthistoken 1\let\@IEEEnextgobbleleadPARNLSP=\@IEEEgobbleleadPARNLSP\else% +\let\@IEEEnextgobbleleadPARNLSP=#1\fi% +\@IEEEnextgobbleleadPARNLSP}% + + + + +% TITLING OF SECTIONS +\def\@IEEEsectpunct{:\ \,} % Punctuation after run-in section heading (headings which are + % part of the paragraphs), need little bit more than a single space + % spacing from section number to title +% compsoc conferences use regular period/space punctuation +\ifCLASSOPTIONcompsoc +\ifCLASSOPTIONconference +\def\@IEEEsectpunct{.\ } +\fi\fi + +\def\@seccntformat#1{\hb@xt@ 1.4em{\csname the#1dis\endcsname\hss\relax}} +\def\@seccntformatinl#1{\hb@xt@ 1.1em{\csname the#1dis\endcsname\hss\relax}} +\def\@seccntformatch#1{\csname the#1dis\endcsname\hskip 1em\relax} + +\ifCLASSOPTIONcompsoc +% compsoc journals need extra spacing +\ifCLASSOPTIONconference\else +\def\@seccntformat#1{\csname the#1dis\endcsname\hskip 1em\relax} +\fi\fi + +%v1.7 put {} after #6 to allow for some types of user font control +%and use \@@par rather than \par +\def\@sect#1#2#3#4#5#6[#7]#8{% + \ifnum #2>\c@secnumdepth + \let\@svsec\@empty + \else + \refstepcounter{#1}% + % load section label and spacer into \@svsec + \ifnum #2=1 + \protected@edef\@svsec{\@seccntformatch{#1}\relax}% + \else + \ifnum #2>2 + \protected@edef\@svsec{\@seccntformatinl{#1}\relax}% + \else + \protected@edef\@svsec{\@seccntformat{#1}\relax}% + \fi + \fi + \fi% + \@tempskipa #5\relax + \ifdim \@tempskipa>\z@% tempskipa determines whether is treated as a high + \begingroup #6{\relax% or low level heading + \noindent % subsections are NOT indented + % print top level headings. \@svsec is label, #8 is heading title + % IEEE does not block indent the section title text, it flows like normal + {\hskip #3\relax\@svsec}{\interlinepenalty \@M #8\@@par}}% + \endgroup + \addcontentsline{toc}{#1}{\ifnum #2>\c@secnumdepth\relax\else + \protect\numberline{\csname the#1\endcsname}\fi#7}% + \else % printout low level headings + % svsechd seems to swallow the trailing space, protect it with \mbox{} + % got rid of sectionmark stuff + \def\@svsechd{#6{\hskip #3\relax\@svsec #8\@IEEEsectpunct\mbox{}}% + \addcontentsline{toc}{#1}{\ifnum #2>\c@secnumdepth\relax\else + \protect\numberline{\csname the#1\endcsname}\fi#7}}% + \fi%skip down + \@xsect{#5}} + + +% section* handler +%v1.7 put {} after #4 to allow for some types of user font control +%and use \@@par rather than \par +\def\@ssect#1#2#3#4#5{\@tempskipa #3\relax + \ifdim \@tempskipa>\z@ + %\begingroup #4\@hangfrom{\hskip #1}{\interlinepenalty \@M #5\par}\endgroup + % IEEE does not block indent the section title text, it flows like normal + \begingroup \noindent #4{\relax{\hskip #1}{\interlinepenalty \@M #5\@@par}}\endgroup + % svsechd swallows the trailing space, protect it with \mbox{} + \else \def\@svsechd{#4{\hskip #1\relax #5\@IEEEsectpunct\mbox{}}}\fi + \@xsect{#3}} + + +%% SECTION heading spacing and font +%% +% arguments are: #1 - sectiontype name +% (for \@sect) #2 - section level +% #3 - section heading indent +% #4 - top separation (absolute value used, neg indicates not to indent main text) +% If negative, make stretch parts negative too! +% #5 - (absolute value used) positive: bottom separation after heading, +% negative: amount to indent main text after heading +% Both #4 and #5 negative means to indent main text and use negative top separation +% #6 - font control +% You've got to have \normalfont\normalsize in the font specs below to prevent +% trouble when you do something like: +% \section{Note}{\ttfamily TT-TEXT} is known to ... +% IEEE sometimes REALLY stretches the area before a section +% heading by up to about 0.5in. However, it may not be a good +% idea to let LaTeX have quite this much rubber. +\ifCLASSOPTIONconference% +% IEEE wants section heading spacing to decrease for conference mode +\def\section{\@startsection{section}{1}{\z@}{1.5ex plus 1.5ex minus 0.5ex}% +{1sp}{\normalfont\normalsize\centering\scshape}}% +\def\subsection{\@startsection{subsection}{2}{\z@}{1.5ex plus 1.5ex minus 0.5ex}% +{1sp}{\normalfont\normalsize\itshape}}% +\else % for journals +\def\section{\@startsection{section}{1}{\z@}{3.0ex plus 1.5ex minus 1.5ex}% V1.6 3.0ex from 3.5ex +{0.7ex plus 1ex minus 0ex}{\normalfont\normalsize\centering\scshape}}% +\def\subsection{\@startsection{subsection}{2}{\z@}{3.5ex plus 1.5ex minus 1.5ex}% +{0.7ex plus .5ex minus 0ex}{\normalfont\normalsize\itshape}}% +\fi + +% for both journals and conferences +% decided to put in a little rubber above the section, might help somebody +\def\subsubsection{\@startsection{subsubsection}{3}{\parindent}{0ex plus 0.1ex minus 0.1ex}% +{0ex}{\normalfont\normalsize\itshape}}% +\def\paragraph{\@startsection{paragraph}{4}{2\parindent}{0ex plus 0.1ex minus 0.1ex}% +{0ex}{\normalfont\normalsize\itshape}}% + + +% compsoc +\ifCLASSOPTIONcompsoc +\ifCLASSOPTIONconference +% compsoc conference +\def\section{\@startsection{section}{1}{\z@}{1\baselineskip plus 0.25\baselineskip minus 0.25\baselineskip}% +{1\baselineskip plus 0.25\baselineskip minus 0.25\baselineskip}{\normalfont\large\bfseries}}% +\def\subsection{\@startsection{subsection}{2}{\z@}{1\baselineskip plus 0.25\baselineskip minus 0.25\baselineskip}% +{1\baselineskip plus 0.25\baselineskip minus 0.25\baselineskip}{\normalfont\sublargesize\bfseries}}% +\def\subsubsection{\@startsection{subsubsection}{3}{\z@}{1\baselineskip plus 0.25\baselineskip minus 0.25\baselineskip}% +{0ex}{\normalfont\normalsize\bfseries}}% +\def\paragraph{\@startsection{paragraph}{4}{2\parindent}{0ex plus 0.1ex minus 0.1ex}% +{0ex}{\normalfont\normalsize}}% +\else% compsoc journals +% use negative top separation as compsoc journals do not indent paragraphs after section titles +\def\section{\@startsection{section}{1}{\z@}{-3ex plus -2ex minus -1.5ex}% +{0.7ex plus 1ex minus 0ex}{\normalfont\large\sffamily\bfseries\scshape}}% +% Note that subsection and smaller may not be correct for the Computer Society, +% I have to look up an example. +\def\subsection{\@startsection{subsection}{2}{\z@}{-3.5ex plus -1.5ex minus -1.5ex}% +{0.7ex plus .5ex minus 0ex}{\normalfont\normalsize\sffamily\bfseries}}% +\def\subsubsection{\@startsection{subsubsection}{3}{\z@}{-2.5ex plus -1ex minus -1ex}% +{0.5ex plus 0.5ex minus 0ex}{\normalfont\normalsize\sffamily\itshape}}% +\def\paragraph{\@startsection{paragraph}{4}{2\parindent}{-0ex plus -0.1ex minus -0.1ex}% +{0ex}{\normalfont\normalsize}}% +\fi\fi + + + + +%% ENVIRONMENTS +% "box" symbols at end of proofs +\def\IEEEQEDclosed{\mbox{\rule[0pt]{1.3ex}{1.3ex}}} % for a filled box +% V1.6 some journals use an open box instead that will just fit around a closed one +\def\IEEEQEDopen{{\setlength{\fboxsep}{0pt}\setlength{\fboxrule}{0.2pt}\fbox{\rule[0pt]{0pt}{1.3ex}\rule[0pt]{1.3ex}{0pt}}}} +\ifCLASSOPTIONcompsoc +\def\IEEEQED{\IEEEQEDopen} % default to open for compsoc +\else +\def\IEEEQED{\IEEEQEDclosed} % otherwise default to closed +\fi + +% v1.7 name change to avoid namespace collision with amsthm. Also add support +% for an optional argument. +\def\IEEEproof{\@ifnextchar[{\@IEEEproof}{\@IEEEproof[\IEEEproofname]}} +\def\@IEEEproof[#1]{\par\noindent\hspace{2em}{\itshape #1: }} +\def\endIEEEproof{\hspace*{\fill}~\IEEEQED\par} + + +%\itemindent is set to \z@ by list, so define new temporary variable +\newdimen\@IEEEtmpitemindent +\def\@begintheorem#1#2{\@IEEEtmpitemindent\itemindent\topsep 0pt\rmfamily\trivlist% + \item[\hskip \labelsep{\indent\itshape #1\ #2:}]\itemindent\@IEEEtmpitemindent} +\def\@opargbegintheorem#1#2#3{\@IEEEtmpitemindent\itemindent\topsep 0pt\rmfamily \trivlist% +% V1.6 IEEE is back to using () around theorem names which are also in italics +% Thanks to Christian Peel for reporting this. + \item[\hskip\labelsep{\indent\itshape #1\ #2\ (#3):}]\itemindent\@IEEEtmpitemindent} +% V1.7 remove bogus \unskip that caused equations in theorems to collide with +% lines below. +\def\@endtheorem{\endtrivlist} + +% V1.6 +% display command for the section the theorem is in - so that \thesection +% is not used as this will be in Roman numerals when we want arabic. +% LaTeX2e uses \def\@thmcounter#1{\noexpand\arabic{#1}} for the theorem number +% (second part) display and \def\@thmcountersep{.} as a separator. +% V1.7 intercept calls to the section counter and reroute to \@IEEEthmcounterinsection +% to allow \appendix(ices} to override as needed. +% +% special handler for sections, allows appendix(ices) to override +\gdef\@IEEEthmcounterinsection#1{\arabic{#1}} +% string macro +\edef\@IEEEstringsection{section} + +% redefine the #1#2[#3] form of newtheorem to use a hook to \@IEEEthmcounterinsection +% if section in_counter is used +\def\@xnthm#1#2[#3]{% + \expandafter\@ifdefinable\csname #1\endcsname + {\@definecounter{#1}\@newctr{#1}[#3]% + \edef\@IEEEstringtmp{#3} + \ifx\@IEEEstringtmp\@IEEEstringsection + \expandafter\xdef\csname the#1\endcsname{% + \noexpand\@IEEEthmcounterinsection{#3}\@thmcountersep + \@thmcounter{#1}}% + \else + \expandafter\xdef\csname the#1\endcsname{% + \expandafter\noexpand\csname the#3\endcsname \@thmcountersep + \@thmcounter{#1}}% + \fi + \global\@namedef{#1}{\@thm{#1}{#2}}% + \global\@namedef{end#1}{\@endtheorem}}} + + + +%% SET UP THE DEFAULT PAGESTYLE +\ps@headings +\pagenumbering{arabic} + +% normally the page counter starts at 1 +\setcounter{page}{1} +% however, for peerreview the cover sheet is page 0 or page -1 +% (for duplex printing) +\ifCLASSOPTIONpeerreview + \if@twoside + \setcounter{page}{-1} + \else + \setcounter{page}{0} + \fi +\fi + +% standard book class behavior - let bottom line float up and down as +% needed when single sided +\ifCLASSOPTIONtwoside\else\raggedbottom\fi +% if two column - turn on twocolumn, allow word spacings to stretch more and +% enforce a rigid position for the last lines +\ifCLASSOPTIONtwocolumn +% the peer review option delays invoking twocolumn + \ifCLASSOPTIONpeerreview\else + \twocolumn + \fi +\sloppy +\flushbottom +\fi + + + + +% \APPENDIX and \APPENDICES definitions + +% This is the \@ifmtarg command from the LaTeX ifmtarg package +% by Peter Wilson (CUA) and Donald Arseneau +% \@ifmtarg is used to determine if an argument to a command +% is present or not. +% For instance: +% \@ifmtarg{#1}{\typeout{empty}}{\typeout{has something}} +% \@ifmtarg is used with our redefined \section command if +% \appendices is invoked. +% The command \section will behave slightly differently depending +% on whether the user specifies a title: +% \section{My appendix title} +% or not: +% \section{} +% This way, we can eliminate the blank lines where the title +% would be, and the unneeded : after Appendix in the table of +% contents +\begingroup +\catcode`\Q=3 +\long\gdef\@ifmtarg#1{\@xifmtarg#1QQ\@secondoftwo\@firstoftwo\@nil} +\long\gdef\@xifmtarg#1#2Q#3#4#5\@nil{#4} +\endgroup +% end of \@ifmtarg defs + + +% V1.7 +% command that allows the one time saving of the original definition +% of section to \@IEEEappendixsavesection for \appendix or \appendices +% we don't save \section here as it may be redefined later by other +% packages (hyperref.sty, etc.) +\def\@IEEEsaveoriginalsectiononce{\let\@IEEEappendixsavesection\section +\let\@IEEEsaveoriginalsectiononce\relax} + +% neat trick to grab and process the argument from \section{argument} +% we process differently if the user invoked \section{} with no +% argument (title) +% note we reroute the call to the old \section* +\def\@IEEEprocessthesectionargument#1{% +\@ifmtarg{#1}{% +\@IEEEappendixsavesection*{\appendixname~\thesectiondis}% +\addcontentsline{toc}{section}{\appendixname~\thesection}}{% +\@IEEEappendixsavesection*{\appendixname~\thesectiondis \\* #1}% +\addcontentsline{toc}{section}{\appendixname~\thesection: #1}}} + +% we use this if the user calls \section{} after +% \appendix-- which has no meaning. So, we ignore the +% command and its argument. Then, warn the user. +\def\@IEEEdestroythesectionargument#1{\typeout{** WARNING: Ignoring useless +\protect\section\space in Appendix (line \the\inputlineno).}} + + +% remember \thesection forms will be displayed in \ref calls +% and in the Table of Contents. +% The \sectiondis form is used in the actual heading itself + +% appendix command for one single appendix +% normally has no heading. However, if you want a +% heading, you can do so via the optional argument: +% \appendix[Optional Heading] +\def\appendix{\relax} +\renewcommand{\appendix}[1][]{\@IEEEsaveoriginalsectiononce\par + % v1.6 keep hyperref's identifiers unique + \gdef\theHsection{Appendix.A}% + % v1.6 adjust hyperref's string name for the section + \xdef\Hy@chapapp{appendix}% + \setcounter{section}{0}% + \setcounter{subsection}{0}% + \setcounter{subsubsection}{0}% + \setcounter{paragraph}{0}% + \gdef\thesection{A}% + \gdef\thesectiondis{}% + \gdef\thesubsection{\Alph{subsection}}% + \gdef\@IEEEthmcounterinsection##1{A} + \refstepcounter{section}% update the \ref counter + \@ifmtarg{#1}{\@IEEEappendixsavesection*{\appendixname}% + \addcontentsline{toc}{section}{\appendixname}}{% + \@IEEEappendixsavesection*{\appendixname~\\* #1}% + \addcontentsline{toc}{section}{\appendixname: #1}}% + % redefine \section command for appendix + % leave \section* as is + \def\section{\@ifstar{\@IEEEappendixsavesection*}{% + \@IEEEdestroythesectionargument}}% throw out the argument + % of the normal form +} + + + +% appendices command for multiple appendices +% user then calls \section with an argument (possibly empty) to +% declare the individual appendices +\def\appendices{\@IEEEsaveoriginalsectiononce\par + % v1.6 keep hyperref's identifiers unique + \gdef\theHsection{Appendix.\Alph{section}}% + % v1.6 adjust hyperref's string name for the section + \xdef\Hy@chapapp{appendix}% + \setcounter{section}{-1}% we want \refstepcounter to use section 0 + \setcounter{subsection}{0}% + \setcounter{subsubsection}{0}% + \setcounter{paragraph}{0}% + \ifCLASSOPTIONromanappendices% + \gdef\thesection{\Roman{section}}% + \gdef\thesectiondis{\Roman{section}}% + \@IEEEcompsocconfonly{\gdef\thesectiondis{\Roman{section}.}}% + \gdef\@IEEEthmcounterinsection##1{A\arabic{##1}} + \else% + \gdef\thesection{\Alph{section}}% + \gdef\thesectiondis{\Alph{section}}% + \@IEEEcompsocconfonly{\gdef\thesectiondis{\Alph{section}.}}% + \gdef\@IEEEthmcounterinsection##1{\Alph{##1}} + \fi% + \refstepcounter{section}% update the \ref counter + \setcounter{section}{0}% NEXT \section will be the FIRST appendix + % redefine \section command for appendices + % leave \section* as is + \def\section{\@ifstar{\@IEEEappendixsavesection*}{% process the *-form + \refstepcounter{section}% or is a new section so, + \@IEEEprocessthesectionargument}}% process the argument + % of the normal form +} + + + +% \IEEEPARstart +% Definition for the big two line drop cap letter at the beginning of the +% first paragraph of journal papers. The first argument is the first letter +% of the first word, the second argument is the remaining letters of the +% first word which will be rendered in upper case. +% In V1.6 this has been completely rewritten to: +% +% 1. no longer have problems when the user begins an environment +% within the paragraph that uses \IEEEPARstart. +% 2. auto-detect and use the current font family +% 3. revise handling of the space at the end of the first word so that +% interword glue will now work as normal. +% 4. produce correctly aligned edges for the (two) indented lines. +% +% We generalize things via control macros - playing with these is fun too. +% +% V1.7 added more control macros to make it easy for IEEEtrantools.sty users +% to change the font style. +% +% the number of lines that are indented to clear it +% may need to increase if using decenders +\def\@IEEEPARstartDROPLINES{2} +% minimum number of lines left on a page to allow a \@IEEEPARstart +% Does not take into consideration rubber shrink, so it tends to +% be overly cautious +\def\@IEEEPARstartMINPAGELINES{2} +% V1.7 the height of the drop cap is adjusted to match the height of this text +% in the current font (when \IEEEPARstart is called). +\def\@IEEEPARstartHEIGHTTEXT{T} +% the depth the letter is lowered below the baseline +% the height (and size) of the letter is determined by the sum +% of this value and the height of the \@IEEEPARstartHEIGHTTEXT in the current +% font. It is a good idea to set this value in terms of the baselineskip +% so that it can respond to changes therein. +\def\@IEEEPARstartDROPDEPTH{1.1\baselineskip} +% V1.7 the font the drop cap will be rendered in, +% can take zero or one argument. +\def\@IEEEPARstartFONTSTYLE{\bfseries} +% V1.7 any additional, non-font related commands needed to modify +% the drop cap letter, can take zero or one argument. +\def\@IEEEPARstartCAPSTYLE{\MakeUppercase} +% V1.7 the font that will be used to render the rest of the word, +% can take zero or one argument. +\def\@IEEEPARstartWORDFONTSTYLE{\relax} +% V1.7 any additional, non-font related commands needed to modify +% the rest of the word, can take zero or one argument. +\def\@IEEEPARstartWORDCAPSTYLE{\MakeUppercase} +% This is the horizontal separation distance from the drop letter to the main text. +% Lengths that depend on the font (e.g., ex, em, etc.) will be referenced +% to the font that is active when \IEEEPARstart is called. +\def\@IEEEPARstartSEP{0.15em} +% V1.7 horizontal offset applied to the left of the drop cap. +\def\@IEEEPARstartHOFFSET{0em} +% V1.7 Italic correction command applied at the end of the drop cap. +\def\@IEEEPARstartITLCORRECT{\/} + +% V1.7 compoc uses nonbold drop cap and small caps word style +\ifCLASSOPTIONcompsoc +\def\@IEEEPARstartFONTSTYLE{\mdseries} +\def\@IEEEPARstartWORDFONTSTYLE{\scshape} +\def\@IEEEPARstartWORDCAPSTYLE{\relax} +\fi + +% definition of \IEEEPARstart +% THIS IS A CONTROLLED SPACING AREA, DO NOT ALLOW SPACES WITHIN THESE LINES +% +% The token \@IEEEPARstartfont will be globally defined after the first use +% of \IEEEPARstart and will be a font command which creates the big letter +% The first argument is the first letter of the first word and the second +% argument is the rest of the first word(s). +\def\IEEEPARstart#1#2{\par{% +% if this page does not have enough space, break it and lets start +% on a new one +\@IEEEtranneedspace{\@IEEEPARstartMINPAGELINES\baselineskip}{\relax}% +% V1.7 move this up here in case user uses \textbf for \@IEEEPARstartFONTSTYLE +% which uses command \leavevmode which causes an unwanted \indent to be issued +\noindent +% calculate the desired height of the big letter +% it extends from the top of \@IEEEPARstartHEIGHTTEXT in the current font +% down to \@IEEEPARstartDROPDEPTH below the current baseline +\settoheight{\@IEEEtrantmpdimenA}{\@IEEEPARstartHEIGHTTEXT}% +\addtolength{\@IEEEtrantmpdimenA}{\@IEEEPARstartDROPDEPTH}% +% extract the name of the current font in bold +% and place it in \@IEEEPARstartFONTNAME +\def\@IEEEPARstartGETFIRSTWORD##1 ##2\relax{##1}% +{\@IEEEPARstartFONTSTYLE{\selectfont\edef\@IEEEPARstartFONTNAMESPACE{\fontname\font\space}% +\xdef\@IEEEPARstartFONTNAME{\expandafter\@IEEEPARstartGETFIRSTWORD\@IEEEPARstartFONTNAMESPACE\relax}}}% +% define a font based on this name with a point size equal to the desired +% height of the drop letter +\font\@IEEEPARstartsubfont\@IEEEPARstartFONTNAME\space at \@IEEEtrantmpdimenA\relax% +% save this value as a counter (integer) value (sp points) +\@IEEEtrantmpcountA=\@IEEEtrantmpdimenA% +% now get the height of the actual letter produced by this font size +\settoheight{\@IEEEtrantmpdimenB}{\@IEEEPARstartsubfont\@IEEEPARstartCAPSTYLE{#1}}% +% If something bogus happens like the first argument is empty or the +% current font is strange, do not allow a zero height. +\ifdim\@IEEEtrantmpdimenB=0pt\relax% +\typeout{** WARNING: IEEEPARstart drop letter has zero height! (line \the\inputlineno)}% +\typeout{ Forcing the drop letter font size to 10pt.}% +\@IEEEtrantmpdimenB=10pt% +\fi% +% and store it as a counter +\@IEEEtrantmpcountB=\@IEEEtrantmpdimenB% +% Since a font size doesn't exactly correspond to the height of the capital +% letters in that font, the actual height of the letter, \@IEEEtrantmpcountB, +% will be less than that desired, \@IEEEtrantmpcountA +% we need to raise the font size, \@IEEEtrantmpdimenA +% by \@IEEEtrantmpcountA / \@IEEEtrantmpcountB +% But, TeX doesn't have floating point division, so we have to use integer +% division. Hence the use of the counters. +% We need to reduce the denominator so that the loss of the remainder will +% have minimal affect on the accuracy of the result +\divide\@IEEEtrantmpcountB by 200% +\divide\@IEEEtrantmpcountA by \@IEEEtrantmpcountB% +% Then reequalize things when we use TeX's ability to multiply by +% floating point values +\@IEEEtrantmpdimenB=0.005\@IEEEtrantmpdimenA% +\multiply\@IEEEtrantmpdimenB by \@IEEEtrantmpcountA% +% \@IEEEPARstartfont is globaly set to the calculated font of the big letter +% We need to carry this out of the local calculation area to to create the +% big letter. +\global\font\@IEEEPARstartfont\@IEEEPARstartFONTNAME\space at \@IEEEtrantmpdimenB% +% Now set \@IEEEtrantmpdimenA to the width of the big letter +% We need to carry this out of the local calculation area to set the +% hanging indent +\settowidth{\global\@IEEEtrantmpdimenA}{\@IEEEPARstartfont +\@IEEEPARstartCAPSTYLE{#1\@IEEEPARstartITLCORRECT}}}% +% end of the isolated calculation environment +% add in the extra clearance we want +\advance\@IEEEtrantmpdimenA by \@IEEEPARstartSEP\relax% +% add in the optional offset +\advance\@IEEEtrantmpdimenA by \@IEEEPARstartHOFFSET\relax% +% V1.7 don't allow negative offsets to produce negative hanging indents +\@IEEEtrantmpdimenB\@IEEEtrantmpdimenA +\ifnum\@IEEEtrantmpdimenB < 0 \@IEEEtrantmpdimenB 0pt\fi +% \@IEEEtrantmpdimenA has the width of the big letter plus the +% separation space and \@IEEEPARstartfont is the font we need to use +% Now, we make the letter and issue the hanging indent command +% The letter is placed in a box of zero width and height so that other +% text won't be displaced by it. +\hangindent\@IEEEtrantmpdimenB\hangafter=-\@IEEEPARstartDROPLINES% +\makebox[0pt][l]{\hspace{-\@IEEEtrantmpdimenA}% +\raisebox{-\@IEEEPARstartDROPDEPTH}[0pt][0pt]{\hspace{\@IEEEPARstartHOFFSET}% +\@IEEEPARstartfont\@IEEEPARstartCAPSTYLE{#1\@IEEEPARstartITLCORRECT}% +\hspace{\@IEEEPARstartSEP}}}% +{\@IEEEPARstartWORDFONTSTYLE{\@IEEEPARstartWORDCAPSTYLE{\selectfont#2}}}} + + + + + + +% determines if the space remaining on a given page is equal to or greater +% than the specified space of argument one +% if not, execute argument two (only if the remaining space is greater than zero) +% and issue a \newpage +% +% example: \@IEEEtranneedspace{2in}{\vfill} +% +% Does not take into consideration rubber shrinkage, so it tends to +% be overly cautious +% Based on an example posted by Donald Arseneau +% Note this macro uses \@IEEEtrantmpdimenB internally for calculations, +% so DO NOT PASS \@IEEEtrantmpdimenB to this routine +% if you need a dimen register, import with \@IEEEtrantmpdimenA instead +\def\@IEEEtranneedspace#1#2{\penalty-100\begingroup%shield temp variable +\@IEEEtrantmpdimenB\pagegoal\advance\@IEEEtrantmpdimenB-\pagetotal% space left +\ifdim #1>\@IEEEtrantmpdimenB\relax% not enough space left +\ifdim\@IEEEtrantmpdimenB>\z@\relax #2\fi% +\newpage% +\fi\endgroup} + + + +% IEEEbiography ENVIRONMENT +% Allows user to enter biography leaving place for picture (adapts to font size) +% As of V1.5, a new optional argument allows you to have a real graphic! +% V1.5 and later also fixes the "colliding biographies" which could happen when a +% biography's text was shorter than the space for the photo. +% MDS 7/2001 +% V1.6 prevent multiple biographies from making multiple TOC entries +\newif\if@IEEEbiographyTOCentrynotmade +\global\@IEEEbiographyTOCentrynotmadetrue + +% biography counter so hyperref can jump directly to the biographies +% and not just the previous section +\newcounter{IEEEbiography} +\setcounter{IEEEbiography}{0} + +% photo area size +\def\@IEEEBIOphotowidth{1.0in} % width of the biography photo area +\def\@IEEEBIOphotodepth{1.25in} % depth (height) of the biography photo area +% area cleared for photo +\def\@IEEEBIOhangwidth{1.14in} % width cleared for the biography photo area +\def\@IEEEBIOhangdepth{1.25in} % depth cleared for the biography photo area + % actual depth will be a multiple of + % \baselineskip, rounded up +\def\@IEEEBIOskipN{4\baselineskip}% nominal value of the vskip above the biography + +\newenvironment{IEEEbiography}[2][]{\normalfont\@IEEEcompsoconly{\sffamily}\footnotesize% +\unitlength 1in\parskip=0pt\par\parindent 1em\interlinepenalty500% +% we need enough space to support the hanging indent +% the nominal value of the spacer +% and one extra line for good measure +\@IEEEtrantmpdimenA=\@IEEEBIOhangdepth% +\advance\@IEEEtrantmpdimenA by \@IEEEBIOskipN% +\advance\@IEEEtrantmpdimenA by 1\baselineskip% +% if this page does not have enough space, break it and lets start +% with a new one +\@IEEEtranneedspace{\@IEEEtrantmpdimenA}{\relax}% +% nominal spacer can strech, not shrink use 1fil so user can out stretch with \vfill +\vskip \@IEEEBIOskipN plus 1fil minus 0\baselineskip% +% the default box for where the photo goes +\def\@IEEEtempbiographybox{{\setlength{\fboxsep}{0pt}\framebox{% +\begin{minipage}[b][\@IEEEBIOphotodepth][c]{\@IEEEBIOphotowidth}\centering PLACE\\ PHOTO\\ HERE \end{minipage}}}}% +% +% detect if the optional argument was supplied, this requires the +% \@ifmtarg command as defined in the appendix section above +% and if so, override the default box with what they want +\@ifmtarg{#1}{\relax}{\def\@IEEEtempbiographybox{\mbox{\begin{minipage}[b][\@IEEEBIOphotodepth][c]{\@IEEEBIOphotowidth}% +\centering% +#1% +\end{minipage}}}}% end if optional argument supplied +% Make an entry into the table of contents only if we have not done so before +\if@IEEEbiographyTOCentrynotmade% +% link labels to the biography counter so hyperref will jump +% to the biography, not the previous section +\setcounter{IEEEbiography}{-1}% +\refstepcounter{IEEEbiography}% +\addcontentsline{toc}{section}{Biographies}% +\global\@IEEEbiographyTOCentrynotmadefalse% +\fi% +% one more biography +\refstepcounter{IEEEbiography}% +% Make an entry for this name into the table of contents +\addcontentsline{toc}{subsection}{#2}% +% V1.6 properly handle if a new paragraph should occur while the +% hanging indent is still active. Do this by redefining \par so +% that it will not start a new paragraph. (But it will appear to the +% user as if it did.) Also, strip any leading pars, newlines, or spaces. +\let\@IEEEBIOORGparCMD=\par% save the original \par command +\edef\par{\hfil\break\indent}% the new \par will not be a "real" \par +\settoheight{\@IEEEtrantmpdimenA}{\@IEEEtempbiographybox}% get height of biography box +\@IEEEtrantmpdimenB=\@IEEEBIOhangdepth% +\@IEEEtrantmpcountA=\@IEEEtrantmpdimenB% countA has the hang depth +\divide\@IEEEtrantmpcountA by \baselineskip% calculates lines needed to produce the hang depth +\advance\@IEEEtrantmpcountA by 1% ensure we overestimate +% set the hanging indent +\hangindent\@IEEEBIOhangwidth% +\hangafter-\@IEEEtrantmpcountA% +% reference the top of the photo area to the top of a capital T +\settoheight{\@IEEEtrantmpdimenB}{\mbox{T}}% +% set the photo box, give it zero width and height so as not to disturb anything +\noindent\makebox[0pt][l]{\hspace{-\@IEEEBIOhangwidth}\raisebox{\@IEEEtrantmpdimenB}[0pt][0pt]{% +\raisebox{-\@IEEEBIOphotodepth}[0pt][0pt]{\@IEEEtempbiographybox}}}% +% now place the author name and begin the bio text +\noindent\textbf{#2\ }\@IEEEgobbleleadPARNLSP}{\relax\let\par=\@IEEEBIOORGparCMD\par% +% 7/2001 V1.5 detect when the biography text is shorter than the photo area +% and pad the unused area - preventing a collision from the next biography entry +% MDS +\ifnum \prevgraf <\@IEEEtrantmpcountA\relax% detect when the biography text is shorter than the photo + \advance\@IEEEtrantmpcountA by -\prevgraf% calculate how many lines we need to pad + \advance\@IEEEtrantmpcountA by -1\relax% we compensate for the fact that we indented an extra line + \@IEEEtrantmpdimenA=\baselineskip% calculate the length of the padding + \multiply\@IEEEtrantmpdimenA by \@IEEEtrantmpcountA% + \noindent\rule{0pt}{\@IEEEtrantmpdimenA}% insert an invisible support strut +\fi% +\par\normalfont} + + + +% V1.6 +% added biography without a photo environment +\newenvironment{IEEEbiographynophoto}[1]{% +% Make an entry into the table of contents only if we have not done so before +\if@IEEEbiographyTOCentrynotmade% +% link labels to the biography counter so hyperref will jump +% to the biography, not the previous section +\setcounter{IEEEbiography}{-1}% +\refstepcounter{IEEEbiography}% +\addcontentsline{toc}{section}{Biographies}% +\global\@IEEEbiographyTOCentrynotmadefalse% +\fi% +% one more biography +\refstepcounter{IEEEbiography}% +% Make an entry for this name into the table of contents +\addcontentsline{toc}{subsection}{#1}% +\normalfont\@IEEEcompsoconly{\sffamily}\footnotesize\interlinepenalty500% +\vskip 4\baselineskip plus 1fil minus 0\baselineskip% +\parskip=0pt\par% +\noindent\textbf{#1\ }\@IEEEgobbleleadPARNLSP}{\relax\par\normalfont} + + +% provide the user with some old font commands +% got this from article.cls +\DeclareOldFontCommand{\rm}{\normalfont\rmfamily}{\mathrm} +\DeclareOldFontCommand{\sf}{\normalfont\sffamily}{\mathsf} +\DeclareOldFontCommand{\tt}{\normalfont\ttfamily}{\mathtt} +\DeclareOldFontCommand{\bf}{\normalfont\bfseries}{\mathbf} +\DeclareOldFontCommand{\it}{\normalfont\itshape}{\mathit} +\DeclareOldFontCommand{\sl}{\normalfont\slshape}{\@nomath\sl} +\DeclareOldFontCommand{\sc}{\normalfont\scshape}{\@nomath\sc} +\DeclareRobustCommand*\cal{\@fontswitch\relax\mathcal} +\DeclareRobustCommand*\mit{\@fontswitch\relax\mathnormal} + + +% SPECIAL PAPER NOTICE COMMANDS +% +% holds the special notice text +\def\@IEEEspecialpapernotice{\relax} + +% for special papers, like invited papers, the user can do: +% \IEEEspecialpapernotice{(Invited Paper)} before \maketitle +\def\IEEEspecialpapernotice#1{\ifCLASSOPTIONconference% +\def\@IEEEspecialpapernotice{{\Large#1\vspace*{1em}}}% +\else% +\def\@IEEEspecialpapernotice{{\\*[1.5ex]\sublargesize\textit{#1}}\vspace*{-2ex}}% +\fi} + + + + +% PUBLISHER ID COMMANDS +% to insert a publisher's ID footer +% V1.6 \IEEEpubid has been changed so that the change in page size and style +% occurs in \maketitle. \IEEEpubid must now be issued prior to \maketitle +% use \IEEEpubidadjcol as before - in the second column of the title page +% These changes allow \maketitle to take the reduced page height into +% consideration when dynamically setting the space between the author +% names and the maintext. +% +% the amount the main text is pulled up to make room for the +% publisher's ID footer +% IEEE uses about 1.3\baselineskip for journals, +% dynamic title spacing will clean up the fraction +\def\@IEEEpubidpullup{1.3\baselineskip} +\ifCLASSOPTIONtechnote +% for technotes it must be an integer of baselineskip as there can be no +% dynamic title spacing for two column mode technotes (the title is in the +% in first column) and we should maintain an integer number of lines in the +% second column +% There are some examples (such as older issues of "Transactions on +% Information Theory") in which IEEE really pulls the text off the ID for +% technotes - about 0.55in (or 4\baselineskip). We'll use 2\baselineskip +% and call it even. +\def\@IEEEpubidpullup{2\baselineskip} +\fi + +% V1.7 compsoc does not use a pullup +\ifCLASSOPTIONcompsoc +\def\@IEEEpubidpullup{0pt} +\fi + +% holds the ID text +\def\@IEEEpubid{\relax} + +% flag so \maketitle can tell if \IEEEpubid was called +\newif\if@IEEEusingpubid +\global\@IEEEusingpubidfalse +% issue this command in the page to have the ID at the bottom +% V1.6 use before \maketitle +\def\IEEEpubid#1{\def\@IEEEpubid{#1}\global\@IEEEusingpubidtrue} + + +% command which will pull up (shorten) the column it is executed in +% to make room for the publisher ID. Place in the second column of +% the title page when using \IEEEpubid +% Is smart enough not to do anything when in single column text or +% if the user hasn't called \IEEEpubid +% currently needed in for the second column of a page with the +% publisher ID. If not needed in future releases, please provide this +% command and define it as \relax for backward compatibility +% v1.6b do not allow command to operate if the peer review option has been +% selected because \IEEEpubidadjcol will not be on the cover page. +% V1.7 do nothing if compsoc +\def\IEEEpubidadjcol{\ifCLASSOPTIONcompsoc\else\ifCLASSOPTIONpeerreview\else +\if@twocolumn\if@IEEEusingpubid\enlargethispage{-\@IEEEpubidpullup}\fi\fi\fi\fi} + +% Special thanks to Peter Wilson, Daniel Luecking, and the other +% gurus at comp.text.tex, for helping me to understand how best to +% implement the IEEEpubid command in LaTeX. + + + +%% Lockout some commands under various conditions + +% general purpose bit bucket +\newsavebox{\@IEEEtranrubishbin} + +% flags to prevent multiple warning messages +\newif\if@IEEEWARNthanks +\newif\if@IEEEWARNIEEEPARstart +\newif\if@IEEEWARNIEEEbiography +\newif\if@IEEEWARNIEEEbiographynophoto +\newif\if@IEEEWARNIEEEpubid +\newif\if@IEEEWARNIEEEpubidadjcol +\newif\if@IEEEWARNIEEEmembership +\newif\if@IEEEWARNIEEEaftertitletext +\@IEEEWARNthankstrue +\@IEEEWARNIEEEPARstarttrue +\@IEEEWARNIEEEbiographytrue +\@IEEEWARNIEEEbiographynophototrue +\@IEEEWARNIEEEpubidtrue +\@IEEEWARNIEEEpubidadjcoltrue +\@IEEEWARNIEEEmembershiptrue +\@IEEEWARNIEEEaftertitletexttrue + + +%% Lockout some commands when in various modes, but allow them to be restored if needed +%% +% save commands which might be locked out +% so that the user can later restore them if needed +\let\@IEEESAVECMDthanks\thanks +\let\@IEEESAVECMDIEEEPARstart\IEEEPARstart +\let\@IEEESAVECMDIEEEbiography\IEEEbiography +\let\@IEEESAVECMDendIEEEbiography\endIEEEbiography +\let\@IEEESAVECMDIEEEbiographynophoto\IEEEbiographynophoto +\let\@IEEESAVECMDendIEEEbiographynophoto\endIEEEbiographynophoto +\let\@IEEESAVECMDIEEEpubid\IEEEpubid +\let\@IEEESAVECMDIEEEpubidadjcol\IEEEpubidadjcol +\let\@IEEESAVECMDIEEEmembership\IEEEmembership +\let\@IEEESAVECMDIEEEaftertitletext\IEEEaftertitletext + + +% disable \IEEEPARstart when in draft mode +% This may have originally been done because the pre-V1.6 drop letter +% algorithm had problems with a non-unity baselinestretch +% At any rate, it seems too formal to have a drop letter in a draft +% paper. +\ifCLASSOPTIONdraftcls +\def\IEEEPARstart#1#2{#1#2\if@IEEEWARNIEEEPARstart\typeout{** ATTENTION: \noexpand\IEEEPARstart + is disabled in draft mode (line \the\inputlineno).}\fi\global\@IEEEWARNIEEEPARstartfalse} +\fi +% and for technotes +\ifCLASSOPTIONtechnote +\def\IEEEPARstart#1#2{#1#2\if@IEEEWARNIEEEPARstart\typeout{** WARNING: \noexpand\IEEEPARstart + is locked out for technotes (line \the\inputlineno).}\fi\global\@IEEEWARNIEEEPARstartfalse} +\fi + + +% lockout unneeded commands when in conference mode +\ifCLASSOPTIONconference +% when locked out, \thanks, \IEEEbiography, \IEEEbiographynophoto, \IEEEpubid, +% \IEEEmembership and \IEEEaftertitletext will all swallow their given text. +% \IEEEPARstart will output a normal character instead +% warn the user about these commands only once to prevent the console screen +% from filling up with redundant messages +\def\thanks#1{\if@IEEEWARNthanks\typeout{** WARNING: \noexpand\thanks + is locked out when in conference mode (line \the\inputlineno).}\fi\global\@IEEEWARNthanksfalse} +\def\IEEEPARstart#1#2{#1#2\if@IEEEWARNIEEEPARstart\typeout{** WARNING: \noexpand\IEEEPARstart + is locked out when in conference mode (line \the\inputlineno).}\fi\global\@IEEEWARNIEEEPARstartfalse} + + +% LaTeX treats environments and commands with optional arguments differently. +% the actual ("internal") command is stored as \\commandname +% (accessed via \csname\string\commandname\endcsname ) +% the "external" command \commandname is a macro with code to determine +% whether or not the optional argument is presented and to provide the +% default if it is absent. So, in order to save and restore such a command +% we would have to save and restore \\commandname as well. But, if LaTeX +% ever changes the way it names the internal names, the trick would break. +% Instead let us just define a new environment so that the internal +% name can be left undisturbed. +\newenvironment{@IEEEbogusbiography}[2][]{\if@IEEEWARNIEEEbiography\typeout{** WARNING: \noexpand\IEEEbiography + is locked out when in conference mode (line \the\inputlineno).}\fi\global\@IEEEWARNIEEEbiographyfalse% +\setbox\@IEEEtranrubishbin\vbox\bgroup}{\egroup\relax} +% and make biography point to our bogus biography +\let\IEEEbiography=\@IEEEbogusbiography +\let\endIEEEbiography=\end@IEEEbogusbiography + +\renewenvironment{IEEEbiographynophoto}[1]{\if@IEEEWARNIEEEbiographynophoto\typeout{** WARNING: \noexpand\IEEEbiographynophoto + is locked out when in conference mode (line \the\inputlineno).}\fi\global\@IEEEWARNIEEEbiographynophotofalse% +\setbox\@IEEEtranrubishbin\vbox\bgroup}{\egroup\relax} + +\def\IEEEpubid#1{\if@IEEEWARNIEEEpubid\typeout{** WARNING: \noexpand\IEEEpubid + is locked out when in conference mode (line \the\inputlineno).}\fi\global\@IEEEWARNIEEEpubidfalse} +\def\IEEEpubidadjcol{\if@IEEEWARNIEEEpubidadjcol\typeout{** WARNING: \noexpand\IEEEpubidadjcol + is locked out when in conference mode (line \the\inputlineno).}\fi\global\@IEEEWARNIEEEpubidadjcolfalse} +\def\IEEEmembership#1{\if@IEEEWARNIEEEmembership\typeout{** WARNING: \noexpand\IEEEmembership + is locked out when in conference mode (line \the\inputlineno).}\fi\global\@IEEEWARNIEEEmembershipfalse} +\def\IEEEaftertitletext#1{\if@IEEEWARNIEEEaftertitletext\typeout{** WARNING: \noexpand\IEEEaftertitletext + is locked out when in conference mode (line \the\inputlineno).}\fi\global\@IEEEWARNIEEEaftertitletextfalse} +\fi + + +% provide a way to restore the commands that are locked out +\def\IEEEoverridecommandlockouts{% +\typeout{** ATTENTION: Overriding command lockouts (line \the\inputlineno).}% +\let\thanks\@IEEESAVECMDthanks% +\let\IEEEPARstart\@IEEESAVECMDIEEEPARstart% +\let\IEEEbiography\@IEEESAVECMDIEEEbiography% +\let\endIEEEbiography\@IEEESAVECMDendIEEEbiography% +\let\IEEEbiographynophoto\@IEEESAVECMDIEEEbiographynophoto% +\let\endIEEEbiographynophoto\@IEEESAVECMDendIEEEbiographynophoto% +\let\IEEEpubid\@IEEESAVECMDIEEEpubid% +\let\IEEEpubidadjcol\@IEEESAVECMDIEEEpubidadjcol% +\let\IEEEmembership\@IEEESAVECMDIEEEmembership% +\let\IEEEaftertitletext\@IEEESAVECMDIEEEaftertitletext} + + + +% need a backslash character for typeout output +{\catcode`\|=0 \catcode`\\=12 +|xdef|@IEEEbackslash{\}} + + +% hook to allow easy disabling of all legacy warnings +\def\@IEEElegacywarn#1#2{\typeout{** ATTENTION: \@IEEEbackslash #1 is deprecated (line \the\inputlineno). +Use \@IEEEbackslash #2 instead.}} + + +% provide for legacy commands +\def\authorblockA{\@IEEElegacywarn{authorblockA}{IEEEauthorblockA}\IEEEauthorblockA} +\def\authorblockN{\@IEEElegacywarn{authorblockN}{IEEEauthorblockN}\IEEEauthorblockN} +\def\authorrefmark{\@IEEElegacywarn{authorrefmark}{IEEEauthorrefmark}\IEEEauthorrefmark} +\def\PARstart{\@IEEElegacywarn{PARstart}{IEEEPARstart}\IEEEPARstart} +\def\pubid{\@IEEElegacywarn{pubid}{IEEEpubid}\IEEEpubid} +\def\pubidadjcol{\@IEEElegacywarn{pubidadjcol}{IEEEpubidadjcol}\IEEEpubidadjcol} +\def\QED{\@IEEElegacywarn{QED}{IEEEQED}\IEEEQED} +\def\QEDclosed{\@IEEElegacywarn{QEDclosed}{IEEEQEDclosed}\IEEEQEDclosed} +\def\QEDopen{\@IEEElegacywarn{QEDopen}{IEEEQEDopen}\IEEEQEDopen} +\def\specialpapernotice{\@IEEElegacywarn{specialpapernotice}{IEEEspecialpapernotice}\IEEEspecialpapernotice} + + + +% provide for legacy environments +\def\biography{\@IEEElegacywarn{biography}{IEEEbiography}\IEEEbiography} +\def\biographynophoto{\@IEEElegacywarn{biographynophoto}{IEEEbiographynophoto}\IEEEbiographynophoto} +\def\keywords{\@IEEElegacywarn{keywords}{IEEEkeywords}\IEEEkeywords} +\def\endbiography{\endIEEEbiography} +\def\endbiographynophoto{\endIEEEbiographynophoto} +\def\endkeywords{\endIEEEkeywords} + + +% provide for legacy IED commands/lengths when possible +\let\labelindent\IEEElabelindent +\def\calcleftmargin{\@IEEElegacywarn{calcleftmargin}{IEEEcalcleftmargin}\IEEEcalcleftmargin} +\def\setlabelwidth{\@IEEElegacywarn{setlabelwidth}{IEEEsetlabelwidth}\IEEEsetlabelwidth} +\def\usemathlabelsep{\@IEEElegacywarn{usemathlabelsep}{IEEEusemathlabelsep}\IEEEusemathlabelsep} +\def\iedlabeljustifyc{\@IEEElegacywarn{iedlabeljustifyc}{IEEEiedlabeljustifyc}\IEEEiedlabeljustifyc} +\def\iedlabeljustifyl{\@IEEElegacywarn{iedlabeljustifyl}{IEEEiedlabeljustifyl}\IEEEiedlabeljustifyl} +\def\iedlabeljustifyr{\@IEEElegacywarn{iedlabeljustifyr}{IEEEiedlabeljustifyr}\IEEEiedlabeljustifyr} + + + +% let \proof use the IEEEtran version even after amsthm is loaded +% \proof is now deprecated in favor of \IEEEproof +\AtBeginDocument{\def\proof{\@IEEElegacywarn{proof}{IEEEproof}\IEEEproof}\def\endproof{\endIEEEproof}} + +% V1.7 \overrideIEEEmargins is no longer supported. +\def\overrideIEEEmargins{% +\typeout{** WARNING: \string\overrideIEEEmargins \space no longer supported (line \the\inputlineno).}% +\typeout{** Use the \string\CLASSINPUTinnersidemargin, \string\CLASSINPUToutersidemargin \space controls instead.}} + + +\endinput + +%%%%%%%%%%%%%%%%%%%%%%%%%%%%% End of IEEEtran.cls %%%%%%%%%%%%%%%%%%%%%%%%%%%% +% That's all folks! + diff --git a/IEEEtran/.gitignore b/IEEEtran/.gitignore new file mode 100644 index 0000000..d417699 --- /dev/null +++ b/IEEEtran/.gitignore @@ -0,0 +1,12 @@ +bare_adv.dvi +bare_adv.pdf +bare_adv.ps +bare_conf.dvi +bare_conf.pdf +bare_conf.ps +bare_jrnl.dvi +bare_jrnl.pdf +bare_jrnl.ps +bare_jrnl_compsoc.dvi +bare_jrnl_compsoc.pdf +bare_jrnl_compsoc.ps diff --git a/IEEEtran/IEEEabrv.bib b/IEEEtran/IEEEabrv.bib new file mode 100644 index 0000000..56cae65 --- /dev/null +++ b/IEEEtran/IEEEabrv.bib @@ -0,0 +1,447 @@ + +IEEEabrv.bib +V1.12 (2007/01/11) +Copyright (c) 2002-2007 by Michael Shell +See: http://www.michaelshell.org/ +for current contact information. + +BibTeX bibliography string definitions of the ABBREVIATED titles of +IEEE journals and magazines and online publications. + +This file is designed for bibliography styles that require +abbreviated titles and is not for use in bibliographies that +require full-length titles. + +Support sites: +http://www.michaelshell.org/tex/ieeetran/ +http://www.ctan.org/tex-archive/macros/latex/contrib/IEEEtran/ +and/or +http://www.ieee.org/ + +Special thanks to Laura Hyslop and ken Rawson of IEEE for their help +in obtaining the information needed to compile this file. Also, +Volker Kuhlmann and Moritz Borgmann kindly provided some corrections +and additions. + +************************************************************************* +Legal Notice: +This code is offered as-is without any warranty either expressed or +implied; without even the implied warranty of MERCHANTABILITY or +FITNESS FOR A PARTICULAR PURPOSE! +User assumes all risk. +In no event shall IEEE or any contributor to this code be liable for +any damages or losses, including, but not limited to, incidental, +consequential, or any other damages, resulting from the use or misuse +of any information contained here. + +All comments are the opinions of their respective authors and are not +necessarily endorsed by the IEEE. + +This work is distributed under the LaTeX Project Public License (LPPL) +( http://www.latex-project.org/ ) version 1.3, and may be freely used, +distributed and modified. A copy of the LPPL, version 1.3, is included +in the base LaTeX documentation of all distributions of LaTeX released +2003/12/01 or later. +Retain all contribution notices and credits. +** Modified files should be clearly indicated as such, including ** +** renaming them and changing author support contact information. ** + +File list of work: IEEEabrv.bib, IEEEfull.bib, IEEEexample.bib, + IEEEtran.bst, IEEEtranS.bst, IEEEtranSA.bst, + IEEEtranN.bst, IEEEtranSN.bst, IEEEtran_bst_HOWTO.pdf +************************************************************************* + + +USAGE: + +\bibliographystyle{mybstfile} +\bibliography{IEEEabrv,mybibfile} + +where the IEEE titles in the .bib database entries use the strings +defined here. e.g., + + + journal = IEEE_J_AC, + + +to yield "{IEEE} Trans. Automat. Contr." + + +IEEE uses abbreviated journal titles in their bibliographies - +this file is suitable for work that is to be submitted to the IEEE. + + +For work that requires full-length titles, you should use the full +titles provided in the companion file, IEEEfull.bib. + + +** NOTES ** + + 1. Journals have been grouped according to subject in order to make it + easier to locate and extract the definitions for related journals - + as most works use references that are confined to a single topic. + Magazines are listed in straight alphabetical order. + + 2. String names are closely based on IEEE's own internal acronyms. + + 3. Abbreviations follow IEEE's style. + + 4. Older, out-of-print IEEE titles are included (but not including titles + dating prior to IEEE's formation from the IRE and AIEE in 1963). + + 5. The following NEW/current journal definitions have been disabled because + their abbreviations have not yet been verified: + + STRING{IEEE_J_CBB = "{IEEE/ACM} Trans. Comput. Biology Bioinformatics"} + STRING{IEEE_J_CJECE = "Canadian J. Elect. Comput. Eng."} + STRING{IEEE_J_DSC = "{IEEE} Trans. Dependable Secure Comput."} + STRING{IEEE_O_DSO = "{IEEE} Distrib. Syst. Online"} + + 6. The following OLD journal definitions have been disabled because + their abbreviations have not yet been found/verified: + + STRING{IEEE_J_BCTV = "{IEEE} Trans. Broadcast Television Receivers"} + STRING{IEEE_J_EWS = "{IEEE} Trans. Eng. Writing Speech"} + +If you know what the proper abbreviation is for a string in #5 or #6 above, +email me and I will correct them in the next release. + + + + + +IEEE Journals + + + +aerospace and military +@STRING{IEEE_J_AES = "{IEEE} Trans. Aerosp. Electron. Syst."} +@STRING{IEEE_J_ANE = "{IEEE} Trans. Aerosp. Navig. Electron."} +@STRING{IEEE_J_ANNE = "{IEEE} Trans. Aeronaut. Navig. Electron."} +@STRING{IEEE_J_AS = "{IEEE} Trans. Aerosp."} +@STRING{IEEE_J_AIRE = "{IEEE} Trans. Airborne Electron."} +@STRING{IEEE_J_MIL = "{IEEE} Trans. Mil. Electron."} + + + +autos, transportation and vehicles (non-aerospace) +@STRING{IEEE_J_ITS = "{IEEE} Trans. Intell. Transp. Syst."} +@STRING{IEEE_J_VT = "{IEEE} Trans. Veh. Technol."} +@STRING{IEEE_J_VC = "{IEEE} Trans. Veh. Commun."} + + + +circuits, signals, systems, audio and controls +@STRING{IEEE_J_SPL = "{IEEE} Signal Process. Lett."} +@STRING{IEEE_J_ASSP = "{IEEE} Trans. Acoust., Speech, Signal Process."} +@STRING{IEEE_J_AU = "{IEEE} Trans. Audio"} +@STRING{IEEE_J_AUEA = "{IEEE} Trans. Audio Electroacoust."} +@STRING{IEEE_J_AC = "{IEEE} Trans. Autom. Control"} +@STRING{IEEE_J_CAS = "{IEEE} Trans. Circuits Syst."} +@STRING{IEEE_J_CASVT = "{IEEE} Trans. Circuits Syst. Video Technol."} +@STRING{IEEE_J_CASI = "{IEEE} Trans. Circuits Syst. {I}"} +@STRING{IEEE_J_CASII = "{IEEE} Trans. Circuits Syst. {II}"} +in 2004 CASI and CASII renamed part title to CASI_RP and CASII_EB, respectively. +@STRING{IEEE_J_CASI_RP = "{IEEE} Trans. Circuits Syst. {I}"} +@STRING{IEEE_J_CASII_EB = "{IEEE} Trans. Circuits Syst. {II}"} +@STRING{IEEE_J_CT = "{IEEE} Trans. Circuit Theory"} +@STRING{IEEE_J_CST = "{IEEE} Trans. Control Syst. Technol."} +@STRING{IEEE_J_SP = "{IEEE} Trans. Signal Process."} +@STRING{IEEE_J_SU = "{IEEE} Trans. Sonics Ultrason."} +@STRING{IEEE_J_SAP = "{IEEE} Trans. Speech Audio Process."} +@STRING{IEEE_J_UE = "{IEEE} Trans. Ultrason. Eng."} +@STRING{IEEE_J_UFFC = "{IEEE} Trans. Ultrason., Ferroelectr., Freq. Control"} + + + +communications +@STRING{IEEE_J_COML = "{IEEE} Commun. Lett."} +@STRING{IEEE_J_JSAC = "{IEEE} J. Sel. Areas Commun."} +@STRING{IEEE_J_COM = "{IEEE} Trans. Commun."} +@STRING{IEEE_J_COMT = "{IEEE} Trans. Commun. Technol."} +@STRING{IEEE_J_WCOM = "{IEEE} Trans. Wireless Commun."} + + + +components, packaging and manufacturing +@STRING{IEEE_J_ADVP = "{IEEE} Trans. Adv. Packag."} +@STRING{IEEE_J_CHMT = "{IEEE} Trans. Compon., Hybrids, Manuf. Technol."} +@STRING{IEEE_J_CPMTA = "{IEEE} Trans. Compon., Packag., Manuf. Technol. {A}"} +@STRING{IEEE_J_CPMTB = "{IEEE} Trans. Compon., Packag., Manuf. Technol. {B}"} +@STRING{IEEE_J_CPMTC = "{IEEE} Trans. Compon., Packag., Manuf. Technol. {C}"} +@STRING{IEEE_J_CAPT = "{IEEE} Trans. Compon. Packag. Technol."} +@STRING{IEEE_J_CAPTS = "{IEEE} Trans. Compon. Packag. Technol."} +@STRING{IEEE_J_CPART = "{IEEE} Trans. Compon. Parts"} +@STRING{IEEE_J_EPM = "{IEEE} Trans. Electron. Packag. Manuf."} +@STRING{IEEE_J_MFT = "{IEEE} Trans. Manuf. Technol."} +@STRING{IEEE_J_PHP = "{IEEE} Trans. Parts, Hybrids, Packag."} +@STRING{IEEE_J_PMP = "{IEEE} Trans. Parts, Mater., Packag."} + + + +CAD +@STRING{IEEE_J_TCAD = "{IEEE} J. Technol. Comput. Aided Design"} +@STRING{IEEE_J_CAD = "{IEEE} Trans. Comput.-Aided Design Integr. Circuits Syst."} + + + +coding, data, information, knowledge +@STRING{IEEE_J_IT = "{IEEE} Trans. Inf. Theory"} +@STRING{IEEE_J_KDE = "{IEEE} Trans. Knowl. Data Eng."} + + + +computers, computation, networking and software +@STRING{IEEE_J_C = "{IEEE} Trans. Comput."} +@STRING{IEEE_J_CAL = "{IEEE} Comput. Archit. Lett."} +disabled till definition is verified +STRING{IEEE_J_DSC = "{IEEE} Trans. Dependable Secure Comput."} +@STRING{IEEE_J_ECOMP = "{IEEE} Trans. Electron. Comput."} +@STRING{IEEE_J_EVC = "{IEEE} Trans. Evol. Comput."} +@STRING{IEEE_J_FUZZ = "{IEEE} Trans. Fuzzy Syst."} +@STRING{IEEE_J_IFS = "{IEEE} Trans. Inf. Forensics Security"} +@STRING{IEEE_J_MC = "{IEEE} Trans. Mobile Comput."} +@STRING{IEEE_J_NET = "{IEEE/ACM} Trans. Netw."} +@STRING{IEEE_J_NN = "{IEEE} Trans. Neural Netw."} +@STRING{IEEE_J_PDS = "{IEEE} Trans. Parallel Distrib. Syst."} +@STRING{IEEE_J_SE = "{IEEE} Trans. Softw. Eng."} + + + +computer graphics, imaging, and multimedia +@STRING{IEEE_J_JDT = "{IEEE/OSA} J. Display Technol."} +@STRING{IEEE_J_IP = "{IEEE} Trans. Image Process."} +@STRING{IEEE_J_MM = "{IEEE} Trans. Multimedia"} +@STRING{IEEE_J_VCG = "{IEEE} Trans. Vis. Comput. Graphics"} + + + +cybernetics, ergonomics, robots, man-machine, and automation +@STRING{IEEE_J_ASE = "{IEEE} Trans. Autom. Sci. Eng."} +@STRING{IEEE_J_JRA = "{IEEE} J. Robot. Autom."} +@STRING{IEEE_J_HFE = "{IEEE} Trans. Hum. Factors Electron."} +@STRING{IEEE_J_MMS = "{IEEE} Trans. Man-Mach. Syst."} +@STRING{IEEE_J_PAMI = "{IEEE} Trans. Pattern Anal. Mach. Intell."} +in 1989 JRA became RA +in August 2004, RA split into ASE and RO +@STRING{IEEE_J_RA = "{IEEE} Trans. Robot. Autom."} +@STRING{IEEE_J_RO = "{IEEE} Trans. Robot."} +@STRING{IEEE_J_SMC = "{IEEE} Trans. Syst., Man, Cybern."} +@STRING{IEEE_J_SMCA = "{IEEE} Trans. Syst., Man, Cybern. {A}"} +@STRING{IEEE_J_SMCB = "{IEEE} Trans. Syst., Man, Cybern. {B}"} +@STRING{IEEE_J_SMCC = "{IEEE} Trans. Syst., Man, Cybern. {C}"} +@STRING{IEEE_J_SSC = "{IEEE} Trans. Syst. Sci. Cybern."} + + + +earth, wind, fire and water +@STRING{IEEE_J_GE = "{IEEE} Trans. Geosci. Electron."} +@STRING{IEEE_J_GRS = "{IEEE} Trans. Geosci. Remote Sens."} +@STRING{IEEE_J_GRSL = "{IEEE} Geosci. Remote Sens. Lett."} +@STRING{IEEE_J_OE = "{IEEE} J. Ocean. Eng."} + + + +education, engineering, history, IEEE, professional +disabled till definition is verified +STRING{IEEE_J_CJECE = "Canadian J. Elect. Comput. Eng."} +@STRING{IEEE_J_PROC = "Proc. {IEEE}"} +@STRING{IEEE_J_EDU = "{IEEE} Trans. Educ."} +@STRING{IEEE_J_EM = "{IEEE} Trans. Eng. Manag."} +disabled till definition is verified +STRING{IEEE_J_EWS = "{IEEE} Trans. Eng. Writing Speech"} +@STRING{IEEE_J_PC = "{IEEE} Trans. Prof. Commun."} + + + +electromagnetics, antennas, EMI, magnetics and microwave +@STRING{IEEE_J_AWPL = "{IEEE} Antennas Wireless Propag. Lett."} +@STRING{IEEE_J_MGWL = "{IEEE} Microw. Guided Wave Lett."} +IEEE seems to want "Compon." here, not "Comp." +@STRING{IEEE_J_MWCL = "{IEEE} Microw. Wireless Compon. Lett."} +@STRING{IEEE_J_AP = "{IEEE} Trans. Antennas Propag."} +@STRING{IEEE_J_EMC = "{IEEE} Trans. Electromagn. Compat."} +@STRING{IEEE_J_MAG = "{IEEE} Trans. Magn."} +@STRING{IEEE_J_MTT = "{IEEE} Trans. Microw. Theory Tech."} +@STRING{IEEE_J_RFI = "{IEEE} Trans. Radio Freq. Interference"} +@STRING{IEEE_J_TJMJ = "{IEEE} Transl. J. Magn. Jpn."} + + + +energy and power +@STRING{IEEE_J_EC = "{IEEE} Trans. Energy Convers."} +@STRING{IEEE_J_PEL = "{IEEE} Power Electron. Lett."} +@STRING{IEEE_J_PWRAS = "{IEEE} Trans. Power App. Syst."} +@STRING{IEEE_J_PWRD = "{IEEE} Trans. Power Del."} +@STRING{IEEE_J_PWRE = "{IEEE} Trans. Power Electron."} +@STRING{IEEE_J_PWRS = "{IEEE} Trans. Power Syst."} + + + +industrial, commercial and consumer +@STRING{IEEE_J_APPIND = "{IEEE} Trans. Appl. Ind."} +@STRING{IEEE_J_BC = "{IEEE} Trans. Broadcast."} +disabled till definition is verified +STRING{IEEE_J_BCTV = "{IEEE} Trans. Broadcast Television Receivers"} +@STRING{IEEE_J_CE = "{IEEE} Trans. Consum. Electron."} +@STRING{IEEE_J_IE = "{IEEE} Trans. Ind. Electron."} +@STRING{IEEE_J_IECI = "{IEEE} Trans. Ind. Electron. Contr. Instrum."} +@STRING{IEEE_J_IA = "{IEEE} Trans. Ind. Appl."} +@STRING{IEEE_J_IGA = "{IEEE} Trans. Ind. Gen. Appl."} +@STRING{IEEE_J_IINF = "{IEEE} Trans. Ind. Informat."} +@STRING{IEEE_J_PSE = "{IEEE} J. Product Safety Eng."} + + + +instrumentation and measurement +@STRING{IEEE_J_IM = "{IEEE} Trans. Instrum. Meas."} + + + +insulation and materials +@STRING{IEEE_J_JEM = "{IEEE/TMS} J. Electron. Mater."} +@STRING{IEEE_J_DEI = "{IEEE} Trans. Dielectr. Electr. Insul."} +@STRING{IEEE_J_EI = "{IEEE} Trans. Electr. Insul."} + + + +mechanical +@STRING{IEEE_J_MECH = "{IEEE/ASME} Trans. Mechatronics"} +@STRING{IEEE_J_MEMS = "J. Microelectromech. Syst."} + + + +medical and biological +@STRING{IEEE_J_BME = "{IEEE} Trans. Biomed. Eng."} +Note: The B-ME journal later dropped the hyphen and became the BME. +@STRING{IEEE_J_B-ME = "{IEEE} Trans. Bio-Med. Eng."} +@STRING{IEEE_J_BMELC = "{IEEE} Trans. Bio-Med. Electron."} +disabled till definition is verified +STRING{IEEE_J_CBB = "{IEEE/ACM} Trans. Comput. Biology Bioinformatics"} +@STRING{IEEE_J_ITBM = "{IEEE} Trans. Inf. Technol. Biomed."} +@STRING{IEEE_J_ME = "{IEEE} Trans. Med. Electron."} +@STRING{IEEE_J_MI = "{IEEE} Trans. Med. Imag."} +@STRING{IEEE_J_NB = "{IEEE} Trans. Nanobiosci."} +@STRING{IEEE_J_NSRE = "{IEEE} Trans. Neural Syst. Rehabil. Eng."} +@STRING{IEEE_J_RE = "{IEEE} Trans. Rehabil. Eng."} + + + + optics, lightwave and photonics +@STRING{IEEE_J_PTL = "{IEEE} Photon. Technol. Lett."} +@STRING{IEEE_J_JLT = "J. Lightw. Technol."} + + + +physics, electrons, nanotechnology, nuclear and quantum electronics +@STRING{IEEE_J_EDL = "{IEEE} Electron Device Lett."} +@STRING{IEEE_J_JQE = "{IEEE} J. Quantum Electron."} +@STRING{IEEE_J_JSTQE = "{IEEE} J. Sel. Topics Quantum Electron."} +@STRING{IEEE_J_ED = "{IEEE} Trans. Electron Devices"} +@STRING{IEEE_J_NANO = "{IEEE} Trans. Nanotechnol."} +@STRING{IEEE_J_NS = "{IEEE} Trans. Nucl. Sci."} +@STRING{IEEE_J_PS = "{IEEE} Trans. Plasma Sci."} + + + +reliability +IEEE seems to want "Mat." here, not "Mater." +@STRING{IEEE_J_DMR = "{IEEE} Trans. Device Mater. Rel."} +@STRING{IEEE_J_R = "{IEEE} Trans. Rel."} + + + +semiconductors, superconductors, electrochemical and solid state +@STRING{IEEE_J_ESSL = "{IEEE/ECS} Electrochem. Solid-State Lett."} +@STRING{IEEE_J_JSSC = "{IEEE} J. Solid-State Circuits"} +@STRING{IEEE_J_ASC = "{IEEE} Trans. Appl. Supercond."} +@STRING{IEEE_J_SM = "{IEEE} Trans. Semicond. Manuf."} + + + +sensors +@STRING{IEEE_J_SENSOR = "{IEEE} Sensors J."} + + + +VLSI +@STRING{IEEE_J_VLSI = "{IEEE} Trans. {VLSI} Syst."} + + + + + + +IEEE Magazines + + + +@STRING{IEEE_M_AES = "{IEEE} Aerosp. Electron. Syst. Mag."} +@STRING{IEEE_M_HIST = "{IEEE} Ann. Hist. Comput."} +@STRING{IEEE_M_AP = "{IEEE} Antennas Propag. Mag."} +@STRING{IEEE_M_ASSP = "{IEEE} {ASSP} Mag."} +@STRING{IEEE_M_CD = "{IEEE} Circuits Devices Mag."} +@STRING{IEEE_M_CAS = "{IEEE} Circuits Syst. Mag."} +@STRING{IEEE_M_COM = "{IEEE} Commun. Mag."} +@STRING{IEEE_M_COMSOC = "{IEEE} Commun. Soc. Mag."} +@STRING{IEEE_M_CIM = "{IEEE} Comput. Intell. Mag."} +CSEM changed to CSE in 1999 +@STRING{IEEE_M_CSE = "{IEEE} Comput. Sci. Eng."} +@STRING{IEEE_M_CSEM = "{IEEE} Comput. Sci. Eng. Mag."} +@STRING{IEEE_M_C = "{IEEE} Computer"} +@STRING{IEEE_M_CAP = "{IEEE} Comput. Appl. Power"} +@STRING{IEEE_M_CGA = "{IEEE} Comput. Graph. Appl."} +@STRING{IEEE_M_CONC = "{IEEE} Concurrency"} +@STRING{IEEE_M_CS = "{IEEE} Control Syst. Mag."} +@STRING{IEEE_M_DTC = "{IEEE} Des. Test. Comput."} +@STRING{IEEE_M_EI = "{IEEE} Electr. Insul. Mag."} +@STRING{IEEE_M_ETR = "{IEEE} ElectroTechnol. Rev."} +@STRING{IEEE_M_EMB = "{IEEE} Eng. Med. Biol. Mag."} +@STRING{IEEE_M_EMR = "{IEEE} Eng. Manag. Rev."} +@STRING{IEEE_M_EXP = "{IEEE} Expert"} +@STRING{IEEE_M_IA = "{IEEE} Ind. Appl. Mag."} +@STRING{IEEE_M_IM = "{IEEE} Instrum. Meas. Mag."} +@STRING{IEEE_M_IS = "{IEEE} Intell. Syst."} +@STRING{IEEE_M_IC = "{IEEE} Internet Comput."} +@STRING{IEEE_M_ITP = "{IEEE} {IT} Prof."} +@STRING{IEEE_M_MICRO = "{IEEE} Micro"} +@STRING{IEEE_M_MW = "{IEEE} Microw. Mag."} +@STRING{IEEE_M_MM = "{IEEE} Multimedia"} +@STRING{IEEE_M_NET = "{IEEE} Netw."} +IEEE's editorial manual lists "Pers. Commun.", +but "Personal Commun. Mag." seems to be what is used in the journals +@STRING{IEEE_M_PCOM = "{IEEE} Personal Commun. Mag."} +@STRING{IEEE_M_POT = "{IEEE} Potentials"} +CAP and PER merged to form PE in 2003 +@STRING{IEEE_M_PE = "{IEEE} Power Energy Mag."} +@STRING{IEEE_M_PER = "{IEEE} Power Eng. Rev."} +@STRING{IEEE_M_PVC = "{IEEE} Pervasive Comput."} +@STRING{IEEE_M_RA = "{IEEE} Robot. Autom. Mag."} +@STRING{IEEE_M_SAP = "{IEEE} Security Privacy"} +@STRING{IEEE_M_SP = "{IEEE} Signal Process. Mag."} +@STRING{IEEE_M_S = "{IEEE} Softw."} +@STRING{IEEE_M_SPECT = "{IEEE} Spectr."} +@STRING{IEEE_M_TS = "{IEEE} Technol. Soc. Mag."} +@STRING{IEEE_M_VT = "{IEEE} Veh. Technol. Mag."} +@STRING{IEEE_M_WC = "{IEEE} Wireless Commun. Mag."} +@STRING{IEEE_M_TODAY = "Today's Engineer"} + + + + + + +IEEE Online Publications + + + +@STRING{IEEE_O_CSTO = "{IEEE} Commun. Surveys Tuts."} +disabled till definition is verified +STRING{IEEE_O_DSO = "{IEEE} Distrib. Syst. Online"} + + + + + +-- +EOF diff --git a/IEEEtran/IEEEexample.bib b/IEEEtran/IEEEexample.bib new file mode 100644 index 0000000..024745c --- /dev/null +++ b/IEEEtran/IEEEexample.bib @@ -0,0 +1,1190 @@ + +IEEEexample.bib +V1.12 (2007/01/11) +Copyright (c) 2002-2007 by Michael Shell +See: http://www.michaelshell.org/ +for current contact information. + +This is an example BibTeX database for the official IEEEtran.bst +BibTeX style file. + +Some entries call strings that are defined in the IEEEabrv.bib file. +Therefore, IEEEabrv.bib should be loaded prior to this file. +Usage: + +\bibliographystyle{./IEEEtran} +\bibliography{./IEEEabrv,./IEEEexample} + + +Support sites: +http://www.michaelshell.org/tex/ieeetran/ +http://www.ctan.org/tex-archive/macros/latex/contrib/IEEEtran/ +and/or +http://www.ieee.org/ + +************************************************************************* +Legal Notice: +This code is offered as-is without any warranty either expressed or +implied; without even the implied warranty of MERCHANTABILITY or +FITNESS FOR A PARTICULAR PURPOSE! +User assumes all risk. +In no event shall IEEE or any contributor to this code be liable for +any damages or losses, including, but not limited to, incidental, +consequential, or any other damages, resulting from the use or misuse +of any information contained here. + +All comments are the opinions of their respective authors and are not +necessarily endorsed by the IEEE. + +This work is distributed under the LaTeX Project Public License (LPPL) +( http://www.latex-project.org/ ) version 1.3, and may be freely used, +distributed and modified. A copy of the LPPL, version 1.3, is included +in the base LaTeX documentation of all distributions of LaTeX released +2003/12/01 or later. +Retain all contribution notices and credits. +** Modified files should be clearly indicated as such, including ** +** renaming them and changing author support contact information. ** + +File list of work: IEEEabrv.bib, IEEEfull.bib, IEEEexample.bib, + IEEEtran.bst, IEEEtranS.bst, IEEEtranSA.bst, + IEEEtranN.bst, IEEEtranSN.bst, IEEEtran_bst_HOWTO.pdf +************************************************************************* + + +Note that, because the example references were taken from actual IEEE +publications, these examples do not always contain the full amount +of information that may be desirable (for use with other BibTeX styles). +In particular, full names (not abbreviated with initials) should be +entered whenever possible as some (non-IEEE) bibliography styles use +full names. IEEEtran.bst will automatically abbreviate when it encounters +full names. + + + + +references for the IEEEtran.bst documentation +IEEEtran homepage +@electronic{IEEEhowto:IEEEtranpage, + author = "Michael Shell", + title = "{IEEE}tran Homepage", + url = "http://www.michaelshell.org/tex/ieeetran/", + year = "2007" +} + + +the distribution site for IEEEtran.bst +@electronic{IEEEexample:shellCTANpage, + author = "Michael Shell", + title = "{IEEE}tran Webpage on {CTAN}", + url = "http://www.ctan.org/tex-archive/macros/latex/contrib/IEEEtran/", + year = "2007" +} + + +the IEEE website +sort key is needed for sorting styles +@electronic{IEEEexample:IEEEwebsite, + title = "The {IEEE} Website", + url = "http://www.ieee.org/", + year = "2007", + key = "IEEE" +} + + +The BibTeX user's guide. +The filename could have been put in the URL instead. But, there might +be other interesting things for the user in the same directory - and +the filename might change before the directory that contains it. +@electronic{IEEEexample:bibtexuser, + author = "Oren Patashnik", + title = "{{\BibTeX}}ing", + howpublished = "{btxdoc.pdf}", + url = "http://www.ctan.org/tex-archive/biblio/bibtex/contrib/doc/", + month = feb, + year = "1988" +} + + +The BibTeX style designer's guide. +@electronic{IEEEexample:bibtexdesign, + author = "Oren Patashnik", + title = "Designing {{\BibTeX}} Styles", + howpublished = "{btxhak.pdf}", + url = "http://www.ctan.org/tex-archive/biblio/bibtex/contrib/doc/", + month = feb, + year = "1988" +} + + +A comprehensive BibTeX tutorial. +@electronic{IEEEexample:tamethebeast, + author = "Nicolas Markey", + title = "Tame the BeaST --- The B to X of {{\BibTeX}}", + url = "http://tug.ctan.org/tex-archive/info/bibtex/tamethebeast/", + month = oct, + year = "2005" +} + + +The BibTeX Tips and FAQ guide. +@electronic{IEEEexample:bibtexFAQ, + author = "David Hoadley and Michael Shell", + title = "{{\BibTeX}} Tips and {FAQ}", + howpublished = "{btxFAQ.pdf}", + url = "http://www.ctan.org/tex-archive/biblio/bibtex/contrib/doc/", + month = jan, + year = "2007" +} + + +The TeX FAQ +@electronic{IEEEexample:texfaq, + author = "Robin Fairbairns", + title = "The {{\TeX}} {FAQ}", + url = "http://www.tex.ac.uk/cgi-bin/texfaq2html/", + month = jan, + year = "2007" +} + + +A BibTeX Guide via Examples. +@electronic{IEEEexample:bibtexguide, + author = "Ki-Joo Kim", + title = "A {{\BibTeX}} Guide via Examples", + howpublished = "{bibtex\_guide.pdf}", + url = "http://www.geocities.com/kijoo2000/", + month = apr, + year = "2004" +} + + +TeX User Group Bibliography Archive +@electronic{IEEEexample:beebe_archive, + author = "Nelson H. F. Beebe", + title = "{{\TeX}} User Group Bibliography Archive", + url = "http://www.math.utah.edu:8080/pub/tex/bib/index-table.html", + month = aug, + year = "2006" +} + +The natbib.sty package. +@electronic{ctan:natbib, + author = "Patrick W. Daly", + title = "The natbib.sty package", + url = "http://www.ctan.org/tex-archive/macros/latex/contrib/natbib/", + month = sep, + year = "2006" +} + +The url.sty package. +@electronic{IEEEexample:urlsty, + author = "Donald Arseneau", + title = "The url.sty Package", + url = "http://www.ctan.org/tex-archive/macros/latex/contrib/misc/", + month = jun, + year = "2005", +} + + +The hyperref.sty package. +@electronic{IEEEexample:hyperrefsty, + author = "Sebastian Rahtz and Heiko Oberdiek", + title = "The hyperref.sty Package", + url = "http://www.ctan.org/tex-archive/macros/latex/contrib/hyperref/", + month = nov, + year = "2006", +} + + +The breakurl.sty package. +@electronic{IEEEexample:breakurl, + author = "Vilar Camara Neto", + title = "The breakurl.sty Package", + url = "http://www.ctan.org/tex-archive/macros/latex/contrib/breakurl/", + month = aug, + year = "2006", +} + + +The Babel package. +@electronic{IEEEexample:babel, + author = "Johannes Braams", + title = "The Babel Package", + url = "http://www.ctan.org/tex-archive/macros/latex/required/babel/", + month = nov, + year = "2005", +} + + +The multibib package. +@electronic{IEEEexample:multibibsty, + author = "Thorsten Hansen", + title = "The multibib.sty package", + url = "http://www.ctan.org/tex-archive/macros/latex/contrib/multibib/", + month = jan, + year = "2004" +} + + +The biblatex package. +@electronic{IEEEexample:biblatex, + author = "Philipp Lehman", + title = "The biblatex package", + url = "http://www.ctan.org/tex-archive/macros/latex/exptl/biblatex/", + month = jan, + year = "2007" +} + + + +The three most common and typical types of references used in +IEEE publications: + +an article in a journal +Note the use of the IEEE_J_EDL string, defined in the IEEEabrv.bib file, +for the journal name. IEEEtran.bst defines the BibTeX standard three +letter month codes per IEEE style. +From the June 2002 issue of "IEEE Transactions on Electron Devices", +page 996, reference #16. +@article{IEEEexample:article_typical, + author = "S. Zhang and C. Zhu and J. K. O. Sin and P. K. T. Mok", + title = "A Novel Ultrathin Elevated Channel Low-temperature + Poly-{Si} {TFT}", + journal = IEEE_J_EDL, + volume = "20", + month = nov, + year = "1999", + pages = "569-571" +} + + +journal article using et al. +The (five) authors are actually: F. Delorme, S. Slempkes, G. Alibert, +B. Rose, J. Brandon +The month (July) was not given here. +From the September 1998 issue of "IEEE Journal on Selected Areas in +Communications", page 1257, reference #28. +@article{IEEEexample:articleetal, + author = "F. Delorme and others", + title = "Butt-jointed {DBR} Laser With 15 {nm} Tunability Grown + in Three {MOVPE} Steps", + journal = "Electron. Lett.", + volume = "31", + number = "15", + year = "1995", + pages = "1244-1245" +} + + +a paper in a conference proceedings +"conference" can be used as an alias for "inproceedings" +From the June 2002 issue of "Journal of Microelectromechanical Systems", +page 205, reference #16. +@inproceedings{IEEEexample:conf_typical, + author = "R. K. Gupta and S. D. Senturia", + title = "Pull-in Time Dynamics as a Measure of Absolute Pressure", + booktitle = "Proc. {IEEE} International Workshop on + Microelectromechanical Systems ({MEMS}'97)", + address = "Nagoya, Japan", + month = jan, + year = "1997", + pages = "290-294" +} + + +a book +From the May 2002 issue of "IEEE Transactions on Magnetics", +page 1466, reference #4. +@book{IEEEexample:book_typical, + author = "B. D. Cullity", + title = "Introduction to Magnetic Materials", + publisher = "Addison-Wesley", + address = "Reading, MA", + year = "1972" +} + + + + +Other examples + +journal article with large page numbers, IEEE will divide numbers 5 digits +or longer into groups of three with small spaces between them. Page ranges +can be separated via either "-" or "--", IEEEtran.bst will automatically +convert the separator dash(es) to "--". +Authors and/or IEEE do not always provide/use the journal number, but it +was used in this case. IEEEtran.bst can be configured to ignore journal +numbers if desired. +From the August 2000 issue of "IEEE Photonics Technology Letters", +page 1039, reference #11. +@article{IEEEexample:articlelargepages, + author = "A. Castaldini and A. Cavallini and B. Fraboni + and P. Fernandez and J. Piqueras", + title = "Midgap Traps Related to Compensation Processes in + {CdTe} Alloys", + journal = "Phys. Rev. B.", + volume = "56", + number = "23", + year = "1997", + pages = "14897-14900" +} + + +journal article with dual months +use the BibTeX "#" concatenation operator +From the March 2002 issue of "IEEE Transactions on Mechatronics", +page 21, reference #8. +@article{IEEEexample:articledualmonths, + author = "Y. Okada and K. Dejima and T. Ohishi", + title = "Analysis and Comparison of {PM} Synchronous Motor and + Induction Motor Type Magnetic Bearings", + journal = IEEE_J_IA, + volume = "31", + month = sep # "/" # oct, + year = "1995", + pages = "1047-1053" +} + + +journal article to be published as a misc entry type +date information like month and year is optional +However, the article form like that below may be a better approach. +From the May 2002 issue of "IEEE Journal of Selected Areas in +Communication", page 725, reference #3. +@misc{IEEEexample:TBPmisc, + author = "M. Coates and A. Hero and R. Nowak and B. Yu", + title = "Internet Tomography", + howpublished = IEEE_M_SP, + month = may, + year = "2002", + note = "to be published" +} + + +journal article to be published as an article entry type +year is required, so if absent, use the year field to hold +the "submitted for publication" in order to avoid a warning for +the missing year field. +From the June 2002 issue of "IEEE Transactions on Information Theory", +page 1461, reference #21. +@article{IEEEexample:TBParticle, + author = "N. Kahale and R. Urbanke", + title = "On the Minimum Distance of Parallel and Serially + Concatenated Codes", + journal = IEEE_J_IT, + year = "submitted for publication" +} + + + + + +book with editor and no author +From the June 2002 issue of "IEEE Transactions on Information Theory", +page 1725, reference #1. +@book{IEEEexample:bookwitheditor, + editor = "J. C. Candy and G. C. Temes", + title = "Oversampling Delta-Sigma Data Converters Theory, + Design and Simulation", + publisher = "{IEEE} Press.", + address = "New York", + year = "1992" +} + + +book with edition, author and editor +Note that the standard BibTeX styles do not support book entries with both +author and editor fields, but IEEEtran.bst does. +The standard BibTeX way of specifying the edition is to use capitalized +ordinal words such as "First", "Second", etc. Most .bst files can convert +up to about "Fifth" into the format needed. IEEEtran.bst can convert up +to "Tenth" to the "Arabic ordinal" form IEEE uses (e.g., "10th"). For +editions over the tenth, it is best to use the "Arabic ordinal" form for +IEEE related work (e.g., "101st") +Note how "Jr." has to be entered. +From the May 2002 issue of "Journal of Lightwave Technology", page 856, +reference #17. +@book{IEEEexample:book, + author = "S. M. Metev and V. P. Veiko", + editor = "Osgood, Jr., R. M.", + title = "Laser Assisted Microtechnology", + edition = "Second", + publisher = "Springer-Verlag", + address = "Berlin, Germany", + year = "1998" +} + + +book with series and volume +From the January 2000 issue of "IEEE Transactions on Communications", +page 11, reference #31. +@book{IEEEexample:bookwithseriesvolume, + editor = "J. Breckling", + title = "The Analysis of Directional Time Series: Applications to + Wind Speed and Direction", + series = "Lecture Notes in Statistics", + publisher = "Springer", + address = "Berlin, Germany", + year = "1989", + volume = "61" +} + + +inbook with chapter number. The pages field could also have been given. +The chapter number could be changed to something else such as a section +number via the type field: type = "sec.". +From the May 2002 issue of "IEEE Transactions on Circuits and Systems---I: +Fundamental Applications and Theory", page 638, reference #22. +@inbook{IEEEexample:inbook, + author = "H. E. Rose", + title = "A Course in Number Theory", + publisher = "Oxford Univ. Press", + address = "New York, NY", + year = "1988", + chapter = "3" +} + + +inbook with pages and note. The language field is not set to Russian +because the title is presented here in its translated, English, form. +From the May 2002 issue of "IEEE Transactions on Magnetics", page 1533, +reference #5. +@inbook{IEEEexample:inbookpagesnote, + author = "B. K. Bul", + title = "Theory Principles and Design of Magnetic Circuits", + publisher = "Energia Press", + address = "Moscow", + year = "1964", + pages = "464", + note = "(in Russian)" +} + + + + + +incollection with author and editor +From the May 2002 issue of "Journal of Lightwave Technology", +page 807, reference #7. +@incollection{IEEEexample:incollection, + author = "W. V. Sorin", + editor = "D. Derickson", + title = "Optical Reflectometry for Component Characterization", + booktitle = "Fiber Optic Test and Measurement", + publisher = "Prentice-Hall", + address = "Englewood Cliffs, NJ", + year = "1998" +} + + +incollection with series +From the April 2000 issue of "IEEE Transactions on Communication", +page 609, reference #3. +@incollection{IEEEexample:incollectionwithseries, + author = "J. B. Anderson and K. Tepe", + title = "Properties of the Tailbiting {BCJR} Decoder", + booktitle = "Codes, Systems and Graphical Models", + series = "{IMA} Volumes in Mathematics and Its Applications", + publisher = "Springer-Verlag", + address = "New York", + year = "2000" + +} + + +incollection with author, editor, chapter and pages +From the January 2000 issue of "IEEE Transactions on Communications", +page 16, reference #9. +@incollection{IEEEexample:incollection_chpp, + author = "P. Hedelin and P. Knagenhjelm and M. Skoglund", + editor = "W. B. Kleijn and K. K. Paliwal", + title = "Theory for Transmission of Vector Quantization Data", + booktitle = "Speech Coding and Synthesis", + publisher = "Elsevier Science", + address = "Amsterdam, The Netherlands", + year = "1995", + chapter = "10", + pages = "347-396" +} + + +incollection with a large number of authors, some authors/journals will +use et al. for so many names. IEEEtran.bst can be configured to do this +if desired, or "R. M. A. Dawson and others" can be used instead. +Note that IEEE may not include the publisher for incollection entries - +IEEEtran.bst will not issue a warning if the publisher is missing for +incollections - but other .bst files often will. +From the June 2002 issue of "IEEE Transactions on Electron Devices", +page 996, reference #12. +@incollection{IEEEexample:incollectionmanyauthors, + author = "R. M. A. Dawson and Z. Shen and D. A. Furst and + S. Connor and J. Hsu and M. G. Kane and R. G. Stewart and + A. Ipri and C. N. King and P. J. Green and R. T. Flegal + and S. Pearson and W. A. Barrow and E. Dickey and K. Ping + and C. W. Tang and S. Van. Slyke and + F. Chen and J. Shi and J. C. Sturm and M. H. Lu", + title = "Design of an Improved Pixel for a Polysilicon + Active-Matrix Organic {LED} Display", + booktitle = "{SID} Tech. Dig.", + volume = "29", + year = "1998", + pages = "11-14" +} + + + + + +A Motorola data book as a manual +It is somewhat unusual to include the data book part number. +in the title. It might be more correct to put this information +in the howpublished field instead. +From the December 2000 issue of "IEEE Transactions on Communications", +page 1986, reference #10. +@manual{IEEEexample:motmanual, + title = "{FLEXChip} Signal Processor ({MC68175/D})", + organization = "Motorola", + year = "1996" +} + + +same reference, but using IEEEtran's howpublished extension +@manual{IEEEexample:motmanualhowpub, + title = "{FLEXChip} Signal Processor", + howpublished = "{MC68175/D}", + organization = "Motorola", + year = "1996" +} + + + + +conference paper with an address and days. Some journals capitalize the +letters in "Globecom", this one did not. +From the May 2002 issue of "IEEE Transactions on Communications", +page 697, reference #12. +@inproceedings{IEEEexample:confwithadddays, + author = "M. S. Yee and L. Hanzo", + title = "Radial Basis Function Decision Feedback Equaliser + Assisted Burst-by-burst Adaptive Modulation", + booktitle = "Proc. {IEEE} Globecom '99", + address = "Rio de Janeiro, Brazil", + month = dec # " 5--9,", + year = "1999", + pages = "2183-2187" +} + + +conference paper with volume number. A conference proceedings with a vol +number is a little uncommon, note that the vol number is placed +before the address in the formatted bibliography entry +From the April 2002 issue of "IEEE/ACM Transactions on Networking", +page 181, reference #26. +@inproceedings{IEEEexample:confwithvolume, + author = "M. Yajnik and S. B. Moon and J. Kurose and D. Towsley", + title = "Measurement and Modeling of the Temporal Dependence in + Packet Loss", + booktitle = "Proc. {IEEE} {INFOCOM}'99", + volume = "1", + address = "New York, NY", + month = mar, + year = "1999", + pages = "345-352" +} + + +conference paper with a paper number, the type field can be used to +override the word "paper", e.g., type = "postdeadline paper". A type +can be given even without a paper field. +Also, IEEEtran.bst can be configured to ignore paper numbers and types. +From the May 2002 issue of "Journal of Lightwave Technology", +page 807, reference #4. +@inproceedings{IEEEexample:confwithpaper, + author = "M. Wegmuller and J. P. von der Weid and P. Oberson + and N. Gisin", + title = "High Resolution Fiber Distributed Measurements With + Coherent {OFDR}", + booktitle = "Proc. {ECOC}'00", + year = "2000", + paper = "11.3.4", + pages = "109" +} + + +conference paper with a postdeadline type paper, the paper field is +optional. +From the August 2000 issue of "IEEE Photonics Technology Letters", +page 1087, reference #12. +@inproceedings{IEEEexample:confwithpapertype, + author = "B. Mikkelsen and G. Raybon and R.-J. Essiambre and + K. Dreyer and Y. Su. and L. E. Nelson and J. E. Johnson + and G. Shtengel and A. Bond and D. G. Moodie and + A. D. Ellis", + title = "160 {Gbit/s} Single-channel Transmission Over 300 km + Nonzero-dispersion Fiber With Semiconductor Based + Transmitter and Demultiplexer", + booktitle = "Proc. {ECOC}'99", + year = "1999", + paper = "2-3", + type = "postdeadline paper", + pages = "28-29" +} + + +presented at a conference +intype overrides the default "in" and causes the booktitle not to be +emphasized (rendered in italics). +From the February 2002 issue of "IEEE/ACM Transactions on Networking", +page 163, reference #6. +@inproceedings{IEEEexample:presentedatconf, + author = "S. G. Finn and M. M{\'e}dard and R. A. Barry", + title = "A Novel Approach to Automatic Protection Switching + Using Trees", + intype = "presented at the", + booktitle = "Proc. Int. Conf. Commun.", + year = "1997" +} + + + + + +master's thesis, often the University name will be abbreviated and the +state or country will be included in the address. The type field can +used to override the default type "Master's thesis" +From the June 2002 issue of "IEEE Transactions on Microelectromechanical +Systems", page 186, reference #11. +@mastersthesis{IEEEexample:masters, + author = "Nin C. Loh", + title = "High-Resolution Micromachined Interferometric + Accelerometer", + school = "Massachusetts Institute of Technology", + address = "Cambridge", + year = "1992" +} + + +master's thesis with a type field +From the August 2001 issue of "IEEE/ACM Transactions on Networking", +page 391, reference #12. +@mastersthesis{IEEEexample:masterstype, + author = "A. Karnik", + title = "Performance of {TCP} Congestion Control with Rate + Feedback: {TCP/ABR} and Rate Adaptive {TCP/IP}", + school = "Indian Institute of Science", + type = "M. Eng. thesis", + address = "Bangalore, India", + month = jan, + year = "1999" +} + + + + + +Ph.D. dissertation with a URL field, the university is abbreviated +From the October 2001 issue of "IEEE/ACM Transactions on Networking", +page 590, reference #11. +@phdthesis{IEEEexample:phdurl, + author = "Q. Li", + title = "Delay Characterization and Performance Control of + Wide-area Networks", + school = "Univ. of Delaware", + address = "Newark", + month = may, + year = "2000", + url = "http://www.ece.udel.edu/~qli" +} + + + + + +technical report +From the August 2001 issue of "IEEE/ACM Transactions on Networking", +page 490, reference #15. +@techreport{IEEEexample:techrep, + author = "R. Jain and K. K. Ramakrishnan and D. M. Chiu", + title = "Congestion Avoidance in Computer Networks with a + Connectionless Network Layer", + institution = "Digital Equipment Corporation", + address = "MA", + number = "DEC-TR-506", + month = aug, + year = "1987" +} + + +technical report with type +for those times when "Tech. Rep." needs to be modified +From the February 2001 issue of "IEEE/ACM Transactions on Networking", +page 46, reference #8. +@techreport{IEEEexample:techreptype, + author = "J. Padhye and V. Firoiu and D. Towsley", + title = "A Stochastic Model of {TCP} {R}eno Congestion Avoidance + and Control", + institution = "Univ. of Massachusetts", + address = "Amherst, MA", + type = "CMPSCI Tech. Rep.", + number = "99-02", + year = "1999" +} + + +technical report with type +for those times when "Tech. Rep." needs to be modified +This reference did not have an address. +From the January 2000 issue of "IEEE Transactions on Communications", +page 117, reference #6. +@techreport{IEEEexample:techreptypeii, + author = "D. Middleton and A. D. Spaulding", + title = "A Tutorial Review of Elements of Weak Signal Detection + in Non-{G}aussian {EMI} Environments", + institution = "National Telecommunications and Information + Administration ({NTIA}), U.S. Dept. of Commerce", + type = "NTIA Report", + number = "86-194", + month = may, + year = "1986" +} + + + + + +an unpublished work +for unpublished types, the note field is required. IEEE usually +just uses the word "unpublished" for the note. +From the August 2001 issue of "IEEE/ACM Transactions on Networking", +page 391, reference #16. +@unpublished{IEEEexample:unpublished, + author = "T. J. Ott and N. Aggarwal", + title = "{TCP} over {ATM}: {ABR} or {UBR}", + note = "Unpublished" +} + + + + + +electronic with a howpublished information field +From the August 2001 issue of "IEEE/ACM Transactions on Networking", +page 391, reference #7. +@electronic{IEEEexample:electronhowinfo, + author = "V. Jacobson", + title = "Modified {TCP} Congestion Avoidance Algorithm", + howpublished = "end2end-interest mailing list", + url = "ftp://ftp.isi.edu/end2end/end2end-interest-1990.mail", + month = apr, + year = "1990" +} + + +electronic with a howpublished information field +From the August 2001 issue of "IEEE/ACM Transactions on Networking", +page 418, reference #31. +@electronic{IEEEexample:electronhowinfo2, + author = "V. Valloppillil and K. W. Ross", + title = "Cache Array Routing Protocol v1.1", + howpublished = "Internet draft", + url = "http://ds1.internic.net/internet-drafts/draft-vinod-carp-v1-03.txt", + year = "1998" +} + + +electronic with an organization and address +From the February 2002 issue of "IEEE/ACM Transactions on Networking", +page 114, reference #15. +@electronic{IEEEexample:electronorgadd, + author = "D. H. Lorenz and A. Orda", + title = "Optimal Partition of {QoS} Requirements on Unicast + Paths and Multicast Trees", + organization = "Dept. Elect. Eng., Technion", + address = "Haifa, Israel", + url = "ftp://ftp.technion.ac.il/pub/supported/ee/Network/lor.mopq98.ps", + month = jul, + year = "1998" +} + + + + + +U.S. patent +Use the type field to override the patent type. e.g., +type = "Patent Application" +The address is that of the assignee. Note that IEEE does not +display the assignee, the address, and only displays one date. +(if year is not present, the filed dates are used.) However, this +information should be entered as other BibTeX styles may use it. +alternatively, nationality could be entered as "U.S." +From the April 2000 issue of "IEEE Transactions on Communications", +page 542, reference #6. +@patent{IEEEexample:uspat, + author = "Ronald E. Sorace and Victor S. Reinhardt and + Steven A. Vaughn", + assignee = "Hughes Aircraft Company", + address = "Los Angeles, CA", + title = "High-Speed Digital-to-{RF} Converter", + nationality = "United States", + number = "5668842", + dayfiled = "28", + monthfiled = feb, + yearfiled = "1995", + day = "16", + month = sep, + year = "1997" +} + + +Japanese Patent +From the April 2000 issue of "IEEE Transactions on Communications", +page 556, reference #6. +@patent{IEEEexample:jppat, + author = "U. Hideki", + title = "Quadrature Modulation Circuit", + nationality = "Japanese", + number = "152932/92", + day = "20", + month = may, + year = "1992" +} + + +French Patent request, the language field must be entered in lower case +as this is the option name Babel uses. The nationality field needs to be +capitalized. Because this is a patent request, the date filed fields are +used while the date fields are left empty/missing. In other countries, +the words "Patent Application", etc. are used instead. +From the April 2000 issue of "IEEE Transactions on Communications", +page 556, reference #9. +@patent{IEEEexample:frenchpatreq, + author = "F. Kowalik and M. Isard", + title = "Estimateur d'un D{\'e}faut de Fonctionnement + d'un Modulateur en Quadrature et {\'E}tage de Modulation + l'Utilisant", + language = "french", + nationality = "French", + type = "Patent Request", + number = "9500261", + dayfiled = "11", + monthfiled = jan, + yearfiled = "1995" +} + + + + + +a periodical +From the April 2001 issue of "IEEE/ACM Transactions on Networking", +page 160, reference #1. +sort key is needed for sorting styles +@periodical{IEEEexample:periodical, + title = IEEE_M_PCOM # ", Special Issue on Wireless {ATM}", + volume = "3", + month = aug, + year = "1996", + key = "IEEE" +} + + + + + +standard, IEEE does not use the address for standards, but it is good +to provide one for BibTeX styles that use it. +From the August 2001 issue of "IEEE/ACM Transactions on Networking", +page 451, reference #2. +@standard{IEEEexample:standard, + title = "Wireless {LAN} Medium Access Control {(MAC)} and + Physical Layer {(PHY)} Specification", + organization = "IEEE", + address = "Piscataway, NJ", + number = "802.11", + year = "1997" +} + + +standard with type and revision, the type overrides the word standard +(or std.). Here a standard number is not available and a revision number +is used. +From the August 2000 issue of "IEEE Photonics Technology Letters", +page 1048, reference #13. +@standard{IEEEexample:standardproposed, + title = "Fiber Channel Physical Interface ({FC-PI})", + institution = "NCITS", + address = "Washington, DC", + type = "Working Draft Proposed Standard", + revision = "5.2", + year = "1999" +} + + +standard draft as a misc with author +From the May 2002 issue of "IEEE Journal of Selected Areas in +Communication", page 725, reference #16. +@misc{IEEEexample:draftasmisc, + author = "I. Widjaja and A. Elwalid", + title = "{MATE}: {MPLS} Adaptive Traffic Engineering", + howpublished = "IETF Draft", + year = "1999" +} + + + + + +misc for a techreport like reference +techreport is not perfectly suitable because this entry lacks +an institution field +From the August 2001 issue of "IEEE/ACM Transactions on Networking", +page 490, reference #22. +@misc{IEEEexample:miscforum, + author = "L. Roberts", + title = "Enhanced Proportional Rate Control Algorithm {PRCA}", + howpublished = "{ATM} Forum Contribution 94-0735R1", + month = aug, + year = "1994" +} + + +misc for a white paper +From the August 2001 issue of "IEEE/ACM Transactions on Networking", +page 478, reference #4 - Note that the reference there (improperly?) +used the author field for "Cisco". +@misc{IEEEexample:whitepaper, + title = "Advanced {QoS} Services for the Intelligent Internet", + howpublished = "White Paper", + organization = "Cisco", + month = may, + year = "1997" +} + + +misc for a data sheet +From the November 2000 issue of "IEEE Photonics Technology Letters", +page 1551, reference #6. +@misc{IEEEexample:datasheet, + title = "{PDCA12-70} Data Sheet", + organization = "Opto Speed SA", + address = "Mezzovico, Switzerland" +} + + + + + +Other unusual references + +a private communication as a misc entry type +sometimes the designation "personal communication" is used instead +From the June 2002 issue of "IEEE Transactions on Information Theory", +page 1725, reference #16. +@misc{IEEEexample:private, + author = "S. Konyagin", + howpublished = "private communication", + year = "1998" +} + + +an internet request for comments (RFC) as a misc entry type +It would also be nice to add a URL to these types of things. +RFCs can also be handled as electronic references. +From the April 2002 issue of "IEEE/ACM Transactions on Networking", +page 181, reference #14. +@misc{IEEEexample:miscrfc, + author = "K. K. Ramakrishnan and S. Floyd", + title = "A Proposal to Add Explicit Congestion + Notification ({ECN}) to {IP}", + howpublished = "RFC 2481", + month = jan, + year = "1999" +} + + +a software package as a manual +From the June 2002 issue of "IEEE/ASME Journal of Microelectromechanical +Systems", page 205, reference #20. +Sometimes they put the version/release information in the title. +@manual{IEEEexample:softmanual, + title = "SaberDesigner Reference Manual", + organization = "Analogy, Inc.", + address = "Beaverton, OR", + year = "1998", + note = "Release 4.3" +} + + +a software package as an electronic reference +From the February 2003 issue of "IEEE/ACM Transactions on Networking", +page 46, reference #24. If there is no author or organization, a sorting +key is required for sorting styles. It might be a good idea to include +month and year fields as well. +@electronic{IEEEexample:softonline, + title = "Ucb/lbnl/vint Network Simulator---ns (Version 2)", + url = "http://www-mash.cs.berkeley.edu/ns/", + key = "ns" +} + + +misc for a German regulation +In German, the first letters of nouns are capitalized, so we do so here. +From the June 2002 issue of "IEEE Journal in Selected Areas in +Communication", page 892, reference #9. +@misc{IEEEexample:miscgermanreg, + title = "{M}essung von {S}t{\"o}rfeldern an {A}nlagen + und {L}eitungen der {T}elekommunikation im + {F}requenzbereich 9 {kHz} bis 3 {GHz}", + language = "german", + howpublished = "{M}e{\ss}vorschrift {R}eg {TP} {MV} 05", + organization = "Regulierungsbeh{\"o}rde f{\"u}r {T}elekommunikation und + {P}ost ({R}eg {TP})" +} + + + +Ways to handle things like CCSDS's Blue Books +journal article with a URL. However, this is not a very good approach +because the Blue Books are not really journals and the author field has +to be abused. +From the June 2002 issue of "IEEE Transactions on Information Theory", +page 1461, reference #7. +@article{IEEEexample:bluebookarticle, + author = "{Consulative Committee for Space Data Systems (CCSDS)}", + title = "Telemetry Channel Coding", + journal = "Blue Book", + number = "4", + year = "1999", + url = "http://www.ccsds.org/documents/pdf/CCSDS-101.0-B-4.pdf" +} + + +CCSDS's Blue Book handled as a book +However, it is not a good idea to have to use the author field for +an organization (done here because the book entry type requires an +author field). +@book{IEEEexample:bluebookbook, + author = "{Consulative Committee for Space Data Systems (CCSDS)}", + title = "Telemetry Channel Coding", + series = "Blue Book", + number = "4", + publisher = "{CCSDS}", + address = "Newport Beach, {CA}", + year = "1999", + url = "http://www.ccsds.org/documents/pdf/CCSDS-101.0-B-4.pdf" +} + + +CCSDS's Blue Book handled as a manual +This is a much better approach, but uses the howpublished field. +@manual{IEEEexample:bluebookmanual, + title = "Telemetry Channel Coding", + howpublished = "ser. Blue Book, No. 4", + organization = "Consulative Committee for Space Data Systems (CCSDS)", + address = "Newport Beach, CA", + year = "1999", + url = "http://www.ccsds.org/documents/pdf/CCSDS-101.0-B-4.pdf" +} + + + +CCSDS's Blue Book handled as a standard +Probably the best approach for this particular case because the work +is standard related. Note that IEEE does not display the address for +standards. +@standard{IEEEexample:bluebookstandard, + title = "Telemetry Channel Coding", + howpublished = "ser. Blue Book, No. 4", + organization = "Consulative Committee for Space Data Systems (CCSDS)", + address = "Newport Beach, CA", + type = "Recommendation for Space Data System Standard", + number = "101.0-B-4", + month = May, + year = "1999", + url = "http://www.ccsds.org/documents/pdf/CCSDS-101.0-B-4.pdf" +} + + + + + + + + +An example of a IEEEtran control entry which can change some IEEEtran.bst +settings. An entry like this must be cited via \bstctlcite{} command +before the first real \cite{}. The same entry key cannot be called twice +(just like multiple \cite{} of the same entry key place only one entry +in the bibliography.) +The available control fields are: + +CTLuse_article_number +"no" turns off the display of the number for articles. +"yes" enables + +CTLuse_paper +"no" turns off the display of the paper and type fields in inproceedings. +"yes" enables + +CTLuse_forced_etal +"no" turns off the forced use of "et al." +"yes" enables + +CTLmax_names_forced_etal +The maximum number of names that can be present beyond which an "et al." +usage is forced. Be sure that CTLnames_show_etal (below) +is not greater than this value! + +CTLnames_show_etal +The number of names that will be shown with a forced "et al.". +Must be less than or equal to CTLmax_names_forced_etal + +CTLuse_alt_spacing +"no" turns off the alternate interword spacing for entries with URLs. +"yes" enables + +CTLalt_stretch_factor +If alternate interword spacing for entries with URLs is enabled, this is +the interword spacing stretch factor that will be used. For example, the +default "4" here means that the interword spacing in entries with URLs can +stretch to four times normal. Does not have to be an integer. + +CTLdash_repeated_names +"no" turns off the "dashification" of repeated (i.e., identical to those +of the previous entry) names. IEEE normally does this. +"yes" enables + +CTLname_format_string +The name format control string as explained in the BibTeX style hacking +guide. +IEEE style "{f.~}{vv~}{ll}{, jj}" is the default, + +CTLname_latex_cmd +A LaTeX command that each name will be fed to (e.g., "\textsc"). +Leave empty if no special font is desired for the names. +The default is empty. + +CTLname_url_prefix +The prefix text used before URLs. +The default is "[Online]. Available:" A space will be inserted after this +text. If this space is not wanted, just use \relax at the end of the +prefix text. + + +Those fields that are not to be changed can be left out. +@IEEEtranBSTCTL{IEEEexample:BSTcontrol, + CTLuse_article_number = "yes", + CTLuse_paper = "yes", + CTLuse_forced_etal = "no", + CTLmax_names_forced_etal = "10", + CTLnames_show_etal = "1", + CTLuse_alt_spacing = "yes", + CTLalt_stretch_factor = "4", + CTLdash_repeated_names = "yes", + CTLname_format_string = "{f.~}{vv~}{ll}{, jj}", + CTLname_latex_cmd = "", + CTLname_url_prefix = "[Online]. Available:" +} + + diff --git a/IEEEtran/IEEEfull.bib b/IEEEtran/IEEEfull.bib new file mode 100644 index 0000000..8f07c8c --- /dev/null +++ b/IEEEtran/IEEEfull.bib @@ -0,0 +1,419 @@ + +IEEEfull.bib +V1.12 (2007/01/11) +Copyright (c) 2002-2007 by Michael Shell +See: http://www.michaelshell.org/ +for current contact information. + +BibTeX bibliography string definitions of the FULL titles of +IEEE journals and magazines and online publications. + +This file is designed for bibliography styles that require +full-length titles and is not for use in bibliographies that +abbreviate titles. + +Support sites: +http://www.michaelshell.org/tex/ieeetran/ +http://www.ctan.org/tex-archive/macros/latex/contrib/IEEEtran/ +and/or +http://www.ieee.org/ + +Special thanks to Laura Hyslop and ken Rawson of IEEE for their help +in obtaining the information needed to compile this file. Also, +Volker Kuhlmann and Moritz Borgmann kindly provided some corrections +and additions. + +************************************************************************* +Legal Notice: +This code is offered as-is without any warranty either expressed or +implied; without even the implied warranty of MERCHANTABILITY or +FITNESS FOR A PARTICULAR PURPOSE! +User assumes all risk. +In no event shall IEEE or any contributor to this code be liable for +any damages or losses, including, but not limited to, incidental, +consequential, or any other damages, resulting from the use or misuse +of any information contained here. + +All comments are the opinions of their respective authors and are not +necessarily endorsed by the IEEE. + +This work is distributed under the LaTeX Project Public License (LPPL) +( http://www.latex-project.org/ ) version 1.3, and may be freely used, +distributed and modified. A copy of the LPPL, version 1.3, is included +in the base LaTeX documentation of all distributions of LaTeX released +2003/12/01 or later. +Retain all contribution notices and credits. +** Modified files should be clearly indicated as such, including ** +** renaming them and changing author support contact information. ** + +File list of work: IEEEabrv.bib, IEEEfull.bib, IEEEexample.bib, + IEEEtran.bst, IEEEtranS.bst, IEEEtranSA.bst, + IEEEtranN.bst, IEEEtranSN.bst, IEEEtran_bst_HOWTO.pdf +************************************************************************* + + +USAGE: + +\bibliographystyle{mybstfile} +\bibliography{IEEEfull,mybibfile} + +where the IEEE titles in the .bib database entries use the strings +defined here. e.g., + + + journal = IEEE_J_AC, + + +to yield "{IEEE} Transactions on Automatic Control" + + +WARNING: IEEE uses abbreviated journal titles in their bibliographies! +Because this file provides the full titles, you should NOT use this file +for work that is to be submitted to the IEEE. + +For IEEE work, you should use the abbreviated titles provided in the +companion file, IEEEabrv.bib. + + +** NOTES ** + + 1. Journals have been grouped according to subject in order to make it + easier to locate and extract the definitions for related journals - + as most works use references that are confined to a single topic. + Magazines are listed in straight alphabetical order. + + 2. String names are closely based on IEEE's own internal acronyms. + + 3. Older, out-of-print IEEE titles are included (but not including titles + dating prior to IEEE's formation from the IRE and AIEE in 1963). + + + + + + +IEEE Journals + + + +aerospace and military +@STRING{IEEE_J_AES = "{IEEE} Transactions on Aerospace and Electronic Systems"} +@STRING{IEEE_J_ANE = "{IEEE} Transactions on Aerospace and Navigational Electronics"} +@STRING{IEEE_J_ANNE = "{IEEE} Transactions on Aeronautical and Navigational Electronics"} +@STRING{IEEE_J_AS = "{IEEE} Transactions on Aerospace"} +@STRING{IEEE_J_AIRE = "{IEEE} Transactions on Airborne Electronics"} +@STRING{IEEE_J_MIL = "{IEEE} Transactions on Military Electronics"} + + + +autos, transportation and vehicles (non-aerospace) +@STRING{IEEE_J_ITS = "{IEEE} Transactions on Intelligent Transportation Systems"} +@STRING{IEEE_J_VT = "{IEEE} Transactions on Vehicular Technology"} +@STRING{IEEE_J_VC = "{IEEE} Transactions on Vehicular Communications"} + + + +circuits, signals, systems, audio and controls +@STRING{IEEE_J_SPL = "{IEEE} Signal Processing Letters"} +@STRING{IEEE_J_ASSP = "{IEEE} Transactions on Acoustics, Speech, and Signal Processing"} +@STRING{IEEE_J_AU = "{IEEE} Transactions on Audio"} +@STRING{IEEE_J_AUEA = "{IEEE} Transactions on Audio and Electroacoustics"} +@STRING{IEEE_J_AC = "{IEEE} Transactions on Automatic Control"} +@STRING{IEEE_J_CAS = "{IEEE} Transactions on Circuits and Systems"} +@STRING{IEEE_J_CASVT = "{IEEE} Transactions on Circuits and Systems for Video Technology"} +@STRING{IEEE_J_CASI = "{IEEE} Transactions on Circuits and Systems---Part {I}: Fundamental Theory and Applications"} +@STRING{IEEE_J_CASII = "{IEEE} Transactions on Circuits and Systems---Part {II}: Analog and Digital Signal Processing"} +in 2004 CASI and CASII renamed part title to CASI_RP and CASII_EB, respectively. +@STRING{IEEE_J_CASI_RP = "{IEEE} Transactions on Circuits and Systems---Part {I}: Regular Papers"} +@STRING{IEEE_J_CASII_EB = "{IEEE} Transactions on Circuits and Systems---Part {II}: Express Briefs"} +@STRING{IEEE_J_CT = "{IEEE} Transactions on Circuit Theory"} +@STRING{IEEE_J_CST = "{IEEE} Transactions on Control Systems Technology"} +@STRING{IEEE_J_SP = "{IEEE} Transactions on Signal Processing"} +@STRING{IEEE_J_SU = "{IEEE} Transactions on Sonics and Ultrasonics"} +@STRING{IEEE_J_SAP = "{IEEE} Transactions on Speech and Audio Processing"} +@STRING{IEEE_J_UE = "{IEEE} Transactions on Ultrasonics Engineering"} +@STRING{IEEE_J_UFFC = "{IEEE} Transactions on Ultrasonics, Ferroelectrics, and Frequency Control"} + + + +communications +@STRING{IEEE_J_COML = "{IEEE} Communications Letters"} +@STRING{IEEE_J_JSAC = "{IEEE} Journal on Selected Areas in Communications"} +@STRING{IEEE_J_COM = "{IEEE} Transactions on Communications"} +@STRING{IEEE_J_COMT = "{IEEE} Transactions on Communication Technology"} +@STRING{IEEE_J_WCOM = "{IEEE} Transactions on Wireless Communications"} + + + +components, packaging and manufacturing +@STRING{IEEE_J_ADVP = "{IEEE} Transactions on Advanced Packaging"} +@STRING{IEEE_J_CHMT = "{IEEE} Transactions on Components, Hybrids and Manufacturing Technology"} +@STRING{IEEE_J_CPMTA = "{IEEE} Transactions on Components, Packaging and Manufacturing Technology---Part {A}"} +@STRING{IEEE_J_CPMTB = "{IEEE} Transactions on Components, Packaging and Manufacturing Technology---Part {B}: Advanced Packaging"} +@STRING{IEEE_J_CPMTC = "{IEEE} Transactions on Components, Packaging and Manufacturing Technology---Part {C}: Manufacturing"} +@STRING{IEEE_J_CAPT = "{IEEE} Transactions on Components and Packaging Technology"} +@STRING{IEEE_J_CAPTS = "{IEEE} Transactions on Components and Packaging Technologies"} +@STRING{IEEE_J_CPART = "{IEEE} Transactions on Component Parts"} +@STRING{IEEE_J_EPM = "{IEEE} Transactions on Electronics Packaging Manufacturing"} +@STRING{IEEE_J_MFT = "{IEEE} Transactions on Manufacturing Technology"} +@STRING{IEEE_J_PHP = "{IEEE} Transactions on Parts, Hybrids and Packaging"} +@STRING{IEEE_J_PMP = "{IEEE} Transactions on Parts, Materials and Packaging"} + + + +CAD +@STRING{IEEE_J_TCAD = "{IEEE} Journal on Technology in Computer Aided Design"} +@STRING{IEEE_J_CAD = "{IEEE} Transactions on Computer-Aided Design of Integrated Circuits and Systems"} + + + +coding, data, information, knowledge +@STRING{IEEE_J_IT = "{IEEE} Transactions on Information Theory"} +@STRING{IEEE_J_KDE = "{IEEE} Transactions on Knowledge and Data Engineering"} + + + +computers, computation, networking and software +@STRING{IEEE_J_C = "{IEEE} Transactions on Computers"} +@STRING{IEEE_J_CAL = "{IEEE} Computer Architecture Letters"} +@STRING{IEEE_J_DSC = "{IEEE} Transactions on Dependable and Secure Computing"} +@STRING{IEEE_J_ECOMP = "{IEEE} Transactions on Electronic Computers"} +@STRING{IEEE_J_EVC = "{IEEE} Transactions on Evolutionary Computation"} +@STRING{IEEE_J_FUZZ = "{IEEE} Transactions on Fuzzy Systems"} +@STRING{IEEE_J_IFS = "{IEEE} Transactions on Information Forensics and Security"} +@STRING{IEEE_J_MC = "{IEEE} Transactions on Mobile Computing"} +@STRING{IEEE_J_NET = "{IEEE/ACM} Transactions on Networking"} +@STRING{IEEE_J_NN = "{IEEE} Transactions on Neural Networks"} +@STRING{IEEE_J_PDS = "{IEEE} Transactions on Parallel and Distributed Systems"} +@STRING{IEEE_J_SE = "{IEEE} Transactions on Software Engineering"} + + + +computer graphics, imaging, and multimedia +@STRING{IEEE_J_JDT = "{IEEE/OSA} Journal of Display Technology"} +@STRING{IEEE_J_IP = "{IEEE} Transactions on Image Processing"} +@STRING{IEEE_J_MM = "{IEEE} Transactions on Multimedia"} +@STRING{IEEE_J_VCG = "{IEEE} Transactions on Visualization and Computer Graphics"} + + + +cybernetics, ergonomics, robots, man-machine, and automation +@STRING{IEEE_J_ASE = "{IEEE} Transactions on Automation Science and Engineering"} +@STRING{IEEE_J_JRA = "{IEEE} Journal of Robotics and Automation"} +@STRING{IEEE_J_HFE = "{IEEE} Transactions on Human Factors in Electronics"} +@STRING{IEEE_J_MMS = "{IEEE} Transactions on Man-Machine Systems"} +@STRING{IEEE_J_PAMI = "{IEEE} Transactions on Pattern Analysis and Machine Intelligence"} +in 1989 JRA became RA +in August 2004, RA split into ASE and RO +@STRING{IEEE_J_RA = "{IEEE} Transactions on Robotics and Automation"} +@STRING{IEEE_J_RO = "{IEEE} Transactions on Robotics"} +@STRING{IEEE_J_SMC = "{IEEE} Transactions on Systems, Man, and Cybernetics"} +@STRING{IEEE_J_SMCA = "{IEEE} Transactions on Systems, Man, and Cybernetics---Part {A}: Systems and Humans"} +@STRING{IEEE_J_SMCB = "{IEEE} Transactions on Systems, Man, and Cybernetics---Part {B}: Cybernetics"} +@STRING{IEEE_J_SMCC = "{IEEE} Transactions on Systems, Man, and Cybernetics---Part {C}: Applications and Reviews"} +@STRING{IEEE_J_SSC = "{IEEE} Transactions on Systems Science and Cybernetics"} + + + +earth, wind, fire and water +@STRING{IEEE_J_GE = "{IEEE} Transactions on Geoscience Electronics"} +@STRING{IEEE_J_GRS = "{IEEE} Transactions on Geoscience and Remote Sensing"} +@STRING{IEEE_J_GRSL = "{IEEE} Geoscience and Remote Sensing Letters"} +@STRING{IEEE_J_OE = "{IEEE} Journal of Oceanic Engineering"} + + + +education, engineering, history, IEEE, professional +@STRING{IEEE_J_CJECE = "Canadian Journal of Electrical and Computer Engineering"} +@STRING{IEEE_J_PROC = "Proceedings of the {IEEE}"} +@STRING{IEEE_J_EDU = "{IEEE} Transactions on Education"} +@STRING{IEEE_J_EM = "{IEEE} Transactions on Engineering Management"} +@STRING{IEEE_J_EWS = "{IEEE} Transactions on Engineering Writing and Speech"} +@STRING{IEEE_J_PC = "{IEEE} Transactions on Professional Communication"} + + + +electromagnetics, antennas, EMI, magnetics and microwave +@STRING{IEEE_J_AWPL = "{IEEE} Antennas and Wireless Propagation Letters"} +@STRING{IEEE_J_MGWL = "{IEEE} Microwave and Guided Wave Letters"} +@STRING{IEEE_J_MWCL = "{IEEE} Microwave and Wireless Components Letters"} +@STRING{IEEE_J_AP = "{IEEE} Transactions on Antennas and Propagation"} +@STRING{IEEE_J_EMC = "{IEEE} Transactions on Electromagnetic Compatibility"} +@STRING{IEEE_J_MAG = "{IEEE} Transactions on Magnetics"} +@STRING{IEEE_J_MTT = "{IEEE} Transactions on Microwave Theory and Techniques"} +@STRING{IEEE_J_RFI = "{IEEE} Transactions on Radio Frequency Interference"} +@STRING{IEEE_J_TJMJ = "{IEEE} Translation Journal on Magnetics in Japan"} + + + +energy and power +@STRING{IEEE_J_EC = "{IEEE} Transactions on Energy Conversion"} +@STRING{IEEE_J_PEL = "{IEEE} Power Electronics Letters"} +@STRING{IEEE_J_PWRAS = "{IEEE} Transactions on Power Apparatus and Systems"} +@STRING{IEEE_J_PWRD = "{IEEE} Transactions on Power Delivery"} +@STRING{IEEE_J_PWRE = "{IEEE} Transactions on Power Electronics"} +@STRING{IEEE_J_PWRS = "{IEEE} Transactions on Power Systems"} + + + +industrial, commercial and consumer +@STRING{IEEE_J_APPIND = "{IEEE} Transactions on Applications and Industry"} +@STRING{IEEE_J_BC = "{IEEE} Transactions on Broadcasting"} +@STRING{IEEE_J_BCTV = "{IEEE} Transactions on Broadcast and Television Receivers"} +@STRING{IEEE_J_CE = "{IEEE} Transactions on Consumer Electronics"} +@STRING{IEEE_J_IE = "{IEEE} Transactions on Industrial Electronics"} +@STRING{IEEE_J_IECI = "{IEEE} Transactions on Industrial Electronics and Control Instrumentation"} +@STRING{IEEE_J_IA = "{IEEE} Transactions on Industry Applications"} +@STRING{IEEE_J_IGA = "{IEEE} Transactions on Industry and General Applications"} +@STRING{IEEE_J_IINF = "{IEEE} Transactions on Industrial Informatics"} +@STRING{IEEE_J_PSE = "{IEEE} Journal of Product Safety Engineering"} + + + +instrumentation and measurement +@STRING{IEEE_J_IM = "{IEEE} Transactions on Instrumentation and Measurement"} + + + +insulation and materials +@STRING{IEEE_J_JEM = "{IEEE/TMS} Journal of Electronic Materials"} +@STRING{IEEE_J_DEI = "{IEEE} Transactions on Dielectrics and Electrical Insulation"} +@STRING{IEEE_J_EI = "{IEEE} Transactions on Electrical Insulation"} + + + +mechanical +@STRING{IEEE_J_MECH = "{IEEE/ASME} Transactions on Mechatronics"} +@STRING{IEEE_J_MEMS = "{IEEE/ASME} Journal of Microelectromechanical Systems"} + + + +medical and biological +@STRING{IEEE_J_BME = "{IEEE} Transactions on Biomedical Engineering"} +Note: The B-ME journal later dropped the hyphen and became the BME. +@STRING{IEEE_J_B-ME = "{IEEE} Transactions on Bio-Medical Engineering"} +@STRING{IEEE_J_BMELC = "{IEEE} Transactions on Bio-Medical Electronics"} +@STRING{IEEE_J_CBB = "{IEEE/ACM} Transactions on Computational Biology and Bioinformatics"} +@STRING{IEEE_J_ITBM = "{IEEE} Transactions on Information Technology in Biomedicine"} +@STRING{IEEE_J_ME = "{IEEE} Transactions on Medical Electronics"} +@STRING{IEEE_J_MI = "{IEEE} Transactions on Medical Imaging"} +@STRING{IEEE_J_NB = "{IEEE} Transactions on NanoBioscience"} +@STRING{IEEE_J_NSRE = "{IEEE} Transactions on Neural Systems and Rehabilitation Engineering"} +@STRING{IEEE_J_RE = "{IEEE} Transactions on Rehabilitation Engineering"} + + + +optics, lightwave and photonics +@STRING{IEEE_J_PTL = "{IEEE} Photonics Technology Letters"} +@STRING{IEEE_J_JLT = "{IEEE/OSA} Journal of Lightwave Technology"} + + + +physics, electrons, nanotechnology, nuclear and quantum electronics +@STRING{IEEE_J_EDL = "{IEEE} Electron Device Letters"} +@STRING{IEEE_J_JQE = "{IEEE} Journal of Quantum Electronics"} +@STRING{IEEE_J_JSTQE = "{IEEE} Journal of Selected Topics in Quantum Electronics"} +@STRING{IEEE_J_ED = "{IEEE} Transactions on Electron Devices"} +@STRING{IEEE_J_NANO = "{IEEE} Transactions on Nanotechnology"} +@STRING{IEEE_J_NS = "{IEEE} Transactions on Nuclear Science"} +@STRING{IEEE_J_PS = "{IEEE} Transactions on Plasma Science"} + + + +reliability +@STRING{IEEE_J_DMR = "{IEEE} Transactions on Device and Materials Reliability"} +@STRING{IEEE_J_R = "{IEEE} Transactions on Reliability"} + + + +semiconductors, superconductors, electrochemical and solid state +@STRING{IEEE_J_ESSL = "{IEEE/ECS} Electrochemical and Solid-State Letters"} +@STRING{IEEE_J_JSSC = "{IEEE} Journal of Solid-State Circuits"} +@STRING{IEEE_J_ASC = "{IEEE} Transactions on Applied Superconductivity"} +@STRING{IEEE_J_SM = "{IEEE} Transactions on Semiconductor Manufacturing"} + + + +sensors +@STRING{IEEE_J_SENSOR = "{IEEE} Sensors Journal"} + + + +VLSI +@STRING{IEEE_J_VLSI = "{IEEE} Transactions on Very Large Scale Integration ({VLSI}) Systems"} + + + + + + +IEEE Magazines + + + +@STRING{IEEE_M_AES = "{IEEE} Aerospace and Electronics Systems Magazine"} +@STRING{IEEE_M_HIST = "{IEEE} Annals of the History of Computing"} +@STRING{IEEE_M_AP = "{IEEE} Antennas and Propagation Magazine"} +@STRING{IEEE_M_ASSP = "{IEEE} {ASSP} Magazine"} +@STRING{IEEE_M_CD = "{IEEE} Circuits and Devices Magazine"} +@STRING{IEEE_M_CAS = "{IEEE} Circuits and Systems Magazine"} +@STRING{IEEE_M_COM = "{IEEE} Communications Magazine"} +@STRING{IEEE_M_COMSOC = "{IEEE} Communications Society Magazine"} +@STRING{IEEE_M_CIM = "{IEEE} Computational Intelligence Magazine"} +CSEM changed to CSE in 1999 +@STRING{IEEE_M_CSE = "{IEEE} Computing in Science and Engineering"} +@STRING{IEEE_M_CSEM = "{IEEE} Computational Science and Engineering Magazine"} +@STRING{IEEE_M_C = "{IEEE} Computer"} +@STRING{IEEE_M_CAP = "{IEEE} Computer Applications in Power"} +@STRING{IEEE_M_CGA = "{IEEE} Computer Graphics and Applications"} +@STRING{IEEE_M_CONC = "{IEEE} Concurrency"} +@STRING{IEEE_M_CS = "{IEEE} Control Systems Magazine"} +@STRING{IEEE_M_DTC = "{IEEE} Design and Test of Computers"} +@STRING{IEEE_M_EI = "{IEEE} Electrical Insulation Magazine"} +@STRING{IEEE_M_ETR = "{IEEE} ElectroTechnology Review"} +@STRING{IEEE_M_EMB = "{IEEE} Engineering in Medicine and Biology Magazine"} +@STRING{IEEE_M_EMR = "{IEEE} Engineering Management Review"} +@STRING{IEEE_M_EXP = "{IEEE} Expert"} +@STRING{IEEE_M_IA = "{IEEE} Industry Applications Magazine"} +@STRING{IEEE_M_IM = "{IEEE} Instrumentation and Measurement Magazine"} +@STRING{IEEE_M_IS = "{IEEE} Intelligent Systems"} +@STRING{IEEE_M_IC = "{IEEE} Internet Computing"} +@STRING{IEEE_M_ITP = "{IEEE} {IT} Professional"} +@STRING{IEEE_M_MICRO = "{IEEE} Micro"} +@STRING{IEEE_M_MW = "{IEEE} Microwave Magazine"} +@STRING{IEEE_M_MM = "{IEEE} Multimedia"} +@STRING{IEEE_M_NET = "{IEEE} Network"} +@STRING{IEEE_M_PCOM = "{IEEE} Personal Communications Magazine"} +@STRING{IEEE_M_POT = "{IEEE} Potentials"} +CAP and PER merged to form PE in 2003 +@STRING{IEEE_M_PE = "{IEEE} Power and Energy Magazine"} +@STRING{IEEE_M_PER = "{IEEE} Power Engineering Review"} +@STRING{IEEE_M_PVC = "{IEEE} Pervasive Computing"} +@STRING{IEEE_M_RA = "{IEEE} Robotics and Automation Magazine"} +@STRING{IEEE_M_SAP = "{IEEE} Security and Privacy"} +@STRING{IEEE_M_SP = "{IEEE} Signal Processing Magazine"} +@STRING{IEEE_M_S = "{IEEE} Software"} +@STRING{IEEE_M_SPECT = "{IEEE} Spectrum"} +@STRING{IEEE_M_TS = "{IEEE} Technology and Society Magazine"} +@STRING{IEEE_M_VT = "{IEEE} Vehicular Technology Magazine"} +@STRING{IEEE_M_WC = "{IEEE} Wireless Communications Magazine"} +@STRING{IEEE_M_TODAY = "Today's Engineer"} + + + + + + +IEEE Online Publications + + + +@STRING{IEEE_O_CSTO = "{IEEE} Communications Surveys and Tutorials"} +@STRING{IEEE_O_DSO = "{IEEE} Distributed Systems Online"} + + + + + +-- +EOF diff --git a/IEEEtran/IEEEtran.bst b/IEEEtran/IEEEtran.bst new file mode 100644 index 0000000..53fbc03 --- /dev/null +++ b/IEEEtran/IEEEtran.bst @@ -0,0 +1,2417 @@ +%% +%% IEEEtran.bst +%% BibTeX Bibliography Style file for IEEE Journals and Conferences (unsorted) +%% Version 1.12 (2007/01/11) +%% +%% Copyright (c) 2003-2007 Michael Shell +%% +%% Original starting code base and algorithms obtained from the output of +%% Patrick W. Daly's makebst package as well as from prior versions of +%% IEEE BibTeX styles: +%% +%% 1. Howard Trickey and Oren Patashnik's ieeetr.bst (1985/1988) +%% 2. Silvano Balemi and Richard H. Roy's IEEEbib.bst (1993) +%% +%% Support sites: +%% http://www.michaelshell.org/tex/ieeetran/ +%% http://www.ctan.org/tex-archive/macros/latex/contrib/IEEEtran/ +%% and/or +%% http://www.ieee.org/ +%% +%% For use with BibTeX version 0.99a or later +%% +%% This is a numerical citation style. +%% +%%************************************************************************* +%% Legal Notice: +%% This code is offered as-is without any warranty either expressed or +%% implied; without even the implied warranty of MERCHANTABILITY or +%% FITNESS FOR A PARTICULAR PURPOSE! +%% User assumes all risk. +%% In no event shall IEEE or any contributor to this code be liable for +%% any damages or losses, including, but not limited to, incidental, +%% consequential, or any other damages, resulting from the use or misuse +%% of any information contained here. +%% +%% All comments are the opinions of their respective authors and are not +%% necessarily endorsed by the IEEE. +%% +%% This work is distributed under the LaTeX Project Public License (LPPL) +%% ( http://www.latex-project.org/ ) version 1.3, and may be freely used, +%% distributed and modified. A copy of the LPPL, version 1.3, is included +%% in the base LaTeX documentation of all distributions of LaTeX released +%% 2003/12/01 or later. +%% Retain all contribution notices and credits. +%% ** Modified files should be clearly indicated as such, including ** +%% ** renaming them and changing author support contact information. ** +%% +%% File list of work: IEEEabrv.bib, IEEEfull.bib, IEEEexample.bib, +%% IEEEtran.bst, IEEEtranS.bst, IEEEtranSA.bst, +%% IEEEtranN.bst, IEEEtranSN.bst, IEEEtran_bst_HOWTO.pdf +%%************************************************************************* +% +% +% Changelog: +% +% 1.00 (2002/08/13) Initial release +% +% 1.10 (2002/09/27) +% 1. Corrected minor bug for improperly formed warning message when a +% book was not given a title. Thanks to Ming Kin Lai for reporting this. +% 2. Added support for CTLname_format_string and CTLname_latex_cmd fields +% in the BST control entry type. +% +% 1.11 (2003/04/02) +% 1. Fixed bug with URLs containing underscores when using url.sty. Thanks +% to Ming Kin Lai for reporting this. +% +% 1.12 (2007/01/11) +% 1. Fixed bug with unwanted comma before "et al." when an entry contained +% more than two author names. Thanks to Pallav Gupta for reporting this. +% 2. Fixed bug with anomalous closing quote in tech reports that have a +% type, but without a number or address. Thanks to Mehrdad Mirreza for +% reporting this. +% 3. Use braces in \providecommand in begin.bib to better support +% latex2html. TeX style length assignments OK with recent versions +% of latex2html - 1.71 (2002/2/1) or later is strongly recommended. +% Use of the language field still causes trouble with latex2html. +% Thanks to Federico Beffa for reporting this. +% 4. Added IEEEtran.bst ID and version comment string to .bbl output. +% 5. Provide a \BIBdecl hook that allows the user to execute commands +% just prior to the first entry. +% 6. Use default urlstyle (is using url.sty) of "same" rather than rm to +% better work with a wider variety of bibliography styles. +% 7. Changed month abbreviations from Sept., July and June to Sep., Jul., +% and Jun., respectively, as IEEE now does. Thanks to Moritz Borgmann +% for reporting this. +% 8. Control entry types should not be considered when calculating longest +% label width. +% 9. Added alias www for electronic/online. +% 10. Added CTLname_url_prefix control entry type. + + +%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% +%% DEFAULTS FOR THE CONTROLS OF THE BST STYLE %% +%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% + +% These are the defaults for the user adjustable controls. The values used +% here can be overridden by the user via IEEEtranBSTCTL entry type. + +% NOTE: The recommended LaTeX command to invoke a control entry type is: +% +%\makeatletter +%\def\bstctlcite{\@ifnextchar[{\@bstctlcite}{\@bstctlcite[@auxout]}} +%\def\@bstctlcite[#1]#2{\@bsphack +% \@for\@citeb:=#2\do{% +% \edef\@citeb{\expandafter\@firstofone\@citeb}% +% \if@filesw\immediate\write\csname #1\endcsname{\string\citation{\@citeb}}\fi}% +% \@esphack} +%\makeatother +% +% It is called at the start of the document, before the first \cite, like: +% \bstctlcite{IEEEexample:BSTcontrol} +% +% IEEEtran.cls V1.6 and later does provide this command. + + + +% #0 turns off the display of the number for articles. +% #1 enables +FUNCTION {default.is.use.number.for.article} { #1 } + + +% #0 turns off the display of the paper and type fields in @inproceedings. +% #1 enables +FUNCTION {default.is.use.paper} { #1 } + + +% #0 turns off the forced use of "et al." +% #1 enables +FUNCTION {default.is.forced.et.al} { #0 } + +% The maximum number of names that can be present beyond which an "et al." +% usage is forced. Be sure that num.names.shown.with.forced.et.al (below) +% is not greater than this value! +% Note: There are many instances of references in IEEE journals which have +% a very large number of authors as well as instances in which "et al." is +% used profusely. +FUNCTION {default.max.num.names.before.forced.et.al} { #10 } + +% The number of names that will be shown with a forced "et al.". +% Must be less than or equal to max.num.names.before.forced.et.al +FUNCTION {default.num.names.shown.with.forced.et.al} { #1 } + + +% #0 turns off the alternate interword spacing for entries with URLs. +% #1 enables +FUNCTION {default.is.use.alt.interword.spacing} { #1 } + +% If alternate interword spacing for entries with URLs is enabled, this is +% the interword spacing stretch factor that will be used. For example, the +% default "4" here means that the interword spacing in entries with URLs can +% stretch to four times normal. Does not have to be an integer. Note that +% the value specified here can be overridden by the user in their LaTeX +% code via a command such as: +% "\providecommand\BIBentryALTinterwordstretchfactor{1.5}" in addition to +% that via the IEEEtranBSTCTL entry type. +FUNCTION {default.ALTinterwordstretchfactor} { "4" } + + +% #0 turns off the "dashification" of repeated (i.e., identical to those +% of the previous entry) names. IEEE normally does this. +% #1 enables +FUNCTION {default.is.dash.repeated.names} { #1 } + + +% The default name format control string. +FUNCTION {default.name.format.string}{ "{f.~}{vv~}{ll}{, jj}" } + + +% The default LaTeX font command for the names. +FUNCTION {default.name.latex.cmd}{ "" } + + +% The default URL prefix. +FUNCTION {default.name.url.prefix}{ "[Online]. Available:" } + + +% Other controls that cannot be accessed via IEEEtranBSTCTL entry type. + +% #0 turns off the terminal startup banner/completed message so as to +% operate more quietly. +% #1 enables +FUNCTION {is.print.banners.to.terminal} { #1 } + + + + +%%%%%%%%%%%%%%%%%%%%%%%%%%%%% +%% FILE VERSION AND BANNER %% +%%%%%%%%%%%%%%%%%%%%%%%%%%%%% + +FUNCTION{bst.file.version} { "1.12" } +FUNCTION{bst.file.date} { "2007/01/11" } +FUNCTION{bst.file.website} { "http://www.michaelshell.org/tex/ieeetran/bibtex/" } + +FUNCTION {banner.message} +{ is.print.banners.to.terminal + { "-- IEEEtran.bst version" " " * bst.file.version * + " (" * bst.file.date * ") " * "by Michael Shell." * + top$ + "-- " bst.file.website * + top$ + "-- See the " quote$ * "IEEEtran_bst_HOWTO.pdf" * quote$ * " manual for usage information." * + top$ + } + { skip$ } + if$ +} + +FUNCTION {completed.message} +{ is.print.banners.to.terminal + { "" + top$ + "Done." + top$ + } + { skip$ } + if$ +} + + + + +%%%%%%%%%%%%%%%%%%%%%% +%% STRING CONSTANTS %% +%%%%%%%%%%%%%%%%%%%%%% + +FUNCTION {bbl.and}{ "and" } +FUNCTION {bbl.etal}{ "et~al." } +FUNCTION {bbl.editors}{ "eds." } +FUNCTION {bbl.editor}{ "ed." } +FUNCTION {bbl.edition}{ "ed." } +FUNCTION {bbl.volume}{ "vol." } +FUNCTION {bbl.of}{ "of" } +FUNCTION {bbl.number}{ "no." } +FUNCTION {bbl.in}{ "in" } +FUNCTION {bbl.pages}{ "pp." } +FUNCTION {bbl.page}{ "p." } +FUNCTION {bbl.chapter}{ "ch." } +FUNCTION {bbl.paper}{ "paper" } +FUNCTION {bbl.part}{ "pt." } +FUNCTION {bbl.patent}{ "Patent" } +FUNCTION {bbl.patentUS}{ "U.S." } +FUNCTION {bbl.revision}{ "Rev." } +FUNCTION {bbl.series}{ "ser." } +FUNCTION {bbl.standard}{ "Std." } +FUNCTION {bbl.techrep}{ "Tech. Rep." } +FUNCTION {bbl.mthesis}{ "Master's thesis" } +FUNCTION {bbl.phdthesis}{ "Ph.D. dissertation" } +FUNCTION {bbl.st}{ "st" } +FUNCTION {bbl.nd}{ "nd" } +FUNCTION {bbl.rd}{ "rd" } +FUNCTION {bbl.th}{ "th" } + + +% This is the LaTeX spacer that is used when a larger than normal space +% is called for (such as just before the address:publisher). +FUNCTION {large.space} { "\hskip 1em plus 0.5em minus 0.4em\relax " } + +% The LaTeX code for dashes that are used to represent repeated names. +% Note: Some older IEEE journals used something like +% "\rule{0.275in}{0.5pt}\," which is fairly thick and runs right along +% the baseline. However, IEEE now uses a thinner, above baseline, +% six dash long sequence. +FUNCTION {repeated.name.dashes} { "------" } + + + +%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% +%% PREDEFINED STRING MACROS %% +%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% + +MACRO {jan} {"Jan."} +MACRO {feb} {"Feb."} +MACRO {mar} {"Mar."} +MACRO {apr} {"Apr."} +MACRO {may} {"May"} +MACRO {jun} {"Jun."} +MACRO {jul} {"Jul."} +MACRO {aug} {"Aug."} +MACRO {sep} {"Sep."} +MACRO {oct} {"Oct."} +MACRO {nov} {"Nov."} +MACRO {dec} {"Dec."} + + + +%%%%%%%%%%%%%%%%%% +%% ENTRY FIELDS %% +%%%%%%%%%%%%%%%%%% + +ENTRY + { address + assignee + author + booktitle + chapter + day + dayfiled + edition + editor + howpublished + institution + intype + journal + key + language + month + monthfiled + nationality + note + number + organization + pages + paper + publisher + school + series + revision + title + type + url + volume + year + yearfiled + CTLuse_article_number + CTLuse_paper + CTLuse_forced_etal + CTLmax_names_forced_etal + CTLnames_show_etal + CTLuse_alt_spacing + CTLalt_stretch_factor + CTLdash_repeated_names + CTLname_format_string + CTLname_latex_cmd + CTLname_url_prefix + } + {} + { label } + + + + +%%%%%%%%%%%%%%%%%%%%%%% +%% INTEGER VARIABLES %% +%%%%%%%%%%%%%%%%%%%%%%% + +INTEGERS { prev.status.punct this.status.punct punct.std + punct.no punct.comma punct.period + prev.status.space this.status.space space.std + space.no space.normal space.large + prev.status.quote this.status.quote quote.std + quote.no quote.close + prev.status.nline this.status.nline nline.std + nline.no nline.newblock + status.cap cap.std + cap.no cap.yes} + +INTEGERS { longest.label.width multiresult nameptr namesleft number.label numnames } + +INTEGERS { is.use.number.for.article + is.use.paper + is.forced.et.al + max.num.names.before.forced.et.al + num.names.shown.with.forced.et.al + is.use.alt.interword.spacing + is.dash.repeated.names} + + +%%%%%%%%%%%%%%%%%%%%%% +%% STRING VARIABLES %% +%%%%%%%%%%%%%%%%%%%%%% + +STRINGS { bibinfo + longest.label + oldname + s + t + ALTinterwordstretchfactor + name.format.string + name.latex.cmd + name.url.prefix} + + + + +%%%%%%%%%%%%%%%%%%%%%%%%% +%% LOW LEVEL FUNCTIONS %% +%%%%%%%%%%%%%%%%%%%%%%%%% + +FUNCTION {initialize.controls} +{ default.is.use.number.for.article 'is.use.number.for.article := + default.is.use.paper 'is.use.paper := + default.is.forced.et.al 'is.forced.et.al := + default.max.num.names.before.forced.et.al 'max.num.names.before.forced.et.al := + default.num.names.shown.with.forced.et.al 'num.names.shown.with.forced.et.al := + default.is.use.alt.interword.spacing 'is.use.alt.interword.spacing := + default.is.dash.repeated.names 'is.dash.repeated.names := + default.ALTinterwordstretchfactor 'ALTinterwordstretchfactor := + default.name.format.string 'name.format.string := + default.name.latex.cmd 'name.latex.cmd := + default.name.url.prefix 'name.url.prefix := +} + + +% This IEEEtran.bst features a very powerful and flexible mechanism for +% controlling the capitalization, punctuation, spacing, quotation, and +% newlines of the formatted entry fields. (Note: IEEEtran.bst does not need +% or use the newline/newblock feature, but it has been implemented for +% possible future use.) The output states of IEEEtran.bst consist of +% multiple independent attributes and, as such, can be thought of as being +% vectors, rather than the simple scalar values ("before.all", +% "mid.sentence", etc.) used in most other .bst files. +% +% The more flexible and complex design used here was motivated in part by +% IEEE's rather unusual bibliography style. For example, IEEE ends the +% previous field item with a period and large space prior to the publisher +% address; the @electronic entry types use periods as inter-item punctuation +% rather than the commas used by the other entry types; and URLs are never +% followed by periods even though they are the last item in the entry. +% Although it is possible to accommodate these features with the conventional +% output state system, the seemingly endless exceptions make for convoluted, +% unreliable and difficult to maintain code. +% +% IEEEtran.bst's output state system can be easily understood via a simple +% illustration of two most recently formatted entry fields (on the stack): +% +% CURRENT_ITEM +% "PREVIOUS_ITEM +% +% which, in this example, is to eventually appear in the bibliography as: +% +% "PREVIOUS_ITEM," CURRENT_ITEM +% +% It is the job of the output routine to take the previous item off of the +% stack (while leaving the current item at the top of the stack), apply its +% trailing punctuation (including closing quote marks) and spacing, and then +% to write the result to BibTeX's output buffer: +% +% "PREVIOUS_ITEM," +% +% Punctuation (and spacing) between items is often determined by both of the +% items rather than just the first one. The presence of quotation marks +% further complicates the situation because, in standard English, trailing +% punctuation marks are supposed to be contained within the quotes. +% +% IEEEtran.bst maintains two output state (aka "status") vectors which +% correspond to the previous and current (aka "this") items. Each vector +% consists of several independent attributes which track punctuation, +% spacing, quotation, and newlines. Capitalization status is handled by a +% separate scalar because the format routines, not the output routine, +% handle capitalization and, therefore, there is no need to maintain the +% capitalization attribute for both the "previous" and "this" items. +% +% When a format routine adds a new item, it copies the current output status +% vector to the previous output status vector and (usually) resets the +% current (this) output status vector to a "standard status" vector. Using a +% "standard status" vector in this way allows us to redefine what we mean by +% "standard status" at the start of each entry handler and reuse the same +% format routines under the various inter-item separation schemes. For +% example, the standard status vector for the @book entry type may use +% commas for item separators, while the @electronic type may use periods, +% yet both entry handlers exploit many of the exact same format routines. +% +% Because format routines have write access to the output status vector of +% the previous item, they can override the punctuation choices of the +% previous format routine! Therefore, it becomes trivial to implement rules +% such as "Always use a period and a large space before the publisher." By +% pushing the generation of the closing quote mark to the output routine, we +% avoid all the problems caused by having to close a quote before having all +% the information required to determine what the punctuation should be. +% +% The IEEEtran.bst output state system can easily be expanded if needed. +% For instance, it is easy to add a "space.tie" attribute value if the +% bibliography rules mandate that two items have to be joined with an +% unbreakable space. + +FUNCTION {initialize.status.constants} +{ #0 'punct.no := + #1 'punct.comma := + #2 'punct.period := + #0 'space.no := + #1 'space.normal := + #2 'space.large := + #0 'quote.no := + #1 'quote.close := + #0 'cap.no := + #1 'cap.yes := + #0 'nline.no := + #1 'nline.newblock := +} + +FUNCTION {std.status.using.comma} +{ punct.comma 'punct.std := + space.normal 'space.std := + quote.no 'quote.std := + nline.no 'nline.std := + cap.no 'cap.std := +} + +FUNCTION {std.status.using.period} +{ punct.period 'punct.std := + space.normal 'space.std := + quote.no 'quote.std := + nline.no 'nline.std := + cap.yes 'cap.std := +} + +FUNCTION {initialize.prev.this.status} +{ punct.no 'prev.status.punct := + space.no 'prev.status.space := + quote.no 'prev.status.quote := + nline.no 'prev.status.nline := + punct.no 'this.status.punct := + space.no 'this.status.space := + quote.no 'this.status.quote := + nline.no 'this.status.nline := + cap.yes 'status.cap := +} + +FUNCTION {this.status.std} +{ punct.std 'this.status.punct := + space.std 'this.status.space := + quote.std 'this.status.quote := + nline.std 'this.status.nline := +} + +FUNCTION {cap.status.std}{ cap.std 'status.cap := } + +FUNCTION {this.to.prev.status} +{ this.status.punct 'prev.status.punct := + this.status.space 'prev.status.space := + this.status.quote 'prev.status.quote := + this.status.nline 'prev.status.nline := +} + + +FUNCTION {not} +{ { #0 } + { #1 } + if$ +} + +FUNCTION {and} +{ { skip$ } + { pop$ #0 } + if$ +} + +FUNCTION {or} +{ { pop$ #1 } + { skip$ } + if$ +} + + +% convert the strings "yes" or "no" to #1 or #0 respectively +FUNCTION {yes.no.to.int} +{ "l" change.case$ duplicate$ + "yes" = + { pop$ #1 } + { duplicate$ "no" = + { pop$ #0 } + { "unknown boolean " quote$ * swap$ * quote$ * + " in " * cite$ * warning$ + #0 + } + if$ + } + if$ +} + + +% pushes true if the single char string on the stack is in the +% range of "0" to "9" +FUNCTION {is.num} +{ chr.to.int$ + duplicate$ "0" chr.to.int$ < not + swap$ "9" chr.to.int$ > not and +} + +% multiplies the integer on the stack by a factor of 10 +FUNCTION {bump.int.mag} +{ #0 'multiresult := + { duplicate$ #0 > } + { #1 - + multiresult #10 + + 'multiresult := + } + while$ +pop$ +multiresult +} + +% converts a single character string on the stack to an integer +FUNCTION {char.to.integer} +{ duplicate$ + is.num + { chr.to.int$ "0" chr.to.int$ - } + {"noninteger character " quote$ * swap$ * quote$ * + " in integer field of " * cite$ * warning$ + #0 + } + if$ +} + +% converts a string on the stack to an integer +FUNCTION {string.to.integer} +{ duplicate$ text.length$ 'namesleft := + #1 'nameptr := + #0 'numnames := + { nameptr namesleft > not } + { duplicate$ nameptr #1 substring$ + char.to.integer numnames bump.int.mag + + 'numnames := + nameptr #1 + + 'nameptr := + } + while$ +pop$ +numnames +} + + + + +% The output routines write out the *next* to the top (previous) item on the +% stack, adding punctuation and such as needed. Since IEEEtran.bst maintains +% the output status for the top two items on the stack, these output +% routines have to consider the previous output status (which corresponds to +% the item that is being output). Full independent control of punctuation, +% closing quote marks, spacing, and newblock is provided. +% +% "output.nonnull" does not check for the presence of a previous empty +% item. +% +% "output" does check for the presence of a previous empty item and will +% remove an empty item rather than outputing it. +% +% "output.warn" is like "output", but will issue a warning if it detects +% an empty item. + +FUNCTION {output.nonnull} +{ swap$ + prev.status.punct punct.comma = + { "," * } + { skip$ } + if$ + prev.status.punct punct.period = + { add.period$ } + { skip$ } + if$ + prev.status.quote quote.close = + { "''" * } + { skip$ } + if$ + prev.status.space space.normal = + { " " * } + { skip$ } + if$ + prev.status.space space.large = + { large.space * } + { skip$ } + if$ + write$ + prev.status.nline nline.newblock = + { newline$ "\newblock " write$ } + { skip$ } + if$ +} + +FUNCTION {output} +{ duplicate$ empty$ + 'pop$ + 'output.nonnull + if$ +} + +FUNCTION {output.warn} +{ 't := + duplicate$ empty$ + { pop$ "empty " t * " in " * cite$ * warning$ } + 'output.nonnull + if$ +} + +% "fin.entry" is the output routine that handles the last item of the entry +% (which will be on the top of the stack when "fin.entry" is called). + +FUNCTION {fin.entry} +{ this.status.punct punct.no = + { skip$ } + { add.period$ } + if$ + this.status.quote quote.close = + { "''" * } + { skip$ } + if$ +write$ +newline$ +} + + +FUNCTION {is.last.char.not.punct} +{ duplicate$ + "}" * add.period$ + #-1 #1 substring$ "." = +} + +FUNCTION {is.multiple.pages} +{ 't := + #0 'multiresult := + { multiresult not + t empty$ not + and + } + { t #1 #1 substring$ + duplicate$ "-" = + swap$ duplicate$ "," = + swap$ "+" = + or or + { #1 'multiresult := } + { t #2 global.max$ substring$ 't := } + if$ + } + while$ + multiresult +} + +FUNCTION {capitalize}{ "u" change.case$ "t" change.case$ } + +FUNCTION {emphasize} +{ duplicate$ empty$ + { pop$ "" } + { "\emph{" swap$ * "}" * } + if$ +} + +FUNCTION {do.name.latex.cmd} +{ name.latex.cmd + empty$ + { skip$ } + { name.latex.cmd "{" * swap$ * "}" * } + if$ +} + +% IEEEtran.bst uses its own \BIBforeignlanguage command which directly +% invokes the TeX hyphenation patterns without the need of the Babel +% package. Babel does a lot more than switch hyphenation patterns and +% its loading can cause unintended effects in many class files (such as +% IEEEtran.cls). +FUNCTION {select.language} +{ duplicate$ empty$ 'pop$ + { language empty$ 'skip$ + { "\BIBforeignlanguage{" language * "}{" * swap$ * "}" * } + if$ + } + if$ +} + +FUNCTION {tie.or.space.prefix} +{ duplicate$ text.length$ #3 < + { "~" } + { " " } + if$ + swap$ +} + +FUNCTION {get.bbl.editor} +{ editor num.names$ #1 > 'bbl.editors 'bbl.editor if$ } + +FUNCTION {space.word}{ " " swap$ * " " * } + + +% Field Conditioners, Converters, Checkers and External Interfaces + +FUNCTION {empty.field.to.null.string} +{ duplicate$ empty$ + { pop$ "" } + { skip$ } + if$ +} + +FUNCTION {either.or.check} +{ empty$ + { pop$ } + { "can't use both " swap$ * " fields in " * cite$ * warning$ } + if$ +} + +FUNCTION {empty.entry.warn} +{ author empty$ title empty$ howpublished empty$ + month empty$ year empty$ note empty$ url empty$ + and and and and and and + { "all relevant fields are empty in " cite$ * warning$ } + 'skip$ + if$ +} + + +% The bibinfo system provides a way for the electronic parsing/acquisition +% of a bibliography's contents as is done by ReVTeX. For example, a field +% could be entered into the bibliography as: +% \bibinfo{volume}{2} +% Only the "2" would show up in the document, but the LaTeX \bibinfo command +% could do additional things with the information. IEEEtran.bst does provide +% a \bibinfo command via "\providecommand{\bibinfo}[2]{#2}". However, it is +% currently not used as the bogus bibinfo functions defined here output the +% entry values directly without the \bibinfo wrapper. The bibinfo functions +% themselves (and the calls to them) are retained for possible future use. +% +% bibinfo.check avoids acting on missing fields while bibinfo.warn will +% issue a warning message if a missing field is detected. Prior to calling +% the bibinfo functions, the user should push the field value and then its +% name string, in that order. + +FUNCTION {bibinfo.check} +{ swap$ duplicate$ missing$ + { pop$ pop$ "" } + { duplicate$ empty$ + { swap$ pop$ } + { swap$ pop$ } + if$ + } + if$ +} + +FUNCTION {bibinfo.warn} +{ swap$ duplicate$ missing$ + { swap$ "missing " swap$ * " in " * cite$ * warning$ pop$ "" } + { duplicate$ empty$ + { swap$ "empty " swap$ * " in " * cite$ * warning$ } + { swap$ pop$ } + if$ + } + if$ +} + + +% IEEE separates large numbers with more than 4 digits into groups of +% three. IEEE uses a small space to separate these number groups. +% Typical applications include patent and page numbers. + +% number of consecutive digits required to trigger the group separation. +FUNCTION {large.number.trigger}{ #5 } + +% For numbers longer than the trigger, this is the blocksize of the groups. +% The blocksize must be less than the trigger threshold, and 2 * blocksize +% must be greater than the trigger threshold (can't do more than one +% separation on the initial trigger). +FUNCTION {large.number.blocksize}{ #3 } + +% What is actually inserted between the number groups. +FUNCTION {large.number.separator}{ "\," } + +% So as to save on integer variables by reusing existing ones, numnames +% holds the current number of consecutive digits read and nameptr holds +% the number that will trigger an inserted space. +FUNCTION {large.number.separate} +{ 't := + "" + #0 'numnames := + large.number.trigger 'nameptr := + { t empty$ not } + { t #-1 #1 substring$ is.num + { numnames #1 + 'numnames := } + { #0 'numnames := + large.number.trigger 'nameptr := + } + if$ + t #-1 #1 substring$ swap$ * + t #-2 global.max$ substring$ 't := + numnames nameptr = + { duplicate$ #1 nameptr large.number.blocksize - substring$ swap$ + nameptr large.number.blocksize - #1 + global.max$ substring$ + large.number.separator swap$ * * + nameptr large.number.blocksize - 'numnames := + large.number.blocksize #1 + 'nameptr := + } + { skip$ } + if$ + } + while$ +} + +% Converts all single dashes "-" to double dashes "--". +FUNCTION {n.dashify} +{ large.number.separate + 't := + "" + { t empty$ not } + { t #1 #1 substring$ "-" = + { t #1 #2 substring$ "--" = not + { "--" * + t #2 global.max$ substring$ 't := + } + { { t #1 #1 substring$ "-" = } + { "-" * + t #2 global.max$ substring$ 't := + } + while$ + } + if$ + } + { t #1 #1 substring$ * + t #2 global.max$ substring$ 't := + } + if$ + } + while$ +} + + +% This function detects entries with names that are identical to that of +% the previous entry and replaces the repeated names with dashes (if the +% "is.dash.repeated.names" user control is nonzero). +FUNCTION {name.or.dash} +{ 's := + oldname empty$ + { s 'oldname := s } + { s oldname = + { is.dash.repeated.names + { repeated.name.dashes } + { s 'oldname := s } + if$ + } + { s 'oldname := s } + if$ + } + if$ +} + +% Converts the number string on the top of the stack to +% "numerical ordinal form" (e.g., "7" to "7th"). There is +% no artificial limit to the upper bound of the numbers as the +% least significant digit always determines the ordinal form. +FUNCTION {num.to.ordinal} +{ duplicate$ #-1 #1 substring$ "1" = + { bbl.st * } + { duplicate$ #-1 #1 substring$ "2" = + { bbl.nd * } + { duplicate$ #-1 #1 substring$ "3" = + { bbl.rd * } + { bbl.th * } + if$ + } + if$ + } + if$ +} + +% If the string on the top of the stack begins with a number, +% (e.g., 11th) then replace the string with the leading number +% it contains. Otherwise retain the string as-is. s holds the +% extracted number, t holds the part of the string that remains +% to be scanned. +FUNCTION {extract.num} +{ duplicate$ 't := + "" 's := + { t empty$ not } + { t #1 #1 substring$ + t #2 global.max$ substring$ 't := + duplicate$ is.num + { s swap$ * 's := } + { pop$ "" 't := } + if$ + } + while$ + s empty$ + 'skip$ + { pop$ s } + if$ +} + +% Converts the word number string on the top of the stack to +% Arabic string form. Will be successful up to "tenth". +FUNCTION {word.to.num} +{ duplicate$ "l" change.case$ 's := + s "first" = + { pop$ "1" } + { skip$ } + if$ + s "second" = + { pop$ "2" } + { skip$ } + if$ + s "third" = + { pop$ "3" } + { skip$ } + if$ + s "fourth" = + { pop$ "4" } + { skip$ } + if$ + s "fifth" = + { pop$ "5" } + { skip$ } + if$ + s "sixth" = + { pop$ "6" } + { skip$ } + if$ + s "seventh" = + { pop$ "7" } + { skip$ } + if$ + s "eighth" = + { pop$ "8" } + { skip$ } + if$ + s "ninth" = + { pop$ "9" } + { skip$ } + if$ + s "tenth" = + { pop$ "10" } + { skip$ } + if$ +} + + +% Converts the string on the top of the stack to numerical +% ordinal (e.g., "11th") form. +FUNCTION {convert.edition} +{ duplicate$ empty$ 'skip$ + { duplicate$ #1 #1 substring$ is.num + { extract.num + num.to.ordinal + } + { word.to.num + duplicate$ #1 #1 substring$ is.num + { num.to.ordinal } + { "edition ordinal word " quote$ * edition * quote$ * + " may be too high (or improper) for conversion" * " in " * cite$ * warning$ + } + if$ + } + if$ + } + if$ +} + + + + +%%%%%%%%%%%%%%%%%%%%%%%%%%%%% +%% LATEX BIBLIOGRAPHY CODE %% +%%%%%%%%%%%%%%%%%%%%%%%%%%%%% + +FUNCTION {start.entry} +{ newline$ + "\bibitem{" write$ + cite$ write$ + "}" write$ + newline$ + "" + initialize.prev.this.status +} + +% Here we write out all the LaTeX code that we will need. The most involved +% code sequences are those that control the alternate interword spacing and +% foreign language hyphenation patterns. The heavy use of \providecommand +% gives users a way to override the defaults. Special thanks to Javier Bezos, +% Johannes Braams, Robin Fairbairns, Heiko Oberdiek, Donald Arseneau and all +% the other gurus on comp.text.tex for their help and advice on the topic of +% \selectlanguage, Babel and BibTeX. +FUNCTION {begin.bib} +{ "% Generated by IEEEtran.bst, version: " bst.file.version * " (" * bst.file.date * ")" * + write$ newline$ + preamble$ empty$ 'skip$ + { preamble$ write$ newline$ } + if$ + "\begin{thebibliography}{" longest.label * "}" * + write$ newline$ + "\providecommand{\url}[1]{#1}" + write$ newline$ + "\csname url@samestyle\endcsname" + write$ newline$ + "\providecommand{\newblock}{\relax}" + write$ newline$ + "\providecommand{\bibinfo}[2]{#2}" + write$ newline$ + "\providecommand{\BIBentrySTDinterwordspacing}{\spaceskip=0pt\relax}" + write$ newline$ + "\providecommand{\BIBentryALTinterwordstretchfactor}{" + ALTinterwordstretchfactor * "}" * + write$ newline$ + "\providecommand{\BIBentryALTinterwordspacing}{\spaceskip=\fontdimen2\font plus " + write$ newline$ + "\BIBentryALTinterwordstretchfactor\fontdimen3\font minus \fontdimen4\font\relax}" + write$ newline$ + "\providecommand{\BIBforeignlanguage}[2]{{%" + write$ newline$ + "\expandafter\ifx\csname l@#1\endcsname\relax" + write$ newline$ + "\typeout{** WARNING: IEEEtran.bst: No hyphenation pattern has been}%" + write$ newline$ + "\typeout{** loaded for the language `#1'. Using the pattern for}%" + write$ newline$ + "\typeout{** the default language instead.}%" + write$ newline$ + "\else" + write$ newline$ + "\language=\csname l@#1\endcsname" + write$ newline$ + "\fi" + write$ newline$ + "#2}}" + write$ newline$ + "\providecommand{\BIBdecl}{\relax}" + write$ newline$ + "\BIBdecl" + write$ newline$ +} + +FUNCTION {end.bib} +{ newline$ "\end{thebibliography}" write$ newline$ } + +FUNCTION {if.url.alt.interword.spacing} +{ is.use.alt.interword.spacing + {url empty$ 'skip$ {"\BIBentryALTinterwordspacing" write$ newline$} if$} + { skip$ } + if$ +} + +FUNCTION {if.url.std.interword.spacing} +{ is.use.alt.interword.spacing + {url empty$ 'skip$ {"\BIBentrySTDinterwordspacing" write$ newline$} if$} + { skip$ } + if$ +} + + + + +%%%%%%%%%%%%%%%%%%%%%%%% +%% LONGEST LABEL PASS %% +%%%%%%%%%%%%%%%%%%%%%%%% + +FUNCTION {initialize.longest.label} +{ "" 'longest.label := + #1 'number.label := + #0 'longest.label.width := +} + +FUNCTION {longest.label.pass} +{ type$ "ieeetranbstctl" = + { skip$ } + { number.label int.to.str$ 'label := + number.label #1 + 'number.label := + label width$ longest.label.width > + { label 'longest.label := + label width$ 'longest.label.width := + } + { skip$ } + if$ + } + if$ +} + + + + +%%%%%%%%%%%%%%%%%%%%% +%% FORMAT HANDLERS %% +%%%%%%%%%%%%%%%%%%%%% + +%% Lower Level Formats (used by higher level formats) + +FUNCTION {format.address.org.or.pub.date} +{ 't := + "" + year empty$ + { "empty year in " cite$ * warning$ } + { skip$ } + if$ + address empty$ t empty$ and + year empty$ and month empty$ and + { skip$ } + { this.to.prev.status + this.status.std + cap.status.std + address "address" bibinfo.check * + t empty$ + { skip$ } + { punct.period 'prev.status.punct := + space.large 'prev.status.space := + address empty$ + { skip$ } + { ": " * } + if$ + t * + } + if$ + year empty$ month empty$ and + { skip$ } + { t empty$ address empty$ and + { skip$ } + { ", " * } + if$ + month empty$ + { year empty$ + { skip$ } + { year "year" bibinfo.check * } + if$ + } + { month "month" bibinfo.check * + year empty$ + { skip$ } + { " " * year "year" bibinfo.check * } + if$ + } + if$ + } + if$ + } + if$ +} + + +FUNCTION {format.names} +{ 'bibinfo := + duplicate$ empty$ 'skip$ { + this.to.prev.status + this.status.std + 's := + "" 't := + #1 'nameptr := + s num.names$ 'numnames := + numnames 'namesleft := + { namesleft #0 > } + { s nameptr + name.format.string + format.name$ + bibinfo bibinfo.check + 't := + nameptr #1 > + { nameptr num.names.shown.with.forced.et.al #1 + = + numnames max.num.names.before.forced.et.al > + is.forced.et.al and and + { "others" 't := + #1 'namesleft := + } + { skip$ } + if$ + namesleft #1 > + { ", " * t do.name.latex.cmd * } + { s nameptr "{ll}" format.name$ duplicate$ "others" = + { 't := } + { pop$ } + if$ + t "others" = + { " " * bbl.etal emphasize * } + { numnames #2 > + { "," * } + { skip$ } + if$ + bbl.and + space.word * t do.name.latex.cmd * + } + if$ + } + if$ + } + { t do.name.latex.cmd } + if$ + nameptr #1 + 'nameptr := + namesleft #1 - 'namesleft := + } + while$ + cap.status.std + } if$ +} + + + + +%% Higher Level Formats + +%% addresses/locations + +FUNCTION {format.address} +{ address duplicate$ empty$ 'skip$ + { this.to.prev.status + this.status.std + cap.status.std + } + if$ +} + + + +%% author/editor names + +FUNCTION {format.authors}{ author "author" format.names } + +FUNCTION {format.editors} +{ editor "editor" format.names duplicate$ empty$ 'skip$ + { ", " * + get.bbl.editor + capitalize + * + } + if$ +} + + + +%% date + +FUNCTION {format.date} +{ + month "month" bibinfo.check duplicate$ empty$ + year "year" bibinfo.check duplicate$ empty$ + { swap$ 'skip$ + { this.to.prev.status + this.status.std + cap.status.std + "there's a month but no year in " cite$ * warning$ } + if$ + * + } + { this.to.prev.status + this.status.std + cap.status.std + swap$ 'skip$ + { + swap$ + " " * swap$ + } + if$ + * + } + if$ +} + +FUNCTION {format.date.electronic} +{ month "month" bibinfo.check duplicate$ empty$ + year "year" bibinfo.check duplicate$ empty$ + { swap$ + { pop$ } + { "there's a month but no year in " cite$ * warning$ + pop$ ")" * "(" swap$ * + this.to.prev.status + punct.no 'this.status.punct := + space.normal 'this.status.space := + quote.no 'this.status.quote := + cap.yes 'status.cap := + } + if$ + } + { swap$ + { swap$ pop$ ")" * "(" swap$ * } + { "(" swap$ * ", " * swap$ * ")" * } + if$ + this.to.prev.status + punct.no 'this.status.punct := + space.normal 'this.status.space := + quote.no 'this.status.quote := + cap.yes 'status.cap := + } + if$ +} + + + +%% edition/title + +% Note: IEEE considers the edition to be closely associated with +% the title of a book. So, in IEEEtran.bst the edition is normally handled +% within the formatting of the title. The format.edition function is +% retained here for possible future use. +FUNCTION {format.edition} +{ edition duplicate$ empty$ 'skip$ + { this.to.prev.status + this.status.std + convert.edition + status.cap + { "t" } + { "l" } + if$ change.case$ + "edition" bibinfo.check + "~" * bbl.edition * + cap.status.std + } + if$ +} + +% This is used to format the booktitle of a conference proceedings. +% Here we use the "intype" field to provide the user a way to +% override the word "in" (e.g., with things like "presented at") +% Use of intype stops the emphasis of the booktitle to indicate that +% we no longer mean the written conference proceedings, but the +% conference itself. +FUNCTION {format.in.booktitle} +{ booktitle "booktitle" bibinfo.check duplicate$ empty$ 'skip$ + { this.to.prev.status + this.status.std + select.language + intype missing$ + { emphasize + bbl.in " " * + } + { intype " " * } + if$ + swap$ * + cap.status.std + } + if$ +} + +% This is used to format the booktitle of collection. +% Here the "intype" field is not supported, but "edition" is. +FUNCTION {format.in.booktitle.edition} +{ booktitle "booktitle" bibinfo.check duplicate$ empty$ 'skip$ + { this.to.prev.status + this.status.std + select.language + emphasize + edition empty$ 'skip$ + { ", " * + edition + convert.edition + "l" change.case$ + * "~" * bbl.edition * + } + if$ + bbl.in " " * swap$ * + cap.status.std + } + if$ +} + +FUNCTION {format.article.title} +{ title duplicate$ empty$ 'skip$ + { this.to.prev.status + this.status.std + "t" change.case$ + } + if$ + "title" bibinfo.check + duplicate$ empty$ 'skip$ + { quote.close 'this.status.quote := + is.last.char.not.punct + { punct.std 'this.status.punct := } + { punct.no 'this.status.punct := } + if$ + select.language + "``" swap$ * + cap.status.std + } + if$ +} + +FUNCTION {format.article.title.electronic} +{ title duplicate$ empty$ 'skip$ + { this.to.prev.status + this.status.std + cap.status.std + "t" change.case$ + } + if$ + "title" bibinfo.check + duplicate$ empty$ + { skip$ } + { select.language } + if$ +} + +FUNCTION {format.book.title.edition} +{ title "title" bibinfo.check + duplicate$ empty$ + { "empty title in " cite$ * warning$ } + { this.to.prev.status + this.status.std + select.language + emphasize + edition empty$ 'skip$ + { ", " * + edition + convert.edition + status.cap + { "t" } + { "l" } + if$ + change.case$ + * "~" * bbl.edition * + } + if$ + cap.status.std + } + if$ +} + +FUNCTION {format.book.title} +{ title "title" bibinfo.check + duplicate$ empty$ 'skip$ + { this.to.prev.status + this.status.std + cap.status.std + select.language + emphasize + } + if$ +} + + + +%% journal + +FUNCTION {format.journal} +{ journal duplicate$ empty$ 'skip$ + { this.to.prev.status + this.status.std + cap.status.std + select.language + emphasize + } + if$ +} + + + +%% how published + +FUNCTION {format.howpublished} +{ howpublished duplicate$ empty$ 'skip$ + { this.to.prev.status + this.status.std + cap.status.std + } + if$ +} + + + +%% institutions/organization/publishers/school + +FUNCTION {format.institution} +{ institution duplicate$ empty$ 'skip$ + { this.to.prev.status + this.status.std + cap.status.std + } + if$ +} + +FUNCTION {format.organization} +{ organization duplicate$ empty$ 'skip$ + { this.to.prev.status + this.status.std + cap.status.std + } + if$ +} + +FUNCTION {format.address.publisher.date} +{ publisher "publisher" bibinfo.warn format.address.org.or.pub.date } + +FUNCTION {format.address.publisher.date.nowarn} +{ publisher "publisher" bibinfo.check format.address.org.or.pub.date } + +FUNCTION {format.address.organization.date} +{ organization "organization" bibinfo.check format.address.org.or.pub.date } + +FUNCTION {format.school} +{ school duplicate$ empty$ 'skip$ + { this.to.prev.status + this.status.std + cap.status.std + } + if$ +} + + + +%% volume/number/series/chapter/pages + +FUNCTION {format.volume} +{ volume empty.field.to.null.string + duplicate$ empty$ 'skip$ + { this.to.prev.status + this.status.std + bbl.volume + status.cap + { capitalize } + { skip$ } + if$ + swap$ tie.or.space.prefix + "volume" bibinfo.check + * * + cap.status.std + } + if$ +} + +FUNCTION {format.number} +{ number empty.field.to.null.string + duplicate$ empty$ 'skip$ + { this.to.prev.status + this.status.std + status.cap + { bbl.number capitalize } + { bbl.number } + if$ + swap$ tie.or.space.prefix + "number" bibinfo.check + * * + cap.status.std + } + if$ +} + +FUNCTION {format.number.if.use.for.article} +{ is.use.number.for.article + { format.number } + { "" } + if$ +} + +% IEEE does not seem to tie the series so closely with the volume +% and number as is done in other bibliography styles. Instead the +% series is treated somewhat like an extension of the title. +FUNCTION {format.series} +{ series empty$ + { "" } + { this.to.prev.status + this.status.std + bbl.series " " * + series "series" bibinfo.check * + cap.status.std + } + if$ +} + + +FUNCTION {format.chapter} +{ chapter empty$ + { "" } + { this.to.prev.status + this.status.std + type empty$ + { bbl.chapter } + { type "l" change.case$ + "type" bibinfo.check + } + if$ + chapter tie.or.space.prefix + "chapter" bibinfo.check + * * + cap.status.std + } + if$ +} + + +% The intended use of format.paper is for paper numbers of inproceedings. +% The paper type can be overridden via the type field. +% We allow the type to be displayed even if the paper number is absent +% for things like "postdeadline paper" +FUNCTION {format.paper} +{ is.use.paper + { paper empty$ + { type empty$ + { "" } + { this.to.prev.status + this.status.std + type "type" bibinfo.check + cap.status.std + } + if$ + } + { this.to.prev.status + this.status.std + type empty$ + { bbl.paper } + { type "type" bibinfo.check } + if$ + " " * paper + "paper" bibinfo.check + * + cap.status.std + } + if$ + } + { "" } + if$ +} + + +FUNCTION {format.pages} +{ pages duplicate$ empty$ 'skip$ + { this.to.prev.status + this.status.std + duplicate$ is.multiple.pages + { + bbl.pages swap$ + n.dashify + } + { + bbl.page swap$ + } + if$ + tie.or.space.prefix + "pages" bibinfo.check + * * + cap.status.std + } + if$ +} + + + +%% technical report number + +FUNCTION {format.tech.report.number} +{ number "number" bibinfo.check + this.to.prev.status + this.status.std + cap.status.std + type duplicate$ empty$ + { pop$ + bbl.techrep + } + { skip$ } + if$ + "type" bibinfo.check + swap$ duplicate$ empty$ + { pop$ } + { tie.or.space.prefix * * } + if$ +} + + + +%% note + +FUNCTION {format.note} +{ note empty$ + { "" } + { this.to.prev.status + this.status.std + punct.period 'this.status.punct := + note #1 #1 substring$ + duplicate$ "{" = + { skip$ } + { status.cap + { "u" } + { "l" } + if$ + change.case$ + } + if$ + note #2 global.max$ substring$ * "note" bibinfo.check + cap.yes 'status.cap := + } + if$ +} + + + +%% patent + +FUNCTION {format.patent.date} +{ this.to.prev.status + this.status.std + year empty$ + { monthfiled duplicate$ empty$ + { "monthfiled" bibinfo.check pop$ "" } + { "monthfiled" bibinfo.check } + if$ + dayfiled duplicate$ empty$ + { "dayfiled" bibinfo.check pop$ "" * } + { "dayfiled" bibinfo.check + monthfiled empty$ + { "dayfiled without a monthfiled in " cite$ * warning$ + * + } + { " " swap$ * * } + if$ + } + if$ + yearfiled empty$ + { "no year or yearfiled in " cite$ * warning$ } + { yearfiled "yearfiled" bibinfo.check + swap$ + duplicate$ empty$ + { pop$ } + { ", " * swap$ * } + if$ + } + if$ + } + { month duplicate$ empty$ + { "month" bibinfo.check pop$ "" } + { "month" bibinfo.check } + if$ + day duplicate$ empty$ + { "day" bibinfo.check pop$ "" * } + { "day" bibinfo.check + month empty$ + { "day without a month in " cite$ * warning$ + * + } + { " " swap$ * * } + if$ + } + if$ + year "year" bibinfo.check + swap$ + duplicate$ empty$ + { pop$ } + { ", " * swap$ * } + if$ + } + if$ + cap.status.std +} + +FUNCTION {format.patent.nationality.type.number} +{ this.to.prev.status + this.status.std + nationality duplicate$ empty$ + { "nationality" bibinfo.warn pop$ "" } + { "nationality" bibinfo.check + duplicate$ "l" change.case$ "united states" = + { pop$ bbl.patentUS } + { skip$ } + if$ + " " * + } + if$ + type empty$ + { bbl.patent "type" bibinfo.check } + { type "type" bibinfo.check } + if$ + * + number duplicate$ empty$ + { "number" bibinfo.warn pop$ } + { "number" bibinfo.check + large.number.separate + swap$ " " * swap$ * + } + if$ + cap.status.std +} + + + +%% standard + +FUNCTION {format.organization.institution.standard.type.number} +{ this.to.prev.status + this.status.std + organization duplicate$ empty$ + { pop$ + institution duplicate$ empty$ + { "institution" bibinfo.warn } + { "institution" bibinfo.warn " " * } + if$ + } + { "organization" bibinfo.warn " " * } + if$ + type empty$ + { bbl.standard "type" bibinfo.check } + { type "type" bibinfo.check } + if$ + * + number duplicate$ empty$ + { "number" bibinfo.check pop$ } + { "number" bibinfo.check + large.number.separate + swap$ " " * swap$ * + } + if$ + cap.status.std +} + +FUNCTION {format.revision} +{ revision empty$ + { "" } + { this.to.prev.status + this.status.std + bbl.revision + revision tie.or.space.prefix + "revision" bibinfo.check + * * + cap.status.std + } + if$ +} + + +%% thesis + +FUNCTION {format.master.thesis.type} +{ this.to.prev.status + this.status.std + type empty$ + { + bbl.mthesis + } + { + type "type" bibinfo.check + } + if$ +cap.status.std +} + +FUNCTION {format.phd.thesis.type} +{ this.to.prev.status + this.status.std + type empty$ + { + bbl.phdthesis + } + { + type "type" bibinfo.check + } + if$ +cap.status.std +} + + + +%% URL + +FUNCTION {format.url} +{ url empty$ + { "" } + { this.to.prev.status + this.status.std + cap.yes 'status.cap := + name.url.prefix " " * + "\url{" * url * "}" * + punct.no 'this.status.punct := + punct.period 'prev.status.punct := + space.normal 'this.status.space := + space.normal 'prev.status.space := + quote.no 'this.status.quote := + } + if$ +} + + + + +%%%%%%%%%%%%%%%%%%%% +%% ENTRY HANDLERS %% +%%%%%%%%%%%%%%%%%%%% + + +% Note: In many journals, IEEE (or the authors) tend not to show the number +% for articles, so the display of the number is controlled here by the +% switch "is.use.number.for.article" +FUNCTION {article} +{ std.status.using.comma + start.entry + if.url.alt.interword.spacing + format.authors "author" output.warn + name.or.dash + format.article.title "title" output.warn + format.journal "journal" bibinfo.check "journal" output.warn + format.volume output + format.number.if.use.for.article output + format.pages output + format.date "year" output.warn + format.note output + format.url output + fin.entry + if.url.std.interword.spacing +} + +FUNCTION {book} +{ std.status.using.comma + start.entry + if.url.alt.interword.spacing + author empty$ + { format.editors "author and editor" output.warn } + { format.authors output.nonnull } + if$ + name.or.dash + format.book.title.edition output + format.series output + author empty$ + { skip$ } + { format.editors output } + if$ + format.address.publisher.date output + format.volume output + format.number output + format.note output + format.url output + fin.entry + if.url.std.interword.spacing +} + +FUNCTION {booklet} +{ std.status.using.comma + start.entry + if.url.alt.interword.spacing + format.authors output + name.or.dash + format.article.title "title" output.warn + format.howpublished "howpublished" bibinfo.check output + format.organization "organization" bibinfo.check output + format.address "address" bibinfo.check output + format.date output + format.note output + format.url output + fin.entry + if.url.std.interword.spacing +} + +FUNCTION {electronic} +{ std.status.using.period + start.entry + if.url.alt.interword.spacing + format.authors output + name.or.dash + format.date.electronic output + format.article.title.electronic output + format.howpublished "howpublished" bibinfo.check output + format.organization "organization" bibinfo.check output + format.address "address" bibinfo.check output + format.note output + format.url output + fin.entry + empty.entry.warn + if.url.std.interword.spacing +} + +FUNCTION {inbook} +{ std.status.using.comma + start.entry + if.url.alt.interword.spacing + author empty$ + { format.editors "author and editor" output.warn } + { format.authors output.nonnull } + if$ + name.or.dash + format.book.title.edition output + format.series output + format.address.publisher.date output + format.volume output + format.number output + format.chapter output + format.pages output + format.note output + format.url output + fin.entry + if.url.std.interword.spacing +} + +FUNCTION {incollection} +{ std.status.using.comma + start.entry + if.url.alt.interword.spacing + format.authors "author" output.warn + name.or.dash + format.article.title "title" output.warn + format.in.booktitle.edition "booktitle" output.warn + format.series output + format.editors output + format.address.publisher.date.nowarn output + format.volume output + format.number output + format.chapter output + format.pages output + format.note output + format.url output + fin.entry + if.url.std.interword.spacing +} + +FUNCTION {inproceedings} +{ std.status.using.comma + start.entry + if.url.alt.interword.spacing + format.authors "author" output.warn + name.or.dash + format.article.title "title" output.warn + format.in.booktitle "booktitle" output.warn + format.series output + format.editors output + format.volume output + format.number output + publisher empty$ + { format.address.organization.date output } + { format.organization "organization" bibinfo.check output + format.address.publisher.date output + } + if$ + format.paper output + format.pages output + format.note output + format.url output + fin.entry + if.url.std.interword.spacing +} + +FUNCTION {manual} +{ std.status.using.comma + start.entry + if.url.alt.interword.spacing + format.authors output + name.or.dash + format.book.title.edition "title" output.warn + format.howpublished "howpublished" bibinfo.check output + format.organization "organization" bibinfo.check output + format.address "address" bibinfo.check output + format.date output + format.note output + format.url output + fin.entry + if.url.std.interword.spacing +} + +FUNCTION {mastersthesis} +{ std.status.using.comma + start.entry + if.url.alt.interword.spacing + format.authors "author" output.warn + name.or.dash + format.article.title "title" output.warn + format.master.thesis.type output.nonnull + format.school "school" bibinfo.warn output + format.address "address" bibinfo.check output + format.date "year" output.warn + format.note output + format.url output + fin.entry + if.url.std.interword.spacing +} + +FUNCTION {misc} +{ std.status.using.comma + start.entry + if.url.alt.interword.spacing + format.authors output + name.or.dash + format.article.title output + format.howpublished "howpublished" bibinfo.check output + format.organization "organization" bibinfo.check output + format.address "address" bibinfo.check output + format.pages output + format.date output + format.note output + format.url output + fin.entry + empty.entry.warn + if.url.std.interword.spacing +} + +FUNCTION {patent} +{ std.status.using.comma + start.entry + if.url.alt.interword.spacing + format.authors output + name.or.dash + format.article.title output + format.patent.nationality.type.number output + format.patent.date output + format.note output + format.url output + fin.entry + empty.entry.warn + if.url.std.interword.spacing +} + +FUNCTION {periodical} +{ std.status.using.comma + start.entry + if.url.alt.interword.spacing + format.editors output + name.or.dash + format.book.title "title" output.warn + format.series output + format.volume output + format.number output + format.organization "organization" bibinfo.check output + format.date "year" output.warn + format.note output + format.url output + fin.entry + if.url.std.interword.spacing +} + +FUNCTION {phdthesis} +{ std.status.using.comma + start.entry + if.url.alt.interword.spacing + format.authors "author" output.warn + name.or.dash + format.article.title "title" output.warn + format.phd.thesis.type output.nonnull + format.school "school" bibinfo.warn output + format.address "address" bibinfo.check output + format.date "year" output.warn + format.note output + format.url output + fin.entry + if.url.std.interword.spacing +} + +FUNCTION {proceedings} +{ std.status.using.comma + start.entry + if.url.alt.interword.spacing + format.editors output + name.or.dash + format.book.title "title" output.warn + format.series output + format.volume output + format.number output + publisher empty$ + { format.address.organization.date output } + { format.organization "organization" bibinfo.check output + format.address.publisher.date output + } + if$ + format.note output + format.url output + fin.entry + if.url.std.interword.spacing +} + +FUNCTION {standard} +{ std.status.using.comma + start.entry + if.url.alt.interword.spacing + format.authors output + name.or.dash + format.book.title "title" output.warn + format.howpublished "howpublished" bibinfo.check output + format.organization.institution.standard.type.number output + format.revision output + format.date output + format.note output + format.url output + fin.entry + if.url.std.interword.spacing +} + +FUNCTION {techreport} +{ std.status.using.comma + start.entry + if.url.alt.interword.spacing + format.authors "author" output.warn + name.or.dash + format.article.title "title" output.warn + format.howpublished "howpublished" bibinfo.check output + format.institution "institution" bibinfo.warn output + format.address "address" bibinfo.check output + format.tech.report.number output.nonnull + format.date "year" output.warn + format.note output + format.url output + fin.entry + if.url.std.interword.spacing +} + +FUNCTION {unpublished} +{ std.status.using.comma + start.entry + if.url.alt.interword.spacing + format.authors "author" output.warn + name.or.dash + format.article.title "title" output.warn + format.date output + format.note "note" output.warn + format.url output + fin.entry + if.url.std.interword.spacing +} + + +% The special entry type which provides the user interface to the +% BST controls +FUNCTION {IEEEtranBSTCTL} +{ is.print.banners.to.terminal + { "** IEEEtran BST control entry " quote$ * cite$ * quote$ * " detected." * + top$ + } + { skip$ } + if$ + CTLuse_article_number + empty$ + { skip$ } + { CTLuse_article_number + yes.no.to.int + 'is.use.number.for.article := + } + if$ + CTLuse_paper + empty$ + { skip$ } + { CTLuse_paper + yes.no.to.int + 'is.use.paper := + } + if$ + CTLuse_forced_etal + empty$ + { skip$ } + { CTLuse_forced_etal + yes.no.to.int + 'is.forced.et.al := + } + if$ + CTLmax_names_forced_etal + empty$ + { skip$ } + { CTLmax_names_forced_etal + string.to.integer + 'max.num.names.before.forced.et.al := + } + if$ + CTLnames_show_etal + empty$ + { skip$ } + { CTLnames_show_etal + string.to.integer + 'num.names.shown.with.forced.et.al := + } + if$ + CTLuse_alt_spacing + empty$ + { skip$ } + { CTLuse_alt_spacing + yes.no.to.int + 'is.use.alt.interword.spacing := + } + if$ + CTLalt_stretch_factor + empty$ + { skip$ } + { CTLalt_stretch_factor + 'ALTinterwordstretchfactor := + "\renewcommand{\BIBentryALTinterwordstretchfactor}{" + ALTinterwordstretchfactor * "}" * + write$ newline$ + } + if$ + CTLdash_repeated_names + empty$ + { skip$ } + { CTLdash_repeated_names + yes.no.to.int + 'is.dash.repeated.names := + } + if$ + CTLname_format_string + empty$ + { skip$ } + { CTLname_format_string + 'name.format.string := + } + if$ + CTLname_latex_cmd + empty$ + { skip$ } + { CTLname_latex_cmd + 'name.latex.cmd := + } + if$ + CTLname_url_prefix + missing$ + { skip$ } + { CTLname_url_prefix + 'name.url.prefix := + } + if$ + + + num.names.shown.with.forced.et.al max.num.names.before.forced.et.al > + { "CTLnames_show_etal cannot be greater than CTLmax_names_forced_etal in " cite$ * warning$ + max.num.names.before.forced.et.al 'num.names.shown.with.forced.et.al := + } + { skip$ } + if$ +} + + +%%%%%%%%%%%%%%%%%%% +%% ENTRY ALIASES %% +%%%%%%%%%%%%%%%%%%% +FUNCTION {conference}{inproceedings} +FUNCTION {online}{electronic} +FUNCTION {internet}{electronic} +FUNCTION {webpage}{electronic} +FUNCTION {www}{electronic} +FUNCTION {default.type}{misc} + + + +%%%%%%%%%%%%%%%%%% +%% MAIN PROGRAM %% +%%%%%%%%%%%%%%%%%% + +READ + +EXECUTE {initialize.controls} +EXECUTE {initialize.status.constants} +EXECUTE {banner.message} + +EXECUTE {initialize.longest.label} +ITERATE {longest.label.pass} + +EXECUTE {begin.bib} +ITERATE {call.type$} +EXECUTE {end.bib} + +EXECUTE{completed.message} + + +%% That's all folks, mds. diff --git a/IEEEtran/IEEEtran.cls b/IEEEtran/IEEEtran.cls new file mode 100644 index 0000000..f3a8b5b --- /dev/null +++ b/IEEEtran/IEEEtran.cls @@ -0,0 +1,4733 @@ +%% +%% IEEEtran.cls 2011/11/03 version V1.8 based on +%% IEEEtran.cls 2007/03/05 version V1.7a +%% The changes in V1.8 are made with a single goal in mind: +%% to change the look of the output using the [conference] option +%% and the default font size (10pt) to match the Word template more closely. +%% These changes may well have undesired side effects when other options +%% are in force! +%% +%% +%% This is the official IEEE LaTeX class for authors of the Institute of +%% Electrical and Electronics Engineers (IEEE) Transactions journals and +%% conferences. +%% +%% Support sites: +%% http://www.michaelshell.org/tex/ieeetran/ +%% http://www.ctan.org/tex-archive/macros/latex/contrib/IEEEtran/ +%% and +%% http://www.ieee.org/ +%% +%% Based on the original 1993 IEEEtran.cls, but with many bug fixes +%% and enhancements (from both JVH and MDS) over the 1996/7 version. +%% +%% +%% Contributors: +%% Gerry Murray (1993), Silvano Balemi (1993), +%% Jon Dixon (1996), Peter N"uchter (1996), +%% Juergen von Hagen (2000), and Michael Shell (2001-2007) +%% +%% +%% Copyright (c) 1993-2000 by Gerry Murray, Silvano Balemi, +%% Jon Dixon, Peter N"uchter, +%% Juergen von Hagen +%% and +%% Copyright (c) 2001-2007 by Michael Shell +%% +%% Current maintainer (V1.3 to V1.7): Michael Shell +%% See: +%% http://www.michaelshell.org/ +%% for current contact information. +%% +%% Special thanks to Peter Wilson (CUA) and Donald Arseneau +%% for allowing the inclusion of the \@ifmtarg command +%% from their ifmtarg LaTeX package. +%% +%%************************************************************************* +%% Legal Notice: +%% This code is offered as-is without any warranty either expressed or +%% implied; without even the implied warranty of MERCHANTABILITY or +%% FITNESS FOR A PARTICULAR PURPOSE! +%% User assumes all risk. +%% In no event shall IEEE or any contributor to this code be liable for +%% any damages or losses, including, but not limited to, incidental, +%% consequential, or any other damages, resulting from the use or misuse +%% of any information contained here. +%% +%% All comments are the opinions of their respective authors and are not +%% necessarily endorsed by the IEEE. +%% +%% This work is distributed under the LaTeX Project Public License (LPPL) +%% ( http://www.latex-project.org/ ) version 1.3, and may be freely used, +%% distributed and modified. A copy of the LPPL, version 1.3, is included +%% in the base LaTeX documentation of all distributions of LaTeX released +%% 2003/12/01 or later. +%% Retain all contribution notices and credits. +%% ** Modified files should be clearly indicated as such, including ** +%% ** renaming them and changing author support contact information. ** +%% +%% File list of work: IEEEtran.cls, IEEEtran_HOWTO.pdf, bare_adv.tex, +%% bare_conf.tex, bare_jrnl.tex, bare_jrnl_compsoc.tex +%% +%% Major changes to the user interface should be indicated by an +%% increase in the version numbers. If a version is a beta, it will +%% be indicated with a BETA suffix, i.e., 1.4 BETA. +%% Small changes can be indicated by appending letters to the version +%% such as "IEEEtran_v14a.cls". +%% In all cases, \Providesclass, any \typeout messages to the user, +%% \IEEEtransversionmajor and \IEEEtransversionminor must reflect the +%% correct version information. +%% The changes should also be documented via source comments. +%%************************************************************************* +%% +% +% Available class options +% e.g., \documentclass[10pt,conference]{IEEEtran} +% +% *** choose only one from each category *** +% +% 9pt, 10pt, 11pt, 12pt +% Sets normal font size. The default is 10pt. +% +% conference, journal, technote, peerreview, peerreviewca +% determines format mode - conference papers, journal papers, +% correspondence papers (technotes), or peer review papers. The user +% should also select 9pt when using technote. peerreview is like +% journal mode, but provides for a single-column "cover" title page for +% anonymous peer review. The paper title (without the author names) is +% repeated at the top of the page after the cover page. For peer review +% papers, the \IEEEpeerreviewmaketitle command must be executed (will +% automatically be ignored for non-peerreview modes) at the place the +% cover page is to end, usually just after the abstract (keywords are +% not normally used with peer review papers). peerreviewca is like +% peerreview, but allows the author names to be entered and formatted +% as with conference mode so that author affiliation and contact +% information can be easily seen on the cover page. +% The default is journal. +% +% draft, draftcls, draftclsnofoot, final +% determines if paper is formatted as a widely spaced draft (for +% handwritten editor comments) or as a properly typeset final version. +% draftcls restricts draft mode to the class file while all other LaTeX +% packages (i.e., \usepackage{graphicx}) will behave as final - allows +% for a draft paper with visible figures, etc. draftclsnofoot is like +% draftcls, but does not display the date and the word "DRAFT" at the foot +% of the pages. If using one of the draft modes, the user will probably +% also want to select onecolumn. +% The default is final. +% +% letterpaper, a4paper +% determines paper size: 8.5in X 11in or 210mm X 297mm. CHANGING THE PAPER +% SIZE WILL NOT ALTER THE TYPESETTING OF THE DOCUMENT - ONLY THE MARGINS +% WILL BE AFFECTED. In particular, documents using the a4paper option will +% have reduced side margins (A4 is narrower than US letter) and a longer +% bottom margin (A4 is longer than US letter). For both cases, the top +% margins will be the same and the text will be horizontally centered. +% For final submission to IEEE, authors should use US letter (8.5 X 11in) +% paper. Note that authors should ensure that all post-processing +% (ps, pdf, etc.) uses the same paper specificiation as the .tex document. +% Problems here are by far the number one reason for incorrect margins. +% IEEEtran will automatically set the default paper size under pdflatex +% (without requiring a change to pdftex.cfg), so this issue is more +% important to dvips users. Fix config.ps, config.pdf, or ~/.dvipsrc for +% dvips, or use the dvips -t papersize option instead as needed. See the +% testflow documentation +% http://www.ctan.org/tex-archive/macros/latex/contrib/IEEEtran/testflow +% for more details on dvips paper size configuration. +% The default is letterpaper. +% +% oneside, twoside +% determines if layout follows single sided or two sided (duplex) +% printing. The only notable change is with the headings at the top of +% the pages. +% The default is oneside. +% +% onecolumn, twocolumn +% determines if text is organized into one or two columns per page. One +% column mode is usually used only with draft papers. +% The default is twocolumn. +% +% compsoc +% Use the format of the IEEE Computer Society. +% +% romanappendices +% Use the "Appendix I" convention when numbering appendices. IEEEtran.cls +% now defaults to Alpha "Appendix A" convention - the opposite of what +% v1.6b and earlier did. +% +% captionsoff +% disables the display of the figure/table captions. Some IEEE journals +% request that captions be removed and figures/tables be put on pages +% of their own at the end of an initial paper submission. The endfloat +% package can be used with this class option to achieve this format. +% +% nofonttune +% turns off tuning of the font interword spacing. Maybe useful to those +% not using the standard Times fonts or for those who have already "tuned" +% their fonts. +% The default is to enable IEEEtran to tune font parameters. +% +% +%---------- +% Available CLASSINPUTs provided (all are macros unless otherwise noted): +% \CLASSINPUTbaselinestretch +% \CLASSINPUTinnersidemargin +% \CLASSINPUToutersidemargin +% \CLASSINPUTtoptextmargin +% \CLASSINPUTbottomtextmargin +% +% Available CLASSINFOs provided: +% \ifCLASSINFOpdf (TeX if conditional) +% \CLASSINFOpaperwidth (macro) +% \CLASSINFOpaperheight (macro) +% \CLASSINFOnormalsizebaselineskip (length) +% \CLASSINFOnormalsizeunitybaselineskip (length) +% +% Available CLASSOPTIONs provided: +% all class option flags (TeX if conditionals) unless otherwise noted, +% e.g., \ifCLASSOPTIONcaptionsoff +% point size options provided as a single macro: +% \CLASSOPTIONpt +% which will be defined as 9, 10, 11, or 12 depending on the document's +% normalsize point size. +% also, class option peerreviewca implies the use of class option peerreview +% and classoption draft implies the use of class option draftcls + + + + + +\ProvidesClass{IEEEtran}[2012/11/21 V1.8c by Harald Hanche-Olsen and Anders Christensen] +\typeout{-- Based on V1.7a by Michael Shell} +\typeout{-- See the "IEEEtran_HOWTO" manual for usage information.} +\typeout{-- http://www.michaelshell.org/tex/ieeetran/} +\NeedsTeXFormat{LaTeX2e} + +% IEEEtran.cls version numbers, provided as of V1.3 +% These values serve as a way a .tex file can +% determine if the new features are provided. +% The version number of this IEEEtrans.cls can be obtained from +% these values. i.e., V1.4 +% KEEP THESE AS INTEGERS! i.e., NO {4a} or anything like that- +% (no need to enumerate "a" minor changes here) +\def\IEEEtransversionmajor{1} +\def\IEEEtransversionminor{7} + +% These do nothing, but provide them like in article.cls +\newif\if@restonecol +\newif\if@titlepage + + +% class option conditionals +\newif\ifCLASSOPTIONonecolumn \CLASSOPTIONonecolumnfalse +\newif\ifCLASSOPTIONtwocolumn \CLASSOPTIONtwocolumntrue + +\newif\ifCLASSOPTIONoneside \CLASSOPTIONonesidetrue +\newif\ifCLASSOPTIONtwoside \CLASSOPTIONtwosidefalse + +\newif\ifCLASSOPTIONfinal \CLASSOPTIONfinaltrue +\newif\ifCLASSOPTIONdraft \CLASSOPTIONdraftfalse +\newif\ifCLASSOPTIONdraftcls \CLASSOPTIONdraftclsfalse +\newif\ifCLASSOPTIONdraftclsnofoot \CLASSOPTIONdraftclsnofootfalse + +\newif\ifCLASSOPTIONpeerreview \CLASSOPTIONpeerreviewfalse +\newif\ifCLASSOPTIONpeerreviewca \CLASSOPTIONpeerreviewcafalse + +\newif\ifCLASSOPTIONjournal \CLASSOPTIONjournaltrue +\newif\ifCLASSOPTIONconference \CLASSOPTIONconferencefalse +\newif\ifCLASSOPTIONtechnote \CLASSOPTIONtechnotefalse + +\newif\ifCLASSOPTIONnofonttune \CLASSOPTIONnofonttunefalse + +\newif\ifCLASSOPTIONcaptionsoff \CLASSOPTIONcaptionsofffalse + +\newif\ifCLASSOPTIONcompsoc \CLASSOPTIONcompsocfalse + +\newif\ifCLASSOPTIONromanappendices \CLASSOPTIONromanappendicesfalse + + +% class info conditionals + +% indicates if pdf (via pdflatex) output +\newif\ifCLASSINFOpdf \CLASSINFOpdffalse + + +% V1.6b internal flag to show if using a4paper +\newif\if@IEEEusingAfourpaper \@IEEEusingAfourpaperfalse + + + +% IEEEtran class scratch pad registers +% dimen +\newdimen\@IEEEtrantmpdimenA +\newdimen\@IEEEtrantmpdimenB +% count +\newcount\@IEEEtrantmpcountA +\newcount\@IEEEtrantmpcountB +% token list +\newtoks\@IEEEtrantmptoksA + +% we use \CLASSOPTIONpt so that we can ID the point size (even for 9pt docs) +% as well as LaTeX's \@ptsize to retain some compatability with some +% external packages +\def\@ptsize{0} +% LaTeX does not support 9pt, so we set \@ptsize to 0 - same as that of 10pt +\DeclareOption{9pt}{\def\CLASSOPTIONpt{9}\def\@ptsize{0}} +\DeclareOption{10pt}{\def\CLASSOPTIONpt{10}\def\@ptsize{0}} +\DeclareOption{11pt}{\def\CLASSOPTIONpt{11}\def\@ptsize{1}} +\DeclareOption{12pt}{\def\CLASSOPTIONpt{12}\def\@ptsize{2}} + + + +\DeclareOption{letterpaper}{\setlength{\paperheight}{11in}% + \setlength{\paperwidth}{8.5in}% + \@IEEEusingAfourpaperfalse + \def\CLASSOPTIONpaper{letter}% + \def\CLASSINFOpaperwidth{8.5in}% + \def\CLASSINFOpaperheight{11in}} + + +\DeclareOption{a4paper}{\setlength{\paperheight}{297mm}% + \setlength{\paperwidth}{210mm}% + \@IEEEusingAfourpapertrue + \def\CLASSOPTIONpaper{a4}% + \def\CLASSINFOpaperwidth{210mm}% + \def\CLASSINFOpaperheight{297mm}} + +\DeclareOption{oneside}{\@twosidefalse\@mparswitchfalse + \CLASSOPTIONonesidetrue\CLASSOPTIONtwosidefalse} +\DeclareOption{twoside}{\@twosidetrue\@mparswitchtrue + \CLASSOPTIONtwosidetrue\CLASSOPTIONonesidefalse} + +\DeclareOption{onecolumn}{\CLASSOPTIONonecolumntrue\CLASSOPTIONtwocolumnfalse} +\DeclareOption{twocolumn}{\CLASSOPTIONtwocolumntrue\CLASSOPTIONonecolumnfalse} + +% If the user selects draft, then this class AND any packages +% will go into draft mode. +\DeclareOption{draft}{\CLASSOPTIONdrafttrue\CLASSOPTIONdraftclstrue + \CLASSOPTIONdraftclsnofootfalse} +% draftcls is for a draft mode which will not affect any packages +% used by the document. +\DeclareOption{draftcls}{\CLASSOPTIONdraftfalse\CLASSOPTIONdraftclstrue + \CLASSOPTIONdraftclsnofootfalse} +% draftclsnofoot is like draftcls, but without the footer. +\DeclareOption{draftclsnofoot}{\CLASSOPTIONdraftfalse\CLASSOPTIONdraftclstrue + \CLASSOPTIONdraftclsnofoottrue} +\DeclareOption{final}{\CLASSOPTIONdraftfalse\CLASSOPTIONdraftclsfalse + \CLASSOPTIONdraftclsnofootfalse} + +\DeclareOption{journal}{\CLASSOPTIONpeerreviewfalse\CLASSOPTIONpeerreviewcafalse + \CLASSOPTIONjournaltrue\CLASSOPTIONconferencefalse\CLASSOPTIONtechnotefalse} + +\DeclareOption{conference}{\CLASSOPTIONpeerreviewfalse\CLASSOPTIONpeerreviewcafalse + \CLASSOPTIONjournalfalse\CLASSOPTIONconferencetrue\CLASSOPTIONtechnotefalse} + +\DeclareOption{technote}{\CLASSOPTIONpeerreviewfalse\CLASSOPTIONpeerreviewcafalse + \CLASSOPTIONjournalfalse\CLASSOPTIONconferencefalse\CLASSOPTIONtechnotetrue} + +\DeclareOption{peerreview}{\CLASSOPTIONpeerreviewtrue\CLASSOPTIONpeerreviewcafalse + \CLASSOPTIONjournalfalse\CLASSOPTIONconferencefalse\CLASSOPTIONtechnotefalse} + +\DeclareOption{peerreviewca}{\CLASSOPTIONpeerreviewtrue\CLASSOPTIONpeerreviewcatrue + \CLASSOPTIONjournalfalse\CLASSOPTIONconferencefalse\CLASSOPTIONtechnotefalse} + +\DeclareOption{nofonttune}{\CLASSOPTIONnofonttunetrue} + +\DeclareOption{captionsoff}{\CLASSOPTIONcaptionsofftrue} + +\DeclareOption{compsoc}{\CLASSOPTIONcompsoctrue} + +\DeclareOption{romanappendices}{\CLASSOPTIONromanappendicestrue} + + +% default to US letter paper, 10pt, twocolumn, one sided, final, journal +\ExecuteOptions{letterpaper,10pt,twocolumn,oneside,final,journal} +% overrride these defaults per user requests +\ProcessOptions + + + +% Computer Society conditional execution command +\long\def\@IEEEcompsoconly#1{\relax\ifCLASSOPTIONcompsoc\relax#1\relax\fi\relax} +% inverse +\long\def\@IEEEnotcompsoconly#1{\relax\ifCLASSOPTIONcompsoc\else\relax#1\relax\fi\relax} +% compsoc conference +\long\def\@IEEEcompsocconfonly#1{\relax\ifCLASSOPTIONcompsoc\ifCLASSOPTIONconference\relax#1\relax\fi\fi\relax} +% compsoc not conference +\long\def\@IEEEcompsocnotconfonly#1{\relax\ifCLASSOPTIONcompsoc\ifCLASSOPTIONconference\else\relax#1\relax\fi\fi\relax} + + +% IEEE uses Times Roman font, so we'll default to Times. +% These three commands make up the entire times.sty package. +\renewcommand{\sfdefault}{phv} +\renewcommand{\rmdefault}{ptm} +\renewcommand{\ttdefault}{pcr} + +\@IEEEcompsoconly{\typeout{-- Using IEEE Computer Society mode.}} + +% V1.7 compsoc nonconference papers, use Palatino/Palladio as the main text font, +% not Times Roman. +\@IEEEcompsocnotconfonly{\renewcommand{\rmdefault}{ppl}} + +% enable Times/Palatino main text font +\normalfont\selectfont + + + + + +% V1.7 conference notice message hook +\def\@IEEEconsolenoticeconference{\typeout{}% +\typeout{** Conference Paper **}% +\typeout{Before submitting the final camera ready copy, remember to:}% +\typeout{}% +\typeout{ 1. Manually equalize the lengths of two columns on the last page}% +\typeout{ of your paper;}% +\typeout{}% +\typeout{ 2. Ensure that any PostScript and/or PDF output post-processing}% +\typeout{ uses only Type 1 fonts and that every step in the generation}% +\typeout{ process uses the appropriate paper size.}% +\typeout{}} + + +% we can send console reminder messages to the user here +\AtEndDocument{\ifCLASSOPTIONconference\@IEEEconsolenoticeconference\fi} + + +% warn about the use of single column other than for draft mode +\ifCLASSOPTIONtwocolumn\else% + \ifCLASSOPTIONdraftcls\else% + \typeout{** ATTENTION: Single column mode is not typically used with IEEE publications.}% + \fi% +\fi + + +% V1.7 improved paper size setting code. +% Set pdfpage and dvips paper sizes. Conditional tests are similar to that +% of ifpdf.sty. Retain within {} to ensure tested macros are never altered, +% even if only effect is to set them to \relax. +% if \pdfoutput is undefined or equal to relax, output a dvips special +{\@ifundefined{pdfoutput}{\AtBeginDvi{\special{papersize=\CLASSINFOpaperwidth,\CLASSINFOpaperheight}}}{% +% pdfoutput is defined and not equal to \relax +% check for pdfpageheight existence just in case someone sets pdfoutput +% under non-pdflatex. If exists, set them regardless of value of \pdfoutput. +\@ifundefined{pdfpageheight}{\relax}{\global\pdfpagewidth\paperwidth +\global\pdfpageheight\paperheight}% +% if using \pdfoutput=0 under pdflatex, send dvips papersize special +\ifcase\pdfoutput +\AtBeginDvi{\special{papersize=\CLASSINFOpaperwidth,\CLASSINFOpaperheight}}% +\else +% we are using pdf output, set CLASSINFOpdf flag +\global\CLASSINFOpdftrue +\fi}} + +% let the user know the selected papersize +\typeout{-- Using \CLASSINFOpaperwidth\space x \CLASSINFOpaperheight\space +(\CLASSOPTIONpaper)\space paper.} + +\ifCLASSINFOpdf +\typeout{-- Using PDF output.} +\else +\typeout{-- Using DVI output.} +\fi + + +% The idea hinted here is for LaTeX to generate markleft{} and markright{} +% automatically for you after you enter \author{}, \journal{}, +% \journaldate{}, journalvol{}, \journalnum{}, etc. +% However, there may be some backward compatibility issues here as +% well as some special applications for IEEEtran.cls and special issues +% that may require the flexible \markleft{}, \markright{} and/or \markboth{}. +% We'll leave this as an open future suggestion. +%\newcommand{\journal}[1]{\def\@journal{#1}} +%\def\@journal{} + + + +% pointsize values +% used with ifx to determine the document's normal size +\def\@IEEEptsizenine{9} +\def\@IEEEptsizeten{10} +\def\@IEEEptsizeeleven{11} +\def\@IEEEptsizetwelve{12} + + + +% FONT DEFINITIONS (No sizexx.clo file needed) +% V1.6 revised font sizes, displayskip values and +% revised normalsize baselineskip to reduce underfull vbox problems +% on the 58pc = 696pt = 9.5in text height we want +% normalsize #lines/column baselineskip (aka leading) +% 9pt 63 11.0476pt (truncated down) +% 10pt 58 12pt (exact) +% 11pt 52 13.3846pt (truncated down) +% 12pt 50 13.92pt (exact) +% + +% we need to store the nominal baselineskip for the given font size +% in case baselinestretch ever changes. +% this is a dimen, so it will not hold stretch or shrink +\newdimen\@IEEEnormalsizeunitybaselineskip +\@IEEEnormalsizeunitybaselineskip\baselineskip + +\ifx\CLASSOPTIONpt\@IEEEptsizenine +\typeout{-- This is a 9 point document.} +\def\normalsize{\@setfontsize{\normalsize}{9}{11.0476pt}}% +\setlength{\@IEEEnormalsizeunitybaselineskip}{11.0476pt}% +\normalsize +\abovedisplayskip 1.5ex plus3pt minus1pt% +\belowdisplayskip \abovedisplayskip% +\abovedisplayshortskip 0pt plus3pt% +\belowdisplayshortskip 1.5ex plus3pt minus1pt +\def\small{\@setfontsize{\small}{8.5}{10pt}} +\def\footnotesize{\@setfontsize{\footnotesize}{8}{9pt}} +\def\scriptsize{\@setfontsize{\scriptsize}{7}{8pt}} +\def\tiny{\@setfontsize{\tiny}{5}{6pt}} +% sublargesize is the same as large - 10pt +\def\sublargesize{\@setfontsize{\sublargesize}{10}{12pt}} +\def\large{\@setfontsize{\large}{10}{12pt}} +\def\Large{\@setfontsize{\Large}{12}{14pt}} +\def\LARGE{\@setfontsize{\LARGE}{14}{17pt}} +\def\huge{\@setfontsize{\huge}{17}{20pt}} +\def\Huge{\@setfontsize{\Huge}{20}{24pt}} +\fi + + +% Check if we have selected 10 points +\ifx\CLASSOPTIONpt\@IEEEptsizeten +\typeout{-- This is a 10 point document.} +\def\normalsize{\@setfontsize{\normalsize}{10}{11}}% +\setlength{\@IEEEnormalsizeunitybaselineskip}{11pt}% +\normalsize +\abovedisplayskip 1.5ex plus4pt minus2pt% +\belowdisplayskip \abovedisplayskip% +\abovedisplayshortskip 0pt plus4pt% +\belowdisplayshortskip 1.5ex plus4pt minus2pt +\def\small{\@setfontsize{\small}{9}{10pt}} +\def\footnotesize{\@setfontsize{\footnotesize}{8}{9pt}} +\def\scriptsize{\@setfontsize{\scriptsize}{7}{8pt}} +\def\tiny{\@setfontsize{\tiny}{5}{6pt}} +% sublargesize is a tad smaller than large - 11pt +\def\sublargesize{\@setfontsize{\sublargesize}{11}{13.4pt}} +\def\large{\@setfontsize{\large}{12}{14pt}} +\def\Large{\@setfontsize{\Large}{14}{17pt}} +\def\LARGE{\@setfontsize{\LARGE}{17}{20pt}} +\def\huge{\@setfontsize{\huge}{20}{24pt}} +\def\Huge{\@setfontsize{\Huge}{24}{28pt}} +\fi + + +% Check if we have selected 11 points +\ifx\CLASSOPTIONpt\@IEEEptsizeeleven +\typeout{-- This is an 11 point document.} +\def\normalsize{\@setfontsize{\normalsize}{11}{13.3846pt}}% +\setlength{\@IEEEnormalsizeunitybaselineskip}{13.3846pt}% +\normalsize +\abovedisplayskip 1.5ex plus5pt minus3pt% +\belowdisplayskip \abovedisplayskip% +\abovedisplayshortskip 0pt plus5pt% +\belowdisplayshortskip 1.5ex plus5pt minus3pt +\def\small{\@setfontsize{\small}{10}{12pt}} +\def\footnotesize{\@setfontsize{\footnotesize}{9}{10.5pt}} +\def\scriptsize{\@setfontsize{\scriptsize}{8}{9pt}} +\def\tiny{\@setfontsize{\tiny}{6}{7pt}} +% sublargesize is the same as large - 12pt +\def\sublargesize{\@setfontsize{\sublargesize}{12}{14pt}} +\def\large{\@setfontsize{\large}{12}{14pt}} +\def\Large{\@setfontsize{\Large}{14}{17pt}} +\def\LARGE{\@setfontsize{\LARGE}{17}{20pt}} +\def\huge{\@setfontsize{\huge}{20}{24pt}} +\def\Huge{\@setfontsize{\Huge}{24}{28pt}} +\fi + + +% Check if we have selected 12 points +\ifx\CLASSOPTIONpt\@IEEEptsizetwelve +\typeout{-- This is a 12 point document.} +\def\normalsize{\@setfontsize{\normalsize}{12}{13.92pt}}% +\setlength{\@IEEEnormalsizeunitybaselineskip}{13.92pt}% +\normalsize +\abovedisplayskip 1.5ex plus6pt minus4pt% +\belowdisplayskip \abovedisplayskip% +\abovedisplayshortskip 0pt plus6pt% +\belowdisplayshortskip 1.5ex plus6pt minus4pt +\def\small{\@setfontsize{\small}{10}{12pt}} +\def\footnotesize{\@setfontsize{\footnotesize}{9}{10.5pt}} +\def\scriptsize{\@setfontsize{\scriptsize}{8}{9pt}} +\def\tiny{\@setfontsize{\tiny}{6}{7pt}} +% sublargesize is the same as large - 14pt +\def\sublargesize{\@setfontsize{\sublargesize}{14}{17pt}} +\def\large{\@setfontsize{\large}{14}{17pt}} +\def\Large{\@setfontsize{\Large}{17}{20pt}} +\def\LARGE{\@setfontsize{\LARGE}{20}{24pt}} +\def\huge{\@setfontsize{\huge}{22}{26pt}} +\def\Huge{\@setfontsize{\Huge}{24}{28pt}} +\fi + + +% V1.6 The Computer Modern Fonts will issue a substitution warning for +% 24pt titles (24.88pt is used instead) increase the substitution +% tolerance to turn off this warning +\def\fontsubfuzz{.9pt} +% However, the default (and correct) Times font will scale exactly as needed. + + +% warn the user in case they forget to use the 9pt option with +% technote +\ifCLASSOPTIONtechnote% + \ifx\CLASSOPTIONpt\@IEEEptsizenine\else% + \typeout{** ATTENTION: Technotes are normally 9pt documents.}% + \fi% +\fi + + +% V1.7 +% Improved \textunderscore to provide a much better fake _ when used with +% OT1 encoding. Under OT1, detect use of pcr or cmtt \ttfamily and use +% available true _ glyph for those two typewriter fonts. +\def\@IEEEstringptm{ptm} % Times Roman family +\def\@IEEEstringppl{ppl} % Palatino Roman family +\def\@IEEEstringphv{phv} % Helvetica Sans Serif family +\def\@IEEEstringpcr{pcr} % Courier typewriter family +\def\@IEEEstringcmtt{cmtt} % Computer Modern typewriter family +\DeclareTextCommandDefault{\textunderscore}{\leavevmode +\ifx\f@family\@IEEEstringpcr\string_\else +\ifx\f@family\@IEEEstringcmtt\string_\else +\ifx\f@family\@IEEEstringptm\kern 0em\vbox{\hrule\@width 0.5em\@height 0.5pt\kern -0.3ex}\else +\ifx\f@family\@IEEEstringppl\kern 0em\vbox{\hrule\@width 0.5em\@height 0.5pt\kern -0.3ex}\else +\ifx\f@family\@IEEEstringphv\kern -0.03em\vbox{\hrule\@width 0.62em\@height 0.52pt\kern -0.33ex}\kern -0.03em\else +\kern 0.09em\vbox{\hrule\@width 0.6em\@height 0.44pt\kern -0.63pt\kern -0.42ex}\kern 0.09em\fi\fi\fi\fi\fi\relax} + + + + +% set the default \baselinestretch +\def\baselinestretch{1} +\ifCLASSOPTIONdraftcls + \def\baselinestretch{1.5}% default baselinestretch for draft modes +\fi + + +% process CLASSINPUT baselinestretch +\ifx\CLASSINPUTbaselinestretch\@IEEEundefined +\else + \edef\baselinestretch{\CLASSINPUTbaselinestretch} % user CLASSINPUT override + \typeout{** ATTENTION: Overriding \string\baselinestretch\space to + \baselinestretch\space via \string\CLASSINPUT.} +\fi + +\normalsize % make \baselinestretch take affect + + + + +% store the normalsize baselineskip +\newdimen\CLASSINFOnormalsizebaselineskip +\CLASSINFOnormalsizebaselineskip=\baselineskip\relax +% and the normalsize unity (baselinestretch=1) baselineskip +% we could save a register by giving the user access to +% \@IEEEnormalsizeunitybaselineskip. However, let's protect +% its read only internal status +\newdimen\CLASSINFOnormalsizeunitybaselineskip +\CLASSINFOnormalsizeunitybaselineskip=\@IEEEnormalsizeunitybaselineskip\relax +% store the nominal value of jot +\newdimen\IEEEnormaljot +\IEEEnormaljot=0.25\baselineskip\relax + +% set \jot +\jot=\IEEEnormaljot\relax + + + + +% V1.6, we are now going to fine tune the interword spacing +% The default interword glue for Times under TeX appears to use a +% nominal interword spacing of 25% (relative to the font size, i.e., 1em) +% a maximum of 40% and a minimum of 19%. +% For example, 10pt text uses an interword glue of: +% +% 2.5pt plus 1.49998pt minus 0.59998pt +% +% However, IEEE allows for a more generous range which reduces the need +% for hyphenation, especially for two column text. Furthermore, IEEE +% tends to use a little bit more nominal space between the words. +% IEEE's interword spacing percentages appear to be: +% 35% nominal +% 23% minimum +% 50% maximum +% (They may even be using a tad more for the largest fonts such as 24pt.) +% +% for bold text, IEEE increases the spacing a little more: +% 37.5% nominal +% 23% minimum +% 55% maximum + +% here are the interword spacing ratios we'll use +% for medium (normal weight) +\def\@IEEEinterspaceratioM{0.35} +\def\@IEEEinterspaceMINratioM{0.23} +\def\@IEEEinterspaceMAXratioM{0.50} + +% for bold +\def\@IEEEinterspaceratioB{0.375} +\def\@IEEEinterspaceMINratioB{0.23} +\def\@IEEEinterspaceMAXratioB{0.55} + + +% command to revise the interword spacing for the current font under TeX: +% \fontdimen2 = nominal interword space +% \fontdimen3 = interword stretch +% \fontdimen4 = interword shrink +% since all changes to the \fontdimen are global, we can enclose these commands +% in braces to confine any font attribute or length changes +\def\@@@IEEEsetfontdimens#1#2#3{{% +\setlength{\@IEEEtrantmpdimenB}{\f@size pt}% grab the font size in pt, could use 1em instead. +\setlength{\@IEEEtrantmpdimenA}{#1\@IEEEtrantmpdimenB}% +\fontdimen2\font=\@IEEEtrantmpdimenA\relax +\addtolength{\@IEEEtrantmpdimenA}{-#2\@IEEEtrantmpdimenB}% +\fontdimen3\font=-\@IEEEtrantmpdimenA\relax +\setlength{\@IEEEtrantmpdimenA}{#1\@IEEEtrantmpdimenB}% +\addtolength{\@IEEEtrantmpdimenA}{-#3\@IEEEtrantmpdimenB}% +\fontdimen4\font=\@IEEEtrantmpdimenA\relax}} + +% revise the interword spacing for each font weight +\def\@@IEEEsetfontdimens{{% +\mdseries +\@@@IEEEsetfontdimens{\@IEEEinterspaceratioM}{\@IEEEinterspaceMAXratioM}{\@IEEEinterspaceMINratioM}% +\bfseries +\@@@IEEEsetfontdimens{\@IEEEinterspaceratioB}{\@IEEEinterspaceMAXratioB}{\@IEEEinterspaceMINratioB}% +}} + +% revise the interword spacing for each font shape +% \slshape is not often used for IEEE work and is not altered here. The \scshape caps are +% already a tad too large in the free LaTeX fonts (as compared to what IEEE uses) so we +% won't alter these either. +\def\@IEEEsetfontdimens{{% +\normalfont +\@@IEEEsetfontdimens +\normalfont\itshape +\@@IEEEsetfontdimens +}} + +% command to revise the interword spacing for each font size (and shape +% and weight). Only the \rmfamily is done here as \ttfamily uses a +% fixed spacing and \sffamily is not used as the main text of IEEE papers. +\def\@IEEEtunefonts{{\selectfont\rmfamily +\tiny\@IEEEsetfontdimens +\scriptsize\@IEEEsetfontdimens +\footnotesize\@IEEEsetfontdimens +\small\@IEEEsetfontdimens +\normalsize\@IEEEsetfontdimens +\sublargesize\@IEEEsetfontdimens +\large\@IEEEsetfontdimens +\LARGE\@IEEEsetfontdimens +\huge\@IEEEsetfontdimens +\Huge\@IEEEsetfontdimens}} + +% if the nofonttune class option is not given, revise the interword spacing +% now - in case IEEEtran makes any default length measurements, and make +% sure all the default fonts are loaded +\ifCLASSOPTIONnofonttune\else +\@IEEEtunefonts +\fi + +% and again at the start of the document in case the user loaded different fonts +\AtBeginDocument{\ifCLASSOPTIONnofonttune\else\@IEEEtunefonts\fi} + + + +% V1.6 +% LaTeX is a little to quick to use hyphenations +% So, we increase the penalty for their use and raise +% the badness level that triggers an underfull hbox +% warning. The author may still have to tweak things, +% but the appearance will be much better "right out +% of the box" than that under V1.5 and prior. +% TeX default is 50 +\hyphenpenalty=750 +% If we didn't adjust the interword spacing, 2200 might be better. +% The TeX default is 1000 +\hbadness=1350 +% IEEE does not use extra spacing after punctuation +\frenchspacing + +% V1.7 increase this a tad to discourage equation breaks +\binoppenalty=1000 % default 700 +\relpenalty=800 % default 500 + + +% margin note stuff +\marginparsep 10pt +\marginparwidth 20pt +\marginparpush 25pt + + +% if things get too close, go ahead and let them touch +\lineskip 0pt +\normallineskip 0pt +\lineskiplimit 0pt +\normallineskiplimit 0pt + +% The distance from the lower edge of the text body to the +% footline +\footskip 0.4in + +% normally zero, should be relative to font height. +% put in a little rubber to help stop some bad breaks (underfull vboxes) +\parskip 0ex plus 0.2ex minus 0.1ex +\ifCLASSOPTIONconference +\parskip 6pt plus 2pt minus 1pt +\fi + +\parindent 1.0em +\ifCLASSOPTIONconference +\parindent 14.45pt +\fi + +\topmargin -49.0pt +\headheight 12pt +\headsep 0.25in + +% use the normal font baselineskip +% so that \topskip is unaffected by changes in \baselinestretch +\topskip=\@IEEEnormalsizeunitybaselineskip +\textheight 58pc % 9.63in, 696pt +% Tweak textheight to a perfect integer number of lines/page. +% The normal baselineskip for each document point size is used +% to determine these values. +\ifx\CLASSOPTIONpt\@IEEEptsizenine\textheight=63\@IEEEnormalsizeunitybaselineskip\fi % 63 lines/page +\ifx\CLASSOPTIONpt\@IEEEptsizeten\textheight=58\@IEEEnormalsizeunitybaselineskip\fi % 58 lines/page +\ifx\CLASSOPTIONpt\@IEEEptsizeeleven\textheight=52\@IEEEnormalsizeunitybaselineskip\fi % 52 lines/page +\ifx\CLASSOPTIONpt\@IEEEptsizetwelve\textheight=50\@IEEEnormalsizeunitybaselineskip\fi % 50 lines/page + + +\columnsep 1.5pc +\textwidth 184.2mm + + +% the default side margins are equal +\if@IEEEusingAfourpaper +\oddsidemargin 14.32mm +\evensidemargin 14.32mm +\else +\oddsidemargin 0.680in +\evensidemargin 0.680in +\fi +% compensate for LaTeX's 1in offset +\addtolength{\oddsidemargin}{-1in} +\addtolength{\evensidemargin}{-1in} + + + +% adjust margins for conference mode +\ifCLASSOPTIONconference + \topmargin -0.25in + % we retain the reserved, but unused space for headers + \addtolength{\topmargin}{-\headheight} + \addtolength{\topmargin}{-\headsep} + \textheight 9.25in % The standard for conferences (668.4975pt) + % Tweak textheight to a perfect integer number of lines/page. + \ifx\CLASSOPTIONpt\@IEEEptsizenine\textheight=61\@IEEEnormalsizeunitybaselineskip\fi % 61 lines/page + \ifx\CLASSOPTIONpt\@IEEEptsizeten\textheight=62\@IEEEnormalsizeunitybaselineskip\fi % 62 lines/page + \ifx\CLASSOPTIONpt\@IEEEptsizeeleven\textheight=50\@IEEEnormalsizeunitybaselineskip\fi % 50 lines/page + \ifx\CLASSOPTIONpt\@IEEEptsizetwelve\textheight=48\@IEEEnormalsizeunitybaselineskip\fi % 48 lines/page +\fi + + +% compsoc conference +\ifCLASSOPTIONcompsoc +\ifCLASSOPTIONconference + % compsoc conference use a larger value for columnsep + \columnsep 0.375in + % compsoc conferences want 1in top margin, 1.125in bottom margin + \topmargin 0in + \addtolength{\topmargin}{-6pt}% we tweak this a tad to better comply with top of line stuff + % we retain the reserved, but unused space for headers + \addtolength{\topmargin}{-\headheight} + \addtolength{\topmargin}{-\headsep} + \textheight 8.875in % (641.39625pt) + % Tweak textheight to a perfect integer number of lines/page. + \ifx\CLASSOPTIONpt\@IEEEptsizenine\textheight=58\@IEEEnormalsizeunitybaselineskip\fi % 58 lines/page + \ifx\CLASSOPTIONpt\@IEEEptsizeten\textheight=53\@IEEEnormalsizeunitybaselineskip\fi % 53 lines/page + \ifx\CLASSOPTIONpt\@IEEEptsizeeleven\textheight=48\@IEEEnormalsizeunitybaselineskip\fi % 48 lines/page + \ifx\CLASSOPTIONpt\@IEEEptsizetwelve\textheight=46\@IEEEnormalsizeunitybaselineskip\fi % 46 lines/page + \textwidth 6.5in + % the default side margins are equal + \if@IEEEusingAfourpaper + \oddsidemargin 22.45mm + \evensidemargin 22.45mm + \else + \oddsidemargin 1in + \evensidemargin 1in + \fi + % compensate for LaTeX's 1in offset + \addtolength{\oddsidemargin}{-1in} + \addtolength{\evensidemargin}{-1in} +\fi\fi + + + +% draft mode settings override that of all other modes +% provides a nice 1in margin all around the paper and extra +% space between the lines for editor's comments +\ifCLASSOPTIONdraftcls + % want 1in from top of paper to text + \setlength{\topmargin}{-\headsep}% + \addtolength{\topmargin}{-\headheight}% + % we want 1in side margins regardless of paper type + \oddsidemargin 0in + \evensidemargin 0in + % set the text width + \setlength{\textwidth}{\paperwidth}% + \addtolength{\textwidth}{-2.0in}% + \setlength{\textheight}{\paperheight}% + \addtolength{\textheight}{-2.0in}% + % digitize textheight to be an integer number of lines. + % this may cause the bottom margin to be off a tad + \addtolength{\textheight}{-1\topskip}% + \divide\textheight by \baselineskip% + \multiply\textheight by \baselineskip% + \addtolength{\textheight}{\topskip}% +\fi + + + +% process CLASSINPUT inner/outer margin +% if inner margin defined, but outer margin not, set outer to inner. +\ifx\CLASSINPUTinnersidemargin\@IEEEundefined +\else + \ifx\CLASSINPUToutersidemargin\@IEEEundefined + \edef\CLASSINPUToutersidemargin{\CLASSINPUTinnersidemargin} + \fi +\fi + +\ifx\CLASSINPUToutersidemargin\@IEEEundefined +\else + % if outer margin defined, but inner margin not, set inner to outer. + \ifx\CLASSINPUTinnersidemargin\@IEEEundefined + \edef\CLASSINPUTinnersidemargin{\CLASSINPUToutersidemargin} + \fi + \setlength{\oddsidemargin}{\CLASSINPUTinnersidemargin} + \ifCLASSOPTIONtwoside + \setlength{\evensidemargin}{\CLASSINPUToutersidemargin} + \else + \setlength{\evensidemargin}{\CLASSINPUTinnersidemargin} + \fi + \addtolength{\oddsidemargin}{-1in} + \addtolength{\evensidemargin}{-1in} + \setlength{\textwidth}{\paperwidth} + \addtolength{\textwidth}{-\CLASSINPUTinnersidemargin} + \addtolength{\textwidth}{-\CLASSINPUToutersidemargin} + \typeout{** ATTENTION: Overriding inner side margin to \CLASSINPUTinnersidemargin\space and + outer side margin to \CLASSINPUToutersidemargin\space via \string\CLASSINPUT.} +\fi + + + +% process CLASSINPUT top/bottom text margin +% if toptext margin defined, but bottomtext margin not, set bottomtext to toptext margin +\ifx\CLASSINPUTtoptextmargin\@IEEEundefined +\else + \ifx\CLASSINPUTbottomtextmargin\@IEEEundefined + \edef\CLASSINPUTbottomtextmargin{\CLASSINPUTtoptextmargin} + \fi +\fi + +\ifx\CLASSINPUTbottomtextmargin\@IEEEundefined +\else + % if bottomtext margin defined, but toptext margin not, set toptext to bottomtext margin + \ifx\CLASSINPUTtoptextmargin\@IEEEundefined + \edef\CLASSINPUTtoptextmargin{\CLASSINPUTbottomtextmargin} + \fi + \setlength{\topmargin}{\CLASSINPUTtoptextmargin} + \addtolength{\topmargin}{-1in} + \addtolength{\topmargin}{-\headheight} + \addtolength{\topmargin}{-\headsep} + \setlength{\textheight}{\paperheight} + \addtolength{\textheight}{-\CLASSINPUTtoptextmargin} + \addtolength{\textheight}{-\CLASSINPUTbottomtextmargin} + % in the default format we use the normal baselineskip as topskip + % we only need 0.7 of this to clear typical top text and we need + % an extra 0.3 spacing at the bottom for descenders. This will + % correct for both. + \addtolength{\topmargin}{-0.3\@IEEEnormalsizeunitybaselineskip} + \typeout{** ATTENTION: Overriding top text margin to \CLASSINPUTtoptextmargin\space and + bottom text margin to \CLASSINPUTbottomtextmargin\space via \string\CLASSINPUT.} +\fi + + + + + + + +% LIST SPACING CONTROLS + +% Controls the amount of EXTRA spacing +% above and below \trivlist +% Both \list and IED lists override this. +% However, \trivlist will use this as will most +% things built from \trivlist like the \center +% environment. +\topsep 0.5\baselineskip + +% Controls the additional spacing around lists preceded +% or followed by blank lines. IEEE does not increase +% spacing before or after paragraphs so it is set to zero. +% \z@ is the same as zero, but faster. +\partopsep \z@ + +% Controls the spacing between paragraphs in lists. +% IEEE does not increase spacing before or after paragraphs +% so this is also zero. +% With IEEEtran.cls, global changes to +% this value DO affect lists (but not IED lists). +\parsep \z@ + +% Controls the extra spacing between list items. +% IEEE does not put extra spacing between items. +% With IEEEtran.cls, global changes to this value DO affect +% lists (but not IED lists). +\itemsep \z@ + +% \itemindent is the amount to indent the FIRST line of a list +% item. It is auto set to zero within the \list environment. To alter +% it, you have to do so when you call the \list. +% However, IEEE uses this for the theorem environment +% There is an alternative value for this near \leftmargini below +\itemindent -1em + +% \leftmargin, the spacing from the left margin of the main text to +% the left of the main body of a list item is set by \list. +% Hence this statement does nothing for lists. +% But, quote and verse do use it for indention. +\leftmargin 2em + +% we retain this stuff from the older IEEEtran.cls so that \list +% will work the same way as before. However, itemize, enumerate and +% description (IED) could care less about what these are as they +% all are overridden. +\leftmargini 2em +%\itemindent 2em % Alternative values: sometimes used. +%\leftmargini 0em +\leftmarginii 1em +\leftmarginiii 1.5em +\leftmarginiv 1.5em +\leftmarginv 1.0em +\leftmarginvi 1.0em +\labelsep 0.5em +\labelwidth \z@ + + +% The old IEEEtran.cls behavior of \list is retained. +% However, the new V1.3 IED list environments override all the +% @list stuff (\@listX is called within \list for the +% appropriate level just before the user's list_decl is called). +% \topsep is now 2pt as IEEE puts a little extra space around +% lists - used by those non-IED macros that depend on \list. +% Note that \parsep and \itemsep are not redefined as in +% the sizexx.clo \@listX (which article.cls uses) so global changes +% of these values DO affect \list +% +\def\@listi{\leftmargin\leftmargini \topsep 2pt plus 1pt minus 1pt} +\let\@listI\@listi +\def\@listii{\leftmargin\leftmarginii\labelwidth\leftmarginii% + \advance\labelwidth-\labelsep \topsep 2pt} +\def\@listiii{\leftmargin\leftmarginiii\labelwidth\leftmarginiii% + \advance\labelwidth-\labelsep \topsep 2pt} +\def\@listiv{\leftmargin\leftmarginiv\labelwidth\leftmarginiv% + \advance\labelwidth-\labelsep \topsep 2pt} +\def\@listv{\leftmargin\leftmarginv\labelwidth\leftmarginv% + \advance\labelwidth-\labelsep \topsep 2pt} +\def\@listvi{\leftmargin\leftmarginvi\labelwidth\leftmarginvi% + \advance\labelwidth-\labelsep \topsep 2pt} + + +% IEEE uses 5) not 5. +\def\labelenumi{\theenumi)} \def\theenumi{\arabic{enumi}} + +% IEEE uses a) not (a) +\def\labelenumii{\theenumii)} \def\theenumii{\alph{enumii}} + +% IEEE uses iii) not iii. +\def\labelenumiii{\theenumiii)} \def\theenumiii{\roman{enumiii}} + +% IEEE uses A) not A. +\def\labelenumiv{\theenumiv)} \def\theenumiv{\Alph{enumiv}} + +% exactly the same as in article.cls +\def\p@enumii{\theenumi} +\def\p@enumiii{\theenumi(\theenumii)} +\def\p@enumiv{\p@enumiii\theenumiii} + +% itemized list label styles +\def\labelitemi{$\bullet$} +\def\labelitemii{$\circ$} +\def\labelitemiii{\vrule height 0.8ex depth -0.2ex width 0.6ex} +\def\labelitemiv{$\ast$} + + + +% **** V1.3 ENHANCEMENTS **** +% Itemize, Enumerate and Description (IED) List Controls +% *************************** +% +% +% IEEE seems to use at least two different values by +% which ITEMIZED list labels are indented to the right +% For The Journal of Lightwave Technology (JLT) and The Journal +% on Selected Areas in Communications (JSAC), they tend to use +% an indention equal to \parindent. For Transactions on Communications +% they tend to indent ITEMIZED lists a little more--- 1.3\parindent. +% We'll provide both values here for you so that you can choose +% which one you like in your document using a command such as: +% setlength{\IEEEilabelindent}{\IEEEilabelindentB} +\newdimen\IEEEilabelindentA +\IEEEilabelindentA \parindent + +\newdimen\IEEEilabelindentB +\IEEEilabelindentB 1.3\parindent +% However, we'll default to using \parindent +% which makes more sense to me +\newdimen\IEEEilabelindent +\IEEEilabelindent \IEEEilabelindentA + + +% This controls the default amount the enumerated list labels +% are indented to the right. +% Normally, this is the same as the paragraph indention +\newdimen\IEEEelabelindent +\IEEEelabelindent \parindent + +% This controls the default amount the description list labels +% are indented to the right. +% Normally, this is the same as the paragraph indention +\newdimen\IEEEdlabelindent +\IEEEdlabelindent \parindent + +% This is the value actually used within the IED lists. +% The IED environments automatically set its value to +% one of the three values above, so global changes do +% not have any effect +\newdimen\IEEElabelindent +\IEEElabelindent \parindent + +% The actual amount labels will be indented is +% \IEEElabelindent multiplied by the factor below +% corresponding to the level of nesting depth +% This provides a means by which the user can +% alter the effective \IEEElabelindent for deeper +% levels +% There may not be such a thing as correct "standard IEEE" +% values. What IEEE actually does may depend on the specific +% circumstances. +% The first list level almost always has full indention. +% The second levels I've seen have only 75% of the normal indentation +% Three level or greater nestings are very rare. I am guessing +% that they don't use any indentation. +\def\IEEElabelindentfactori{1.0} % almost always one +\def\IEEElabelindentfactorii{0.75} % 0.0 or 1.0 may be used in some cases +\def\IEEElabelindentfactoriii{0.0} % 0.75? 0.5? 0.0? +\def\IEEElabelindentfactoriv{0.0} +\def\IEEElabelindentfactorv{0.0} +\def\IEEElabelindentfactorvi{0.0} + +% value actually used within IED lists, it is auto +% set to one of the 6 values above +% global changes here have no effect +\def\IEEElabelindentfactor{1.0} + +% This controls the default spacing between the end of the IED +% list labels and the list text, when normal text is used for +% the labels. +\newdimen\IEEEiednormlabelsep +\IEEEiednormlabelsep \parindent + +% This controls the default spacing between the end of the IED +% list labels and the list text, when math symbols are used for +% the labels (nomenclature lists). IEEE usually increases the +% spacing in these cases +\newdimen\IEEEiedmathlabelsep +\IEEEiedmathlabelsep 1.2em + +% This controls the extra vertical separation put above and +% below each IED list. IEEE usually puts a little extra spacing +% around each list. However, this spacing is barely noticeable. +\newskip\IEEEiedtopsep +\IEEEiedtopsep 2pt plus 1pt minus 1pt + + +% This command is executed within each IED list environment +% at the beginning of the list. You can use this to set the +% parameters for some/all your IED list(s) without disturbing +% global parameters that affect things other than lists. +% i.e., renewcommand{\IEEEiedlistdecl}{\setlength{\labelsep}{5em}} +% will alter the \labelsep for the next list(s) until +% \IEEEiedlistdecl is redefined. +\def\IEEEiedlistdecl{\relax} + +% This command provides an easy way to set \leftmargin based +% on the \labelwidth, \labelsep and the argument \IEEElabelindent +% Usage: \IEEEcalcleftmargin{width-to-indent-the-label} +% output is in the \leftmargin variable, i.e., effectively: +% \leftmargin = argument + \labelwidth + \labelsep +% Note controlled spacing here, shield end of lines with % +\def\IEEEcalcleftmargin#1{\setlength{\leftmargin}{#1}% +\addtolength{\leftmargin}{\labelwidth}% +\addtolength{\leftmargin}{\labelsep}} + +% This command provides an easy way to set \labelwidth to the +% width of the given text. It is the same as +% \settowidth{\labelwidth}{label-text} +% and useful as a shorter alternative. +% Typically used to set \labelwidth to be the width +% of the longest label in the list +\def\IEEEsetlabelwidth#1{\settowidth{\labelwidth}{#1}} + +% When this command is executed, IED lists will use the +% IEEEiedmathlabelsep label separation rather than the normal +% spacing. To have an effect, this command must be executed via +% the \IEEEiedlistdecl or within the option of the IED list +% environments. +\def\IEEEusemathlabelsep{\setlength{\labelsep}{\IEEEiedmathlabelsep}} + +% A flag which controls whether the IED lists automatically +% calculate \leftmargin from \IEEElabelindent, \labelwidth and \labelsep +% Useful if you want to specify your own \leftmargin +% This flag must be set (\IEEEnocalcleftmargintrue or \IEEEnocalcleftmarginfalse) +% via the \IEEEiedlistdecl or within the option of the IED list +% environments to have an effect. +\newif\ifIEEEnocalcleftmargin +\IEEEnocalcleftmarginfalse + +% A flag which controls whether \IEEElabelindent is multiplied by +% the \IEEElabelindentfactor for each list level. +% This flag must be set via the \IEEEiedlistdecl or within the option +% of the IED list environments to have an effect. +\newif\ifIEEEnolabelindentfactor +\IEEEnolabelindentfactorfalse + + +% internal variable to indicate type of IED label +% justification +% 0 - left; 1 - center; 2 - right +\def\@IEEEiedjustify{0} + + +% commands to allow the user to control IED +% label justifications. Use these commands within +% the IED environment option or in the \IEEEiedlistdecl +% Note that changing the normal list justifications +% is nonstandard and IEEE may not like it if you do so! +% I include these commands as they may be helpful to +% those who are using these enhanced list controls for +% other non-IEEE related LaTeX work. +% itemize and enumerate automatically default to right +% justification, description defaults to left. +\def\IEEEiedlabeljustifyl{\def\@IEEEiedjustify{0}}%left +\def\IEEEiedlabeljustifyc{\def\@IEEEiedjustify{1}}%center +\def\IEEEiedlabeljustifyr{\def\@IEEEiedjustify{2}}%right + + + + +% commands to save to and restore from the list parameter copies +% this allows us to set all the list parameters within +% the list_decl and prevent \list (and its \@list) +% from overriding any of our parameters +% V1.6 use \edefs instead of dimen's to conserve dimen registers +% Note controlled spacing here, shield end of lines with % +\def\@IEEEsavelistparams{\edef\@IEEEiedtopsep{\the\topsep}% +\edef\@IEEEiedlabelwidth{\the\labelwidth}% +\edef\@IEEEiedlabelsep{\the\labelsep}% +\edef\@IEEEiedleftmargin{\the\leftmargin}% +\edef\@IEEEiedpartopsep{\the\partopsep}% +\edef\@IEEEiedparsep{\the\parsep}% +\edef\@IEEEieditemsep{\the\itemsep}% +\edef\@IEEEiedrightmargin{\the\rightmargin}% +\edef\@IEEEiedlistparindent{\the\listparindent}% +\edef\@IEEEieditemindent{\the\itemindent}} + +% Note controlled spacing here +\def\@IEEErestorelistparams{\topsep\@IEEEiedtopsep\relax% +\labelwidth\@IEEEiedlabelwidth\relax% +\labelsep\@IEEEiedlabelsep\relax% +\leftmargin\@IEEEiedleftmargin\relax% +\partopsep\@IEEEiedpartopsep\relax% +\parsep\@IEEEiedparsep\relax% +\itemsep\@IEEEieditemsep\relax% +\rightmargin\@IEEEiedrightmargin\relax% +\listparindent\@IEEEiedlistparindent\relax% +\itemindent\@IEEEieditemindent\relax} + + +% v1.6b provide original LaTeX IED list environments +% note that latex.ltx defines \itemize and \enumerate, but not \description +% which must be created by the base classes +% save original LaTeX itemize and enumerate +\let\LaTeXitemize\itemize +\let\endLaTeXitemize\enditemize +\let\LaTeXenumerate\enumerate +\let\endLaTeXenumerate\endenumerate + +% provide original LaTeX description environment from article.cls +\newenvironment{LaTeXdescription} + {\list{}{\labelwidth\z@ \itemindent-\leftmargin + \let\makelabel\descriptionlabel}} + {\endlist} +\newcommand*\descriptionlabel[1]{\hspace\labelsep + \normalfont\bfseries #1} + + +% override LaTeX's default IED lists +\def\itemize{\@IEEEitemize} +\def\enditemize{\@endIEEEitemize} +\def\enumerate{\@IEEEenumerate} +\def\endenumerate{\@endIEEEenumerate} +\def\description{\@IEEEdescription} +\def\enddescription{\@endIEEEdescription} + +% provide the user with aliases - may help those using packages that +% override itemize, enumerate, or description +\def\IEEEitemize{\@IEEEitemize} +\def\endIEEEitemize{\@endIEEEitemize} +\def\IEEEenumerate{\@IEEEenumerate} +\def\endIEEEenumerate{\@endIEEEenumerate} +\def\IEEEdescription{\@IEEEdescription} +\def\endIEEEdescription{\@endIEEEdescription} + + +% V1.6 we want to keep the IEEEtran IED list definitions as our own internal +% commands so they are protected against redefinition +\def\@IEEEitemize{\@ifnextchar[{\@@IEEEitemize}{\@@IEEEitemize[\relax]}} +\def\@IEEEenumerate{\@ifnextchar[{\@@IEEEenumerate}{\@@IEEEenumerate[\relax]}} +\def\@IEEEdescription{\@ifnextchar[{\@@IEEEdescription}{\@@IEEEdescription[\relax]}} +\def\@endIEEEitemize{\endlist} +\def\@endIEEEenumerate{\endlist} +\def\@endIEEEdescription{\endlist} + + +% DO NOT ALLOW BLANK LINES TO BE IN THESE IED ENVIRONMENTS +% AS THIS WILL FORCE NEW PARAGRAPHS AFTER THE IED LISTS +% IEEEtran itemized list MDS 1/2001 +% Note controlled spacing here, shield end of lines with % +\def\@@IEEEitemize[#1]{% + \ifnum\@itemdepth>3\relax\@toodeep\else% + \ifnum\@listdepth>5\relax\@toodeep\else% + \advance\@itemdepth\@ne% + \edef\@itemitem{labelitem\romannumeral\the\@itemdepth}% + % get the labelindentfactor for this level + \advance\@listdepth\@ne% we need to know what the level WILL be + \edef\IEEElabelindentfactor{\csname IEEElabelindentfactor\romannumeral\the\@listdepth\endcsname}% + \advance\@listdepth-\@ne% undo our increment + \def\@IEEEiedjustify{2}% right justified labels are default + % set other defaults + \IEEEnocalcleftmarginfalse% + \IEEEnolabelindentfactorfalse% + \topsep\IEEEiedtopsep% + \IEEElabelindent\IEEEilabelindent% + \labelsep\IEEEiednormlabelsep% + \partopsep 0ex% + \parsep 0ex% + \itemsep \parskip% + \rightmargin 0em% + \listparindent 0em% + \itemindent 0em% + % calculate the label width + % the user can override this later if + % they specified a \labelwidth + \settowidth{\labelwidth}{\csname labelitem\romannumeral\the\@itemdepth\endcsname}% + \@IEEEsavelistparams% save our list parameters + \list{\csname\@itemitem\endcsname}{% + \@IEEErestorelistparams% override any list{} changes + % to our globals + \let\makelabel\@IEEEiedmakelabel% v1.6b setup \makelabel + \IEEEiedlistdecl% let user alter parameters + #1\relax% + % If the user has requested not to use the + % labelindent factor, don't revise \labelindent + \ifIEEEnolabelindentfactor\relax% + \else\IEEElabelindent=\IEEElabelindentfactor\labelindent% + \fi% + % Unless the user has requested otherwise, + % calculate our left margin based + % on \IEEElabelindent, \labelwidth and + % \labelsep + \ifIEEEnocalcleftmargin\relax% + \else\IEEEcalcleftmargin{\IEEElabelindent}% + \fi}\fi\fi}% + + +% DO NOT ALLOW BLANK LINES TO BE IN THESE IED ENVIRONMENTS +% AS THIS WILL FORCE NEW PARAGRAPHS AFTER THE IED LISTS +% IEEEtran enumerate list MDS 1/2001 +% Note controlled spacing here, shield end of lines with % +\def\@@IEEEenumerate[#1]{% + \ifnum\@enumdepth>3\relax\@toodeep\else% + \ifnum\@listdepth>5\relax\@toodeep\else% + \advance\@enumdepth\@ne% + \edef\@enumctr{enum\romannumeral\the\@enumdepth}% + % get the labelindentfactor for this level + \advance\@listdepth\@ne% we need to know what the level WILL be + \edef\IEEElabelindentfactor{\csname IEEElabelindentfactor\romannumeral\the\@listdepth\endcsname}% + \advance\@listdepth-\@ne% undo our increment + \def\@IEEEiedjustify{2}% right justified labels are default + % set other defaults + \IEEEnocalcleftmarginfalse% + \IEEEnolabelindentfactorfalse% + \topsep\IEEEiedtopsep% + \IEEElabelindent\IEEEelabelindent% + \labelsep\IEEEiednormlabelsep% + \partopsep 0ex% + \parsep 0ex% + \itemsep 0ex% + \rightmargin 0em% + \listparindent 0em% + \itemindent 0em% + % calculate the label width + % We'll set it to the width suitable for all labels using + % normalfont 1) to 9) + % The user can override this later + \settowidth{\labelwidth}{9)}% + \@IEEEsavelistparams% save our list parameters + \list{\csname label\@enumctr\endcsname}{\usecounter{\@enumctr}% + \@IEEErestorelistparams% override any list{} changes + % to our globals + \let\makelabel\@IEEEiedmakelabel% v1.6b setup \makelabel + \IEEEiedlistdecl% let user alter parameters + #1\relax% + % If the user has requested not to use the + % IEEElabelindent factor, don't revise \IEEElabelindent + \ifIEEEnolabelindentfactor\relax% + \else\IEEElabelindent=\IEEElabelindentfactor\IEEElabelindent% + \fi% + % Unless the user has requested otherwise, + % calculate our left margin based + % on \IEEElabelindent, \labelwidth and + % \labelsep + \ifIEEEnocalcleftmargin\relax% + \else\IEEEcalcleftmargin{\IEEElabelindent}% + \fi}\fi\fi}% + + +% DO NOT ALLOW BLANK LINES TO BE IN THESE IED ENVIRONMENTS +% AS THIS WILL FORCE NEW PARAGRAPHS AFTER THE IED LISTS +% IEEEtran description list MDS 1/2001 +% Note controlled spacing here, shield end of lines with % +\def\@@IEEEdescription[#1]{% + \ifnum\@listdepth>5\relax\@toodeep\else% + % get the labelindentfactor for this level + \advance\@listdepth\@ne% we need to know what the level WILL be + \edef\IEEElabelindentfactor{\csname IEEElabelindentfactor\romannumeral\the\@listdepth\endcsname}% + \advance\@listdepth-\@ne% undo our increment + \def\@IEEEiedjustify{0}% left justified labels are default + % set other defaults + \IEEEnocalcleftmarginfalse% + \IEEEnolabelindentfactorfalse% + \topsep\IEEEiedtopsep% + \IEEElabelindent\IEEEdlabelindent% + % assume normal labelsep + \labelsep\IEEEiednormlabelsep% + \partopsep 0ex% + \parsep 0ex% + \itemsep 0ex% + \rightmargin 0em% + \listparindent 0em% + \itemindent 0em% + % Bogus label width in case the user forgets + % to set it. + % TIP: If you want to see what a variable's width is you + % can use the TeX command \showthe\width-variable to + % display it on the screen during compilation + % (This might be helpful to know when you need to find out + % which label is the widest) + \settowidth{\labelwidth}{Hello}% + \@IEEEsavelistparams% save our list parameters + \list{}{\@IEEErestorelistparams% override any list{} changes + % to our globals + \let\makelabel\@IEEEiedmakelabel% v1.6b setup \makelabel + \IEEEiedlistdecl% let user alter parameters + #1\relax% + % If the user has requested not to use the + % labelindent factor, don't revise \IEEElabelindent + \ifIEEEnolabelindentfactor\relax% + \else\IEEElabelindent=\IEEElabelindentfactor\IEEElabelindent% + \fi% + % Unless the user has requested otherwise, + % calculate our left margin based + % on \IEEElabelindent, \labelwidth and + % \labelsep + \ifIEEEnocalcleftmargin\relax% + \else\IEEEcalcleftmargin{\IEEElabelindent}\relax% + \fi}\fi} + +% v1.6b we use one makelabel that does justification as needed. +\def\@IEEEiedmakelabel#1{\relax\if\@IEEEiedjustify 0\relax +\makebox[\labelwidth][l]{\normalfont #1}\else +\if\@IEEEiedjustify 1\relax +\makebox[\labelwidth][c]{\normalfont #1}\else +\makebox[\labelwidth][r]{\normalfont #1}\fi\fi} + + +% VERSE and QUOTE +% V1.7 define environments with newenvironment +\newenvironment{verse}{\let\\=\@centercr + \list{}{\itemsep\z@ \itemindent -1.5em \listparindent \itemindent + \rightmargin\leftmargin\advance\leftmargin 1.5em}\item\relax} + {\endlist} +\newenvironment{quotation}{\list{}{\listparindent 1.5em \itemindent\listparindent + \rightmargin\leftmargin \parsep 0pt plus 1pt}\item\relax} + {\endlist} +\newenvironment{quote}{\list{}{\rightmargin\leftmargin}\item\relax} + {\endlist} + + +% \titlepage +% provided only for backward compatibility. \maketitle is the correct +% way to create the title page. +\newif\if@restonecol +\def\titlepage{\@restonecolfalse\if@twocolumn\@restonecoltrue\onecolumn + \else \newpage \fi \thispagestyle{empty}\c@page\z@} +\def\endtitlepage{\if@restonecol\twocolumn \else \newpage \fi} + +% standard values from article.cls +\arraycolsep 5pt +\arrayrulewidth .4pt +\doublerulesep 2pt + +\tabcolsep 6pt +\tabbingsep 0.5em + + +%% FOOTNOTES +% +%\skip\footins 10pt plus 4pt minus 2pt +% V1.6 respond to changes in font size +% space added above the footnotes (if present) +\skip\footins 0.9\baselineskip plus 0.4\baselineskip minus 0.2\baselineskip + +% V1.6, we need to make \footnotesep responsive to changes +% in \baselineskip or strange spacings will result when in +% draft mode. Here is a little LaTeX secret - \footnotesep +% determines the height of an invisible strut that is placed +% *above* the baseline of footnotes after the first. Since +% LaTeX considers the space for characters to be 0.7/baselineskip +% above the baseline and 0.3/baselineskip below it, we need to +% use 0.7/baselineskip as a \footnotesep to maintain equal spacing +% between all the lines of the footnotes. IEEE often uses a tad +% more, so use 0.8\baselineskip. This slightly larger value also helps +% the text to clear the footnote marks. Note that \thanks in IEEEtran +% uses its own value of \footnotesep which is set in \maketitle. +{\footnotesize +\global\footnotesep 0.8\baselineskip} + +\def\unnumberedfootnote{\gdef\@thefnmark{\quad}\@footnotetext} + +\skip\@mpfootins 0.3\baselineskip +\fboxsep = 3pt +\fboxrule = .4pt +% V1.6 use 1em, then use LaTeX2e's \@makefnmark +% Note that IEEE normally *left* aligns the footnote marks, so we don't need +% box resizing tricks here. +%\long\def\@makefnmark{\scriptsize\normalfont\@thefnmark} +\long\def\@makefntext#1{\parindent 1em\indent\hbox{\@makefnmark}#1}% V1.6 use 1em +\long\def\@maketablefntext#1{\raggedleft\leavevmode\hbox{\@makefnmark}#1} +% V1.7 compsoc does not use superscipts for footnote marks +\ifCLASSOPTIONcompsoc +\def\@IEEEcompsocmakefnmark{\hbox{\normalfont\@thefnmark.\ }} +\long\def\@makefntext#1{\parindent 1em\indent\hbox{\@IEEEcompsocmakefnmark}#1} +\fi + +% IEEE does not use footnote rules. Or do they? +\def\footnoterule{\vskip-2pt \hrule height 0.6pt depth \z@ \vskip1.6pt\relax} +\toks@\expandafter{\@setminipage\let\footnoterule\relax\footnotesep\z@} +\edef\@setminipage{\the\toks@} + +% V1.7 for compsoc, IEEE uses a footnote rule only for \thanks. We devise a "one-shot" +% system to implement this. +\newif\if@IEEEenableoneshotfootnoterule +\@IEEEenableoneshotfootnoterulefalse +\ifCLASSOPTIONcompsoc +\def\footnoterule{\relax\if@IEEEenableoneshotfootnoterule +\kern-5pt +\hbox to \columnwidth{\hfill\vrule width 0.5\columnwidth height 0.4pt\hfill} +\kern4.6pt +\global\@IEEEenableoneshotfootnoterulefalse +\else +\relax +\fi} +\fi + +% V1.6 do not allow LaTeX to break a footnote across multiple pages +\interfootnotelinepenalty=10000 + +% V1.6 discourage breaks within equations +% Note that amsmath normally sets this to 10000, +% but LaTeX2e normally uses 100. +\interdisplaylinepenalty=2500 + +% default allows section depth up to /paragraph +\setcounter{secnumdepth}{4} + +% technotes do not allow /paragraph +\ifCLASSOPTIONtechnote + \setcounter{secnumdepth}{3} +\fi +% neither do compsoc conferences +\@IEEEcompsocconfonly{\setcounter{secnumdepth}{3}} + + +\newcounter{section} +\newcounter{subsection}[section] +\newcounter{subsubsection}[subsection] +\newcounter{paragraph}[subsubsection] + +% used only by IEEEtran's IEEEeqnarray as other packages may +% have their own, different, implementations +\newcounter{IEEEsubequation}[equation] + +% as shown when called by user from \ref, \label and in table of contents +\def\theequation{\arabic{equation}} % 1 +\def\theIEEEsubequation{\theequation\alph{IEEEsubequation}} % 1a (used only by IEEEtran's IEEEeqnarray) +\ifCLASSOPTIONcompsoc +% compsoc is all arabic +\def\thesection{\arabic{section}} +\def\thesubsection{\thesection.\arabic{subsection}} +\def\thesubsubsection{\thesubsection.\arabic{subsubsection}} +\def\theparagraph{\thesubsubsection.\arabic{paragraph}} +\else +\def\thesection{\Roman{section}} % I +% V1.7, \mbox prevents breaks around - +\def\thesubsection{\mbox{\thesection-\Alph{subsection}}} % I-A +% V1.7 use I-A1 format used by IEEE rather than I-A.1 +\def\thesubsubsection{\thesubsection\arabic{subsubsection}} % I-A1 +\def\theparagraph{\thesubsubsection\alph{paragraph}} % I-A1a +\fi + +% From Heiko Oberdiek. Because of the \mbox in \thesubsection, we need to +% tell hyperref to disable the \mbox command when making PDF bookmarks. +% This done already with hyperref.sty version 6.74o and later, but +% it will not hurt to do it here again for users of older versions. +\@ifundefined{pdfstringdefPreHook}{\let\pdfstringdefPreHook\@empty}{}% +\g@addto@macro\pdfstringdefPreHook{\let\mbox\relax} + + +% Main text forms (how shown in main text headings) +% V1.6, using \thesection in \thesectiondis allows changes +% in the former to automatically appear in the latter +\ifCLASSOPTIONcompsoc + \ifCLASSOPTIONconference% compsoc conference + \def\thesectiondis{\thesection.} + \def\thesubsectiondis{\thesectiondis\arabic{subsection}.} + \def\thesubsubsectiondis{\thesubsectiondis\arabic{subsubsection}.} + \def\theparagraphdis{\thesubsubsectiondis\arabic{paragraph}.} + \else% compsoc not conferencs + \def\thesectiondis{\thesection} + \def\thesubsectiondis{\thesectiondis.\arabic{subsection}} + \def\thesubsubsectiondis{\thesubsectiondis.\arabic{subsubsection}} + \def\theparagraphdis{\thesubsubsectiondis.\arabic{paragraph}} + \fi +\else% not compsoc + \def\thesectiondis{\thesection.} % I. + \def\thesubsectiondis{\Alph{subsection}.} % B. + \def\thesubsubsectiondis{\arabic{subsubsection})} % 3) + \def\theparagraphdis{\alph{paragraph})} % d) +\fi + +% just like LaTeX2e's \@eqnnum +\def\theequationdis{{\normalfont \normalcolor (\theequation)}}% (1) +% IEEEsubequation used only by IEEEtran's IEEEeqnarray +\def\theIEEEsubequationdis{{\normalfont \normalcolor (\theIEEEsubequation)}}% (1a) +% redirect LaTeX2e's equation number display and all that depend on +% it, through IEEEtran's \theequationdis +\def\@eqnnum{\theequationdis} + + + +% V1.7 provide string macros as article.cls does +\def\contentsname{Contents} +\def\listfigurename{List of Figures} +\def\listtablename{List of Tables} +\def\refname{References} +\def\indexname{Index} +\def\figurename{Fig.} +\def\tablename{TABLE} +\@IEEEcompsocconfonly{\def\figurename{Figure}\def\tablename{Table}} +\def\partname{Part} +\def\appendixname{Appendix} +\def\abstractname{Abstract} +% IEEE specific names +\def\IEEEkeywordsname{Keywords} +\def\IEEEproofname{Proof} + + +% LIST OF FIGURES AND TABLES AND TABLE OF CONTENTS +% +\def\@pnumwidth{1.55em} +\def\@tocrmarg{2.55em} +\def\@dotsep{4.5} +\setcounter{tocdepth}{3} + +% adjusted some spacings here so that section numbers will not easily +% collide with the section titles. +% VIII; VIII-A; and VIII-A.1 are usually the worst offenders. +% MDS 1/2001 +\def\tableofcontents{\section*{\contentsname}\@starttoc{toc}} +\def\l@section#1#2{\addpenalty{\@secpenalty}\addvspace{1.0em plus 1pt}% + \@tempdima 2.75em \begingroup \parindent \z@ \rightskip \@pnumwidth% + \parfillskip-\@pnumwidth {\bfseries\leavevmode #1}\hfil\hbox to\@pnumwidth{\hss #2}\par% + \endgroup} +% argument format #1:level, #2:labelindent,#3:labelsep +\def\l@subsection{\@dottedtocline{2}{2.75em}{3.75em}} +\def\l@subsubsection{\@dottedtocline{3}{6.5em}{4.5em}} +% must provide \l@ defs for ALL sublevels EVEN if tocdepth +% is such as they will not appear in the table of contents +% these defs are how TOC knows what level these things are! +\def\l@paragraph{\@dottedtocline{4}{6.5em}{5.5em}} +\def\l@subparagraph{\@dottedtocline{5}{6.5em}{6.5em}} +\def\listoffigures{\section*{\listfigurename}\@starttoc{lof}} +\def\l@figure{\@dottedtocline{1}{0em}{2.75em}} +\def\listoftables{\section*{\listtablename}\@starttoc{lot}} +\let\l@table\l@figure + + +%% Definitions for floats +%% +%% Normal Floats +\floatsep 1\baselineskip plus 0.2\baselineskip minus 0.2\baselineskip +\textfloatsep 1.7\baselineskip plus 0.2\baselineskip minus 0.4\baselineskip +\@fptop 0pt plus 1fil +\@fpsep 0.75\baselineskip plus 2fil +\@fpbot 0pt plus 1fil +\def\topfraction{0.9} +\def\bottomfraction{0.4} +\def\floatpagefraction{0.8} +% V1.7, let top floats approach 90% of page +\def\textfraction{0.1} + +%% Double Column Floats +\dblfloatsep 1\baselineskip plus 0.2\baselineskip minus 0.2\baselineskip + +\dbltextfloatsep 1.7\baselineskip plus 0.2\baselineskip minus 0.4\baselineskip +% Note that it would be nice if the rubber here actually worked in LaTeX2e. +% There is a long standing limitation in LaTeX, first discovered (to the best +% of my knowledge) by Alan Jeffrey in 1992. LaTeX ignores the stretchable +% portion of \dbltextfloatsep, and as a result, double column figures can and +% do result in an non-integer number of lines in the main text columns with +% underfull vbox errors as a consequence. A post to comp.text.tex +% by Donald Arseneau confirms that this had not yet been fixed in 1998. +% IEEEtran V1.6 will fix this problem for you in the titles, but it doesn't +% protect you from other double floats. Happy vspace'ing. + +\@dblfptop 0pt plus 1fil +\@dblfpsep 0.75\baselineskip plus 2fil +\@dblfpbot 0pt plus 1fil +\def\dbltopfraction{0.8} +\def\dblfloatpagefraction{0.8} +\setcounter{dbltopnumber}{4} + +\intextsep 1\baselineskip plus 0.2\baselineskip minus 0.2\baselineskip +\setcounter{topnumber}{2} +\setcounter{bottomnumber}{2} +\setcounter{totalnumber}{4} + + + +% article class provides these, we should too. +\newlength\abovecaptionskip +\newlength\belowcaptionskip +% but only \abovecaptionskip is used above figure captions and *below* table +% captions +\setlength\abovecaptionskip{0.65\baselineskip} +\setlength\belowcaptionskip{0.75\baselineskip} +% V1.6 create hooks in case the caption spacing ever needs to be +% overridden by a user +\def\@IEEEfigurecaptionsepspace{\vskip\abovecaptionskip\relax}% +\def\@IEEEtablecaptionsepspace{\vskip\belowcaptionskip\relax}% + + +% 1.6b revise caption system so that \@makecaption uses two arguments +% as with LaTeX2e. Otherwise, there will be problems when using hyperref. +\def\@IEEEtablestring{table} + +\ifCLASSOPTIONcompsoc +% V1.7 compsoc \@makecaption +\ifCLASSOPTIONconference% compsoc conference +\long\def\@makecaption#1#2{% +% test if is a for a figure or table +\ifx\@captype\@IEEEtablestring% +% if a table, do table caption +\normalsize\begin{center}{\normalfont\sffamily\normalsize {#1.}~ #2}\end{center}% +\@IEEEtablecaptionsepspace +% if not a table, format it as a figure +\else +\@IEEEfigurecaptionsepspace +\setbox\@tempboxa\hbox{\normalfont\sffamily\normalsize {#1.}~ #2}% +\ifdim \wd\@tempboxa >\hsize% +% if caption is longer than a line, let it wrap around +\setbox\@tempboxa\hbox{\normalfont\sffamily\normalsize {#1.}~ }% +\parbox[t]{\hsize}{\normalfont\sffamily\normalsize \noindent\unhbox\@tempboxa#2}% +% if caption is shorter than a line, center +\else% +\hbox to\hsize{\normalfont\sffamily\normalsize\hfil\box\@tempboxa\hfil}% +\fi\fi} +\else% nonconference compsoc +\long\def\@makecaption#1#2{% +% test if is a for a figure or table +\ifx\@captype\@IEEEtablestring% +% if a table, do table caption +\normalsize\begin{center}{\normalfont\sffamily\normalsize #1}\\{\normalfont\sffamily\normalsize #2}\end{center}% +\@IEEEtablecaptionsepspace +% if not a table, format it as a figure +\else +\@IEEEfigurecaptionsepspace +\setbox\@tempboxa\hbox{\normalfont\sffamily\normalsize {#1.}~ #2}% +\ifdim \wd\@tempboxa >\hsize% +% if caption is longer than a line, let it wrap around +\setbox\@tempboxa\hbox{\normalfont\sffamily\normalsize {#1.}~ }% +\parbox[t]{\hsize}{\normalfont\sffamily\normalsize \noindent\unhbox\@tempboxa#2}% +% if caption is shorter than a line, left justify +\else% +\hbox to\hsize{\normalfont\sffamily\normalsize\box\@tempboxa\hfil}% +\fi\fi} +\fi + +\else% traditional noncompsoc \@makecaption +\long\def\@makecaption#1#2{% +% test if is a for a figure or table +\ifx\@captype\@IEEEtablestring% +% if a table, do table caption +\footnotesize{\centering\normalfont\footnotesize#1.\qquad\scshape #2\par}% +\@IEEEtablecaptionsepspace +% if not a table, format it as a figure +\else +\@IEEEfigurecaptionsepspace +% 3/2001 use footnotesize, not small; use two nonbreaking spaces, not one +\setbox\@tempboxa\hbox{\normalfont\footnotesize {#1.}~~ #2}% +\ifdim \wd\@tempboxa >\hsize% +% if caption is longer than a line, let it wrap around +\setbox\@tempboxa\hbox{\normalfont\footnotesize {#1.}~~ }% +\parbox[t]{\hsize}{\normalfont\footnotesize\noindent\unhbox\@tempboxa#2}% +% if caption is shorter than a line, center if conference, left justify otherwise +\else% +\ifCLASSOPTIONconference \hbox to\hsize{\normalfont\footnotesize\box\@tempboxa\hfil}% +\else \hbox to\hsize{\normalfont\footnotesize\box\@tempboxa\hfil}% +\fi\fi\fi} +\fi + + + +% V1.7 disable captions class option, do so in a way that retains operation of \label +% within \caption +\ifCLASSOPTIONcaptionsoff +\long\def\@makecaption#1#2{\vspace*{2em}\footnotesize\begin{center}{\footnotesize #1}\end{center}% +\let\@IEEEtemporiglabeldefsave\label +\let\@IEEEtemplabelargsave\relax +\def\label##1{\gdef\@IEEEtemplabelargsave{##1}}% +\setbox\@tempboxa\hbox{#2}% +\let\label\@IEEEtemporiglabeldefsave +\ifx\@IEEEtemplabelargsave\relax\else\label{\@IEEEtemplabelargsave}\fi} +\fi + + +% V1.7 define end environments with \def not \let so as to work OK with +% preview-latex +\newcounter{figure} +\def\thefigure{\@arabic\c@figure} +\def\fps@figure{tbp} +\def\ftype@figure{1} +\def\ext@figure{lof} +\def\fnum@figure{\figurename~\thefigure} +\def\figure{\@float{figure}} +\def\endfigure{\end@float} +\@namedef{figure*}{\@dblfloat{figure}} +\@namedef{endfigure*}{\end@dblfloat} +\newcounter{table} +\ifCLASSOPTIONcompsoc +\def\thetable{\arabic{table}} +\else +\def\thetable{\@Roman\c@table} +\fi +\def\fps@table{tbp} +\def\ftype@table{2} +\def\ext@table{lot} +\def\fnum@table{\tablename~\thetable} +% V1.6 IEEE uses 8pt text for tables +% to default to footnotesize, we hack into LaTeX2e's \@floatboxreset and pray +\def\table{\def\@floatboxreset{\reset@font\scriptsize\@setminipage}% + \let\@makefntext\@maketablefntext + \@float{table}} +\def\endtable{\end@float} +% v1.6b double column tables need to default to footnotesize as well. +\@namedef{table*}{\def\@floatboxreset{\reset@font\scriptsize\@setminipage}\@dblfloat{table}} +\@namedef{endtable*}{\end@dblfloat} + + + + +%% +%% START OF IEEEeqnarry DEFINITIONS +%% +%% Inspired by the concepts, examples, and previous works of LaTeX +%% coders and developers such as Donald Arseneau, Fred Bartlett, +%% David Carlisle, Tony Liu, Frank Mittelbach, Piet van Oostrum, +%% Roland Winkler and Mark Wooding. +%% I don't make the claim that my work here is even near their calibre. ;) + + +% hook to allow easy changeover to IEEEtran.cls/tools.sty error reporting +\def\@IEEEclspkgerror{\ClassError{IEEEtran}} + +\newif\if@IEEEeqnarraystarform% flag to indicate if the environment was called as the star form +\@IEEEeqnarraystarformfalse + +\newif\if@advanceIEEEeqncolcnt% tracks if the environment should advance the col counter +% allows a way to make an \IEEEeqnarraybox that can be used within an \IEEEeqnarray +% used by IEEEeqnarraymulticol so that it can work properly in both +\@advanceIEEEeqncolcnttrue + +\newcount\@IEEEeqnnumcols % tracks how many IEEEeqnarray cols are defined +\newcount\@IEEEeqncolcnt % tracks how many IEEEeqnarray cols the user actually used + + +% The default math style used by the columns +\def\IEEEeqnarraymathstyle{\displaystyle} +% The default text style used by the columns +% default to using the current font +\def\IEEEeqnarraytextstyle{\relax} + +% like the iedlistdecl but for \IEEEeqnarray +\def\IEEEeqnarraydecl{\relax} +\def\IEEEeqnarrayboxdecl{\relax} + +% \yesnumber is the opposite of \nonumber +% a novel concept with the same def as the equationarray package +% However, we give IEEE versions too since some LaTeX packages such as +% the MDWtools mathenv.sty redefine \nonumber to something else. +\providecommand{\yesnumber}{\global\@eqnswtrue} +\def\IEEEyesnumber{\global\@eqnswtrue} +\def\IEEEnonumber{\global\@eqnswfalse} + + +\def\IEEEyessubnumber{\global\@IEEEissubequationtrue\global\@eqnswtrue% +\if@IEEEeqnarrayISinner% only do something inside an IEEEeqnarray +\if@IEEElastlinewassubequation\addtocounter{equation}{-1}\else\setcounter{IEEEsubequation}{1}\fi% +\def\@currentlabel{\p@IEEEsubequation\theIEEEsubequation}\fi} + +% flag to indicate that an equation is a sub equation +\newif\if@IEEEissubequation% +\@IEEEissubequationfalse + +% allows users to "push away" equations that get too close to the equation numbers +\def\IEEEeqnarraynumspace{\hphantom{\if@IEEEissubequation\theIEEEsubequationdis\else\theequationdis\fi}} + +% provides a way to span multiple columns within IEEEeqnarray environments +% will consider \if@advanceIEEEeqncolcnt before globally advancing the +% column counter - so as to work within \IEEEeqnarraybox +% usage: \IEEEeqnarraymulticol{number cols. to span}{col type}{cell text} +\long\def\IEEEeqnarraymulticol#1#2#3{\multispan{#1}% +% check if column is defined +\relax\expandafter\ifx\csname @IEEEeqnarraycolDEF#2\endcsname\@IEEEeqnarraycolisdefined% +\csname @IEEEeqnarraycolPRE#2\endcsname#3\relax\relax\relax\relax\relax% +\relax\relax\relax\relax\relax\csname @IEEEeqnarraycolPOST#2\endcsname% +\else% if not, error and use default type +\@IEEEclspkgerror{Invalid column type "#2" in \string\IEEEeqnarraymulticol.\MessageBreak +Using a default centering column instead}% +{You must define IEEEeqnarray column types before use.}% +\csname @IEEEeqnarraycolPRE@IEEEdefault\endcsname#3\relax\relax\relax\relax\relax% +\relax\relax\relax\relax\relax\csname @IEEEeqnarraycolPOST@IEEEdefault\endcsname% +\fi% +% advance column counter only if the IEEEeqnarray environment wants it +\if@advanceIEEEeqncolcnt\global\advance\@IEEEeqncolcnt by #1\relax\fi} + +% like \omit, but maintains track of the column counter for \IEEEeqnarray +\def\IEEEeqnarrayomit{\omit\if@advanceIEEEeqncolcnt\global\advance\@IEEEeqncolcnt by 1\relax\fi} + + +% provides a way to define a letter referenced column type +% usage: \IEEEeqnarraydefcol{col. type letter/name}{pre insertion text}{post insertion text} +\def\IEEEeqnarraydefcol#1#2#3{\expandafter\def\csname @IEEEeqnarraycolPRE#1\endcsname{#2}% +\expandafter\def\csname @IEEEeqnarraycolPOST#1\endcsname{#3}% +\expandafter\def\csname @IEEEeqnarraycolDEF#1\endcsname{1}} + + +% provides a way to define a numerically referenced inter-column glue types +% usage: \IEEEeqnarraydefcolsep{col. glue number}{glue definition} +\def\IEEEeqnarraydefcolsep#1#2{\expandafter\def\csname @IEEEeqnarraycolSEP\romannumeral #1\endcsname{#2}% +\expandafter\def\csname @IEEEeqnarraycolSEPDEF\romannumeral #1\endcsname{1}} + + +\def\@IEEEeqnarraycolisdefined{1}% just a macro for 1, used for checking undefined column types + + +% expands and appends the given argument to the \@IEEEtrantmptoksA token list +% used to build up the \halign preamble +\def\@IEEEappendtoksA#1{\edef\@@IEEEappendtoksA{\@IEEEtrantmptoksA={\the\@IEEEtrantmptoksA #1}}% +\@@IEEEappendtoksA} + +% also appends to \@IEEEtrantmptoksA, but does not expand the argument +% uses \toks8 as a scratchpad register +\def\@IEEEappendNOEXPANDtoksA#1{\toks8={#1}% +\edef\@@IEEEappendNOEXPANDtoksA{\@IEEEtrantmptoksA={\the\@IEEEtrantmptoksA\the\toks8}}% +\@@IEEEappendNOEXPANDtoksA} + +% define some common column types for the user +% math +\IEEEeqnarraydefcol{l}{$\IEEEeqnarraymathstyle}{$\hfil} +\IEEEeqnarraydefcol{c}{\hfil$\IEEEeqnarraymathstyle}{$\hfil} +\IEEEeqnarraydefcol{r}{\hfil$\IEEEeqnarraymathstyle}{$} +\IEEEeqnarraydefcol{L}{$\IEEEeqnarraymathstyle{}}{{}$\hfil} +\IEEEeqnarraydefcol{C}{\hfil$\IEEEeqnarraymathstyle{}}{{}$\hfil} +\IEEEeqnarraydefcol{R}{\hfil$\IEEEeqnarraymathstyle{}}{{}$} +% text +\IEEEeqnarraydefcol{s}{\IEEEeqnarraytextstyle}{\hfil} +\IEEEeqnarraydefcol{t}{\hfil\IEEEeqnarraytextstyle}{\hfil} +\IEEEeqnarraydefcol{u}{\hfil\IEEEeqnarraytextstyle}{} + +% vertical rules +\IEEEeqnarraydefcol{v}{}{\vrule width\arrayrulewidth} +\IEEEeqnarraydefcol{vv}{\vrule width\arrayrulewidth\hfil}{\hfil\vrule width\arrayrulewidth} +\IEEEeqnarraydefcol{V}{}{\vrule width\arrayrulewidth\hskip\doublerulesep\vrule width\arrayrulewidth} +\IEEEeqnarraydefcol{VV}{\vrule width\arrayrulewidth\hskip\doublerulesep\vrule width\arrayrulewidth\hfil}% +{\hfil\vrule width\arrayrulewidth\hskip\doublerulesep\vrule width\arrayrulewidth} + +% horizontal rules +\IEEEeqnarraydefcol{h}{}{\leaders\hrule height\arrayrulewidth\hfil} +\IEEEeqnarraydefcol{H}{}{\leaders\vbox{\hrule width\arrayrulewidth\vskip\doublerulesep\hrule width\arrayrulewidth}\hfil} + +% plain +\IEEEeqnarraydefcol{x}{}{} +\IEEEeqnarraydefcol{X}{$}{$} + +% the default column type to use in the event a column type is not defined +\IEEEeqnarraydefcol{@IEEEdefault}{\hfil$\IEEEeqnarraymathstyle}{$\hfil} + + +% a zero tabskip (used for "-" col types) +\def\@IEEEeqnarraycolSEPzero{0pt plus 0pt minus 0pt} +% a centering tabskip (used for "+" col types) +\def\@IEEEeqnarraycolSEPcenter{1000pt plus 0pt minus 1000pt} + +% top level default tabskip glues for the start, end, and inter-column +% may be reset within environments not always at the top level, e.g., \IEEEeqnarraybox +\edef\@IEEEeqnarraycolSEPdefaultstart{\@IEEEeqnarraycolSEPcenter}% default start glue +\edef\@IEEEeqnarraycolSEPdefaultend{\@IEEEeqnarraycolSEPcenter}% default end glue +\edef\@IEEEeqnarraycolSEPdefaultmid{\@IEEEeqnarraycolSEPzero}% default inter-column glue + + + +% creates a vertical rule that extends from the bottom to the top a a cell +% Provided in case other packages redefine \vline some other way. +% usage: \IEEEeqnarrayvrule[rule thickness] +% If no argument is provided, \arrayrulewidth will be used for the rule thickness. +\newcommand\IEEEeqnarrayvrule[1][\arrayrulewidth]{\vrule\@width#1\relax} + +% creates a blank separator row +% usage: \IEEEeqnarrayseprow[separation length][font size commands] +% default is \IEEEeqnarrayseprow[0.25\normalbaselineskip][\relax] +% blank arguments inherit the default values +% uses \skip5 as a scratch register - calls \@IEEEeqnarraystrutsize which uses more scratch registers +\def\IEEEeqnarrayseprow{\relax\@ifnextchar[{\@IEEEeqnarrayseprow}{\@IEEEeqnarrayseprow[0.25\normalbaselineskip]}} +\def\@IEEEeqnarrayseprow[#1]{\relax\@ifnextchar[{\@@IEEEeqnarrayseprow[#1]}{\@@IEEEeqnarrayseprow[#1][\relax]}} +\def\@@IEEEeqnarrayseprow[#1][#2]{\def\@IEEEeqnarrayseprowARGONE{#1}% +\ifx\@IEEEeqnarrayseprowARGONE\@empty% +% get the skip value, based on the font commands +% use skip5 because \IEEEeqnarraystrutsize uses \skip0, \skip2, \skip3 +% assign within a bogus box to confine the font changes +{\setbox0=\hbox{#2\relax\global\skip5=0.25\normalbaselineskip}}% +\else% +{\setbox0=\hbox{#2\relax\global\skip5=#1}}% +\fi% +\@IEEEeqnarrayhoptolastcolumn\IEEEeqnarraystrutsize{\skip5}{0pt}[\relax]\relax} + +% creates a blank separator row, but omits all the column templates +% usage: \IEEEeqnarrayseprowcut[separation length][font size commands] +% default is \IEEEeqnarrayseprowcut[0.25\normalbaselineskip][\relax] +% blank arguments inherit the default values +% uses \skip5 as a scratch register - calls \@IEEEeqnarraystrutsize which uses more scratch registers +\def\IEEEeqnarrayseprowcut{\multispan{\@IEEEeqnnumcols}\relax% span all the cols +% advance column counter only if the IEEEeqnarray environment wants it +\if@advanceIEEEeqncolcnt\global\advance\@IEEEeqncolcnt by \@IEEEeqnnumcols\relax\fi% +\@ifnextchar[{\@IEEEeqnarrayseprowcut}{\@IEEEeqnarrayseprowcut[0.25\normalbaselineskip]}} +\def\@IEEEeqnarrayseprowcut[#1]{\relax\@ifnextchar[{\@@IEEEeqnarrayseprowcut[#1]}{\@@IEEEeqnarrayseprowcut[#1][\relax]}} +\def\@@IEEEeqnarrayseprowcut[#1][#2]{\def\@IEEEeqnarrayseprowARGONE{#1}% +\ifx\@IEEEeqnarrayseprowARGONE\@empty% +% get the skip value, based on the font commands +% use skip5 because \IEEEeqnarraystrutsize uses \skip0, \skip2, \skip3 +% assign within a bogus box to confine the font changes +{\setbox0=\hbox{#2\relax\global\skip5=0.25\normalbaselineskip}}% +\else% +{\setbox0=\hbox{#2\relax\global\skip5=#1}}% +\fi% +\IEEEeqnarraystrutsize{\skip5}{0pt}[\relax]\relax} + + + +% draws a single rule across all the columns optional +% argument determines the rule width, \arrayrulewidth is the default +% updates column counter as needed and turns off struts +% usage: \IEEEeqnarrayrulerow[rule line thickness] +\def\IEEEeqnarrayrulerow{\multispan{\@IEEEeqnnumcols}\relax% span all the cols +% advance column counter only if the IEEEeqnarray environment wants it +\if@advanceIEEEeqncolcnt\global\advance\@IEEEeqncolcnt by \@IEEEeqnnumcols\relax\fi% +\@ifnextchar[{\@IEEEeqnarrayrulerow}{\@IEEEeqnarrayrulerow[\arrayrulewidth]}} +\def\@IEEEeqnarrayrulerow[#1]{\leaders\hrule height#1\hfil\relax% put in our rule +% turn off any struts +\IEEEeqnarraystrutsize{0pt}{0pt}[\relax]\relax} + + +% draws a double rule by using a single rule row, a separator row, and then +% another single rule row +% first optional argument determines the rule thicknesses, \arrayrulewidth is the default +% second optional argument determines the rule spacing, \doublerulesep is the default +% usage: \IEEEeqnarraydblrulerow[rule line thickness][rule spacing] +\def\IEEEeqnarraydblrulerow{\multispan{\@IEEEeqnnumcols}\relax% span all the cols +% advance column counter only if the IEEEeqnarray environment wants it +\if@advanceIEEEeqncolcnt\global\advance\@IEEEeqncolcnt by \@IEEEeqnnumcols\relax\fi% +\@ifnextchar[{\@IEEEeqnarraydblrulerow}{\@IEEEeqnarraydblrulerow[\arrayrulewidth]}} +\def\@IEEEeqnarraydblrulerow[#1]{\relax\@ifnextchar[{\@@IEEEeqnarraydblrulerow[#1]}% +{\@@IEEEeqnarraydblrulerow[#1][\doublerulesep]}} +\def\@@IEEEeqnarraydblrulerow[#1][#2]{\def\@IEEEeqnarraydblrulerowARG{#1}% +% we allow the user to say \IEEEeqnarraydblrulerow[][] +\ifx\@IEEEeqnarraydblrulerowARG\@empty% +\@IEEEeqnarrayrulerow[\arrayrulewidth]% +\else% +\@IEEEeqnarrayrulerow[#1]\relax% +\fi% +\def\@IEEEeqnarraydblrulerowARG{#2}% +\ifx\@IEEEeqnarraydblrulerowARG\@empty% +\\\IEEEeqnarrayseprow[\doublerulesep][\relax]% +\else% +\\\IEEEeqnarrayseprow[#2][\relax]% +\fi% +\\\multispan{\@IEEEeqnnumcols}% +% advance column counter only if the IEEEeqnarray environment wants it +\if@advanceIEEEeqncolcnt\global\advance\@IEEEeqncolcnt by \@IEEEeqnnumcols\relax\fi% +\def\@IEEEeqnarraydblrulerowARG{#1}% +\ifx\@IEEEeqnarraydblrulerowARG\@empty% +\@IEEEeqnarrayrulerow[\arrayrulewidth]% +\else% +\@IEEEeqnarrayrulerow[#1]% +\fi% +} + +% draws a double rule by using a single rule row, a separator (cutting) row, and then +% another single rule row +% first optional argument determines the rule thicknesses, \arrayrulewidth is the default +% second optional argument determines the rule spacing, \doublerulesep is the default +% usage: \IEEEeqnarraydblrulerow[rule line thickness][rule spacing] +\def\IEEEeqnarraydblrulerowcut{\multispan{\@IEEEeqnnumcols}\relax% span all the cols +% advance column counter only if the IEEEeqnarray environment wants it +\if@advanceIEEEeqncolcnt\global\advance\@IEEEeqncolcnt by \@IEEEeqnnumcols\relax\fi% +\@ifnextchar[{\@IEEEeqnarraydblrulerowcut}{\@IEEEeqnarraydblrulerowcut[\arrayrulewidth]}} +\def\@IEEEeqnarraydblrulerowcut[#1]{\relax\@ifnextchar[{\@@IEEEeqnarraydblrulerowcut[#1]}% +{\@@IEEEeqnarraydblrulerowcut[#1][\doublerulesep]}} +\def\@@IEEEeqnarraydblrulerowcut[#1][#2]{\def\@IEEEeqnarraydblrulerowARG{#1}% +% we allow the user to say \IEEEeqnarraydblrulerow[][] +\ifx\@IEEEeqnarraydblrulerowARG\@empty% +\@IEEEeqnarrayrulerow[\arrayrulewidth]% +\else% +\@IEEEeqnarrayrulerow[#1]% +\fi% +\def\@IEEEeqnarraydblrulerowARG{#2}% +\ifx\@IEEEeqnarraydblrulerowARG\@empty% +\\\IEEEeqnarrayseprowcut[\doublerulesep][\relax]% +\else% +\\\IEEEeqnarrayseprowcut[#2][\relax]% +\fi% +\\\multispan{\@IEEEeqnnumcols}% +% advance column counter only if the IEEEeqnarray environment wants it +\if@advanceIEEEeqncolcnt\global\advance\@IEEEeqncolcnt by \@IEEEeqnnumcols\relax\fi% +\def\@IEEEeqnarraydblrulerowARG{#1}% +\ifx\@IEEEeqnarraydblrulerowARG\@empty% +\@IEEEeqnarrayrulerow[\arrayrulewidth]% +\else% +\@IEEEeqnarrayrulerow[#1]% +\fi% +} + + + +% inserts a full row's worth of &'s +% relies on \@IEEEeqnnumcols to provide the correct number of columns +% uses \@IEEEtrantmptoksA, \count0 as scratch registers +\def\@IEEEeqnarrayhoptolastcolumn{\@IEEEtrantmptoksA={}\count0=1\relax% +\loop% add cols if the user did not use them all +\ifnum\count0<\@IEEEeqnnumcols\relax% +\@IEEEappendtoksA{&}% +\advance\count0 by 1\relax% update the col count +\repeat% +\the\@IEEEtrantmptoksA%execute the &'s +} + + + +\newif\if@IEEEeqnarrayISinner % flag to indicate if we are within the lines +\@IEEEeqnarrayISinnerfalse % of an IEEEeqnarray - after the IEEEeqnarraydecl + +\edef\@IEEEeqnarrayTHEstrutheight{0pt} % height and depth of IEEEeqnarray struts +\edef\@IEEEeqnarrayTHEstrutdepth{0pt} + +\edef\@IEEEeqnarrayTHEmasterstrutheight{0pt} % default height and depth of +\edef\@IEEEeqnarrayTHEmasterstrutdepth{0pt} % struts within an IEEEeqnarray + +\edef\@IEEEeqnarrayTHEmasterstrutHSAVE{0pt} % saved master strut height +\edef\@IEEEeqnarrayTHEmasterstrutDSAVE{0pt} % and depth + +\newif\if@IEEEeqnarrayusemasterstrut % flag to indicate that the master strut value +\@IEEEeqnarrayusemasterstruttrue % is to be used + + + +% saves the strut height and depth of the master strut +\def\@IEEEeqnarraymasterstrutsave{\relax% +\expandafter\skip0=\@IEEEeqnarrayTHEmasterstrutheight\relax% +\expandafter\skip2=\@IEEEeqnarrayTHEmasterstrutdepth\relax% +% remove stretchability +\dimen0\skip0\relax% +\dimen2\skip2\relax% +% save values +\edef\@IEEEeqnarrayTHEmasterstrutHSAVE{\the\dimen0}% +\edef\@IEEEeqnarrayTHEmasterstrutDSAVE{\the\dimen2}} + +% restores the strut height and depth of the master strut +\def\@IEEEeqnarraymasterstrutrestore{\relax% +\expandafter\skip0=\@IEEEeqnarrayTHEmasterstrutHSAVE\relax% +\expandafter\skip2=\@IEEEeqnarrayTHEmasterstrutDSAVE\relax% +% remove stretchability +\dimen0\skip0\relax% +\dimen2\skip2\relax% +% restore values +\edef\@IEEEeqnarrayTHEmasterstrutheight{\the\dimen0}% +\edef\@IEEEeqnarrayTHEmasterstrutdepth{\the\dimen2}} + + +% globally restores the strut height and depth to the +% master values and sets the master strut flag to true +\def\@IEEEeqnarraystrutreset{\relax% +\expandafter\skip0=\@IEEEeqnarrayTHEmasterstrutheight\relax% +\expandafter\skip2=\@IEEEeqnarrayTHEmasterstrutdepth\relax% +% remove stretchability +\dimen0\skip0\relax% +\dimen2\skip2\relax% +% restore values +\xdef\@IEEEeqnarrayTHEstrutheight{\the\dimen0}% +\xdef\@IEEEeqnarrayTHEstrutdepth{\the\dimen2}% +\global\@IEEEeqnarrayusemasterstruttrue} + + +% if the master strut is not to be used, make the current +% values of \@IEEEeqnarrayTHEstrutheight, \@IEEEeqnarrayTHEstrutdepth +% and the use master strut flag, global +% this allows user strut commands issued in the last column to be carried +% into the isolation/strut column +\def\@IEEEeqnarrayglobalizestrutstatus{\relax% +\if@IEEEeqnarrayusemasterstrut\else% +\xdef\@IEEEeqnarrayTHEstrutheight{\@IEEEeqnarrayTHEstrutheight}% +\xdef\@IEEEeqnarrayTHEstrutdepth{\@IEEEeqnarrayTHEstrutdepth}% +\global\@IEEEeqnarrayusemasterstrutfalse% +\fi} + + + +% usage: \IEEEeqnarraystrutsize{height}{depth}[font size commands] +% If called outside the lines of an IEEEeqnarray, sets the height +% and depth of both the master and local struts. If called inside +% an IEEEeqnarray line, sets the height and depth of the local strut +% only and sets the flag to indicate the use of the local strut +% values. If the height or depth is left blank, 0.7\normalbaselineskip +% and 0.3\normalbaselineskip will be used, respectively. +% The optional argument can be used to evaluate the lengths under +% a different font size and styles. If none is specified, the current +% font is used. +% uses scratch registers \skip0, \skip2, \skip3, \dimen0, \dimen2 +\def\IEEEeqnarraystrutsize#1#2{\relax\@ifnextchar[{\@IEEEeqnarraystrutsize{#1}{#2}}{\@IEEEeqnarraystrutsize{#1}{#2}[\relax]}} +\def\@IEEEeqnarraystrutsize#1#2[#3]{\def\@IEEEeqnarraystrutsizeARG{#1}% +\ifx\@IEEEeqnarraystrutsizeARG\@empty% +{\setbox0=\hbox{#3\relax\global\skip3=0.7\normalbaselineskip}}% +\skip0=\skip3\relax% +\else% arg one present +{\setbox0=\hbox{#3\relax\global\skip3=#1\relax}}% +\skip0=\skip3\relax% +\fi% if null arg +\def\@IEEEeqnarraystrutsizeARG{#2}% +\ifx\@IEEEeqnarraystrutsizeARG\@empty% +{\setbox0=\hbox{#3\relax\global\skip3=0.3\normalbaselineskip}}% +\skip2=\skip3\relax% +\else% arg two present +{\setbox0=\hbox{#3\relax\global\skip3=#2\relax}}% +\skip2=\skip3\relax% +\fi% if null arg +% remove stretchability, just to be safe +\dimen0\skip0\relax% +\dimen2\skip2\relax% +% dimen0 = height, dimen2 = depth +\if@IEEEeqnarrayISinner% inner does not touch master strut size +\edef\@IEEEeqnarrayTHEstrutheight{\the\dimen0}% +\edef\@IEEEeqnarrayTHEstrutdepth{\the\dimen2}% +\@IEEEeqnarrayusemasterstrutfalse% do not use master +\else% outer, have to set master strut too +\edef\@IEEEeqnarrayTHEmasterstrutheight{\the\dimen0}% +\edef\@IEEEeqnarrayTHEmasterstrutdepth{\the\dimen2}% +\edef\@IEEEeqnarrayTHEstrutheight{\the\dimen0}% +\edef\@IEEEeqnarrayTHEstrutdepth{\the\dimen2}% +\@IEEEeqnarrayusemasterstruttrue% use master strut +\fi} + + +% usage: \IEEEeqnarraystrutsizeadd{added height}{added depth}[font size commands] +% If called outside the lines of an IEEEeqnarray, adds the given height +% and depth to both the master and local struts. +% If called inside an IEEEeqnarray line, adds the given height and depth +% to the local strut only and sets the flag to indicate the use +% of the local strut values. +% In both cases, if a height or depth is left blank, 0pt is used instead. +% The optional argument can be used to evaluate the lengths under +% a different font size and styles. If none is specified, the current +% font is used. +% uses scratch registers \skip0, \skip2, \skip3, \dimen0, \dimen2 +\def\IEEEeqnarraystrutsizeadd#1#2{\relax\@ifnextchar[{\@IEEEeqnarraystrutsizeadd{#1}{#2}}{\@IEEEeqnarraystrutsizeadd{#1}{#2}[\relax]}} +\def\@IEEEeqnarraystrutsizeadd#1#2[#3]{\def\@IEEEeqnarraystrutsizearg{#1}% +\ifx\@IEEEeqnarraystrutsizearg\@empty% +\skip0=0pt\relax% +\else% arg one present +{\setbox0=\hbox{#3\relax\global\skip3=#1}}% +\skip0=\skip3\relax% +\fi% if null arg +\def\@IEEEeqnarraystrutsizearg{#2}% +\ifx\@IEEEeqnarraystrutsizearg\@empty% +\skip2=0pt\relax% +\else% arg two present +{\setbox0=\hbox{#3\relax\global\skip3=#2}}% +\skip2=\skip3\relax% +\fi% if null arg +% remove stretchability, just to be safe +\dimen0\skip0\relax% +\dimen2\skip2\relax% +% dimen0 = height, dimen2 = depth +\if@IEEEeqnarrayISinner% inner does not touch master strut size +% get local strut size +\expandafter\skip0=\@IEEEeqnarrayTHEstrutheight\relax% +\expandafter\skip2=\@IEEEeqnarrayTHEstrutdepth\relax% +% add it to the user supplied values +\advance\dimen0 by \skip0\relax% +\advance\dimen2 by \skip2\relax% +% update the local strut size +\edef\@IEEEeqnarrayTHEstrutheight{\the\dimen0}% +\edef\@IEEEeqnarrayTHEstrutdepth{\the\dimen2}% +\@IEEEeqnarrayusemasterstrutfalse% do not use master +\else% outer, have to set master strut too +% get master strut size +\expandafter\skip0=\@IEEEeqnarrayTHEmasterstrutheight\relax% +\expandafter\skip2=\@IEEEeqnarrayTHEmasterstrutdepth\relax% +% add it to the user supplied values +\advance\dimen0 by \skip0\relax% +\advance\dimen2 by \skip2\relax% +% update the local and master strut sizes +\edef\@IEEEeqnarrayTHEmasterstrutheight{\the\dimen0}% +\edef\@IEEEeqnarrayTHEmasterstrutdepth{\the\dimen2}% +\edef\@IEEEeqnarrayTHEstrutheight{\the\dimen0}% +\edef\@IEEEeqnarrayTHEstrutdepth{\the\dimen2}% +\@IEEEeqnarrayusemasterstruttrue% use master strut +\fi} + + +% allow user a way to see the struts +\newif\ifIEEEvisiblestruts +\IEEEvisiblestrutsfalse + +% inserts an invisible strut using the master or local strut values +% uses scratch registers \skip0, \skip2, \dimen0, \dimen2 +\def\@IEEEeqnarrayinsertstrut{\relax% +\if@IEEEeqnarrayusemasterstrut +% get master strut size +\expandafter\skip0=\@IEEEeqnarrayTHEmasterstrutheight\relax% +\expandafter\skip2=\@IEEEeqnarrayTHEmasterstrutdepth\relax% +\else% +% get local strut size +\expandafter\skip0=\@IEEEeqnarrayTHEstrutheight\relax% +\expandafter\skip2=\@IEEEeqnarrayTHEstrutdepth\relax% +\fi% +% remove stretchability, probably not needed +\dimen0\skip0\relax% +\dimen2\skip2\relax% +% dimen0 = height, dimen2 = depth +% allow user to see struts if desired +\ifIEEEvisiblestruts% +\vrule width0.2pt height\dimen0 depth\dimen2\relax% +\else% +\vrule width0pt height\dimen0 depth\dimen2\relax\fi} + + +% creates an invisible strut, useable even outside \IEEEeqnarray +% if \IEEEvisiblestrutstrue, the strut will be visible and 0.2pt wide. +% usage: \IEEEstrut[height][depth][font size commands] +% default is \IEEEstrut[0.7\normalbaselineskip][0.3\normalbaselineskip][\relax] +% blank arguments inherit the default values +% uses \dimen0, \dimen2, \skip0, \skip2 +\def\IEEEstrut{\relax\@ifnextchar[{\@IEEEstrut}{\@IEEEstrut[0.7\normalbaselineskip]}} +\def\@IEEEstrut[#1]{\relax\@ifnextchar[{\@@IEEEstrut[#1]}{\@@IEEEstrut[#1][0.3\normalbaselineskip]}} +\def\@@IEEEstrut[#1][#2]{\relax\@ifnextchar[{\@@@IEEEstrut[#1][#2]}{\@@@IEEEstrut[#1][#2][\relax]}} +\def\@@@IEEEstrut[#1][#2][#3]{\mbox{#3\relax% +\def\@IEEEstrutARG{#1}% +\ifx\@IEEEstrutARG\@empty% +\skip0=0.7\normalbaselineskip\relax% +\else% +\skip0=#1\relax% +\fi% +\def\@IEEEstrutARG{#2}% +\ifx\@IEEEstrutARG\@empty% +\skip2=0.3\normalbaselineskip\relax% +\else% +\skip2=#2\relax% +\fi% +% remove stretchability, probably not needed +\dimen0\skip0\relax% +\dimen2\skip2\relax% +\ifIEEEvisiblestruts% +\vrule width0.2pt height\dimen0 depth\dimen2\relax% +\else% +\vrule width0.0pt height\dimen0 depth\dimen2\relax\fi}} + + +% enables strut mode by setting a default strut size and then zeroing the +% \baselineskip, \lineskip, \lineskiplimit and \jot +\def\IEEEeqnarraystrutmode{\IEEEeqnarraystrutsize{0.7\normalbaselineskip}{0.3\normalbaselineskip}[\relax]% +\baselineskip=0pt\lineskip=0pt\lineskiplimit=0pt\jot=0pt} + + + +\def\IEEEeqnarray{\@IEEEeqnarraystarformfalse\@IEEEeqnarray} +\def\endIEEEeqnarray{\end@IEEEeqnarray} + +\@namedef{IEEEeqnarray*}{\@IEEEeqnarraystarformtrue\@IEEEeqnarray} +\@namedef{endIEEEeqnarray*}{\end@IEEEeqnarray} + + +% \IEEEeqnarray is an enhanced \eqnarray. +% The star form defaults to not putting equation numbers at the end of each row. +% usage: \IEEEeqnarray[decl]{cols} +\def\@IEEEeqnarray{\relax\@ifnextchar[{\@@IEEEeqnarray}{\@@IEEEeqnarray[\relax]}} +\def\@@IEEEeqnarray[#1]#2{% + % default to showing the equation number or not based on whether or not + % the star form was involked + \if@IEEEeqnarraystarform\global\@eqnswfalse + \else% not the star form + \global\@eqnswtrue + \fi% if star form + \@IEEEissubequationfalse% default to no subequations + \@IEEElastlinewassubequationfalse% assume last line is not a sub equation + \@IEEEeqnarrayISinnerfalse% not yet within the lines of the halign + \@IEEEeqnarraystrutsize{0pt}{0pt}[\relax]% turn off struts by default + \@IEEEeqnarrayusemasterstruttrue% use master strut till user asks otherwise + \IEEEvisiblestrutsfalse% diagnostic mode defaults to off + % no extra space unless the user specifically requests it + \lineskip=0pt\relax + \lineskiplimit=0pt\relax + \baselineskip=\normalbaselineskip\relax% + \jot=\IEEEnormaljot\relax% + \mathsurround\z@\relax% no extra spacing around math + \@advanceIEEEeqncolcnttrue% advance the col counter for each col the user uses, + % used in \IEEEeqnarraymulticol and in the preamble build + \stepcounter{equation}% advance equation counter before first line + \setcounter{IEEEsubequation}{0}% no subequation yet + \def\@currentlabel{\p@equation\theequation}% redefine the ref label + \IEEEeqnarraydecl\relax% allow a way for the user to make global overrides + #1\relax% allow user to override defaults + \let\\\@IEEEeqnarraycr% replace newline with one that can put in eqn. numbers + \global\@IEEEeqncolcnt\z@% col. count = 0 for first line + \@IEEEbuildpreamble #2\end\relax% build the preamble and put it into \@IEEEtrantmptoksA + % put in the column for the equation number + \ifnum\@IEEEeqnnumcols>0\relax\@IEEEappendtoksA{&}\fi% col separator for those after the first + \toks0={##}% + % advance the \@IEEEeqncolcnt for the isolation col, this helps with error checking + \@IEEEappendtoksA{\global\advance\@IEEEeqncolcnt by 1\relax}% + % add the isolation column + \@IEEEappendtoksA{\tabskip\z@skip\bgroup\the\toks0\egroup}% + % advance the \@IEEEeqncolcnt for the equation number col, this helps with error checking + \@IEEEappendtoksA{&\global\advance\@IEEEeqncolcnt by 1\relax}% + % add the equation number col to the preamble + \@IEEEappendtoksA{\tabskip\z@skip\hb@xt@\z@\bgroup\hss\the\toks0\egroup}% + % note \@IEEEeqnnumcols does not count the equation col or isolation col + % set the starting tabskip glue as determined by the preamble build + \tabskip=\@IEEEBPstartglue\relax + % begin the display alignment + \@IEEEeqnarrayISinnertrue% commands are now within the lines + $$\everycr{}\halign to\displaywidth\bgroup + % "exspand" the preamble + \span\the\@IEEEtrantmptoksA\cr} + +% enter isolation/strut column (or the next column if the user did not use +% every column), record the strut status, complete the columns, do the strut if needed, +% restore counters to correct values and exit +\def\end@IEEEeqnarray{\@IEEEeqnarrayglobalizestrutstatus&\@@IEEEeqnarraycr\egroup% +\if@IEEElastlinewassubequation\global\advance\c@IEEEsubequation\m@ne\fi% +\global\advance\c@equation\m@ne% +$$\@ignoretrue} + +% need a way to remember if last line is a subequation +\newif\if@IEEElastlinewassubequation% +\@IEEElastlinewassubequationfalse + +% IEEEeqnarray uses a modifed \\ instead of the plain \cr to +% end rows. This allows for things like \\*[vskip amount] +% This "cr" macros are modified versions those for LaTeX2e's eqnarray +% the {\ifnum0=`} braces must be kept away from the last column to avoid +% altering spacing of its math, so we use & to advance to the next column +% as there is an isolation/strut column after the user's columns +\def\@IEEEeqnarraycr{\@IEEEeqnarrayglobalizestrutstatus&% save strut status and advance to next column + {\ifnum0=`}\fi + \@ifstar{% + \global\@eqpen\@M\@IEEEeqnarrayYCR + }{% + \global\@eqpen\interdisplaylinepenalty \@IEEEeqnarrayYCR + }% +} + +\def\@IEEEeqnarrayYCR{\@testopt\@IEEEeqnarrayXCR\z@skip} + +\def\@IEEEeqnarrayXCR[#1]{% + \ifnum0=`{\fi}% + \@@IEEEeqnarraycr + \noalign{\penalty\@eqpen\vskip\jot\vskip #1\relax}}% + +\def\@@IEEEeqnarraycr{\@IEEEtrantmptoksA={}% clear token register + \advance\@IEEEeqncolcnt by -1\relax% adjust col count because of the isolation column + \ifnum\@IEEEeqncolcnt>\@IEEEeqnnumcols\relax + \@IEEEclspkgerror{Too many columns within the IEEEeqnarray\MessageBreak + environment}% + {Use fewer \string &'s or put more columns in the IEEEeqnarry column\MessageBreak + specifications.}\relax% + \else + \loop% add cols if the user did not use them all + \ifnum\@IEEEeqncolcnt<\@IEEEeqnnumcols\relax + \@IEEEappendtoksA{&}% + \advance\@IEEEeqncolcnt by 1\relax% update the col count + \repeat + % this number of &'s will take us the the isolation column + \fi + % execute the &'s + \the\@IEEEtrantmptoksA% + % handle the strut/isolation column + \@IEEEeqnarrayinsertstrut% do the strut if needed + \@IEEEeqnarraystrutreset% reset the strut system for next line or IEEEeqnarray + &% and enter the equation number column + % is this line needs an equation number, display it and advance the + % (sub)equation counters, record what type this line was + \if@eqnsw% + \if@IEEEissubequation\theIEEEsubequationdis\addtocounter{equation}{1}\stepcounter{IEEEsubequation}% + \global\@IEEElastlinewassubequationtrue% + \else% display a standard equation number, initialize the IEEEsubequation counter + \theequationdis\stepcounter{equation}\setcounter{IEEEsubequation}{0}% + \global\@IEEElastlinewassubequationfalse\fi% + \fi% + % reset the eqnsw flag to indicate default preference of the display of equation numbers + \if@IEEEeqnarraystarform\global\@eqnswfalse\else\global\@eqnswtrue\fi + \global\@IEEEissubequationfalse% reset the subequation flag + % reset the number of columns the user actually used + \global\@IEEEeqncolcnt\z@\relax + % the real end of the line + \cr} + + + + + +% \IEEEeqnarraybox is like \IEEEeqnarray except the box form puts everything +% inside a vtop, vbox, or vcenter box depending on the letter in the second +% optional argument (t,b,c). Vbox is the default. Unlike \IEEEeqnarray, +% equation numbers are not displayed and \IEEEeqnarraybox can be nested. +% \IEEEeqnarrayboxm is for math mode (like \array) and does not put the vbox +% within an hbox. +% \IEEEeqnarrayboxt is for text mode (like \tabular) and puts the vbox within +% a \hbox{$ $} construct. +% \IEEEeqnarraybox will auto detect whether to use \IEEEeqnarrayboxm or +% \IEEEeqnarrayboxt depending on the math mode. +% The third optional argument specifies the width this box is to be set to - +% natural width is the default. +% The * forms do not add \jot line spacing +% usage: \IEEEeqnarraybox[decl][pos][width]{cols} +\def\IEEEeqnarrayboxm{\@IEEEeqnarraystarformfalse\@IEEEeqnarrayboxHBOXSWfalse\@IEEEeqnarraybox} +\def\endIEEEeqnarrayboxm{\end@IEEEeqnarraybox} +\@namedef{IEEEeqnarrayboxm*}{\@IEEEeqnarraystarformtrue\@IEEEeqnarrayboxHBOXSWfalse\@IEEEeqnarraybox} +\@namedef{endIEEEeqnarrayboxm*}{\end@IEEEeqnarraybox} + +\def\IEEEeqnarrayboxt{\@IEEEeqnarraystarformfalse\@IEEEeqnarrayboxHBOXSWtrue\@IEEEeqnarraybox} +\def\endIEEEeqnarrayboxt{\end@IEEEeqnarraybox} +\@namedef{IEEEeqnarrayboxt*}{\@IEEEeqnarraystarformtrue\@IEEEeqnarrayboxHBOXSWtrue\@IEEEeqnarraybox} +\@namedef{endIEEEeqnarrayboxt*}{\end@IEEEeqnarraybox} + +\def\IEEEeqnarraybox{\@IEEEeqnarraystarformfalse\ifmmode\@IEEEeqnarrayboxHBOXSWfalse\else\@IEEEeqnarrayboxHBOXSWtrue\fi% +\@IEEEeqnarraybox} +\def\endIEEEeqnarraybox{\end@IEEEeqnarraybox} + +\@namedef{IEEEeqnarraybox*}{\@IEEEeqnarraystarformtrue\ifmmode\@IEEEeqnarrayboxHBOXSWfalse\else\@IEEEeqnarrayboxHBOXSWtrue\fi% +\@IEEEeqnarraybox} +\@namedef{endIEEEeqnarraybox*}{\end@IEEEeqnarraybox} + +% flag to indicate if the \IEEEeqnarraybox needs to put things into an hbox{$ $} +% for \vcenter in non-math mode +\newif\if@IEEEeqnarrayboxHBOXSW% +\@IEEEeqnarrayboxHBOXSWfalse + +\def\@IEEEeqnarraybox{\relax\@ifnextchar[{\@@IEEEeqnarraybox}{\@@IEEEeqnarraybox[\relax]}} +\def\@@IEEEeqnarraybox[#1]{\relax\@ifnextchar[{\@@@IEEEeqnarraybox[#1]}{\@@@IEEEeqnarraybox[#1][b]}} +\def\@@@IEEEeqnarraybox[#1][#2]{\relax\@ifnextchar[{\@@@@IEEEeqnarraybox[#1][#2]}{\@@@@IEEEeqnarraybox[#1][#2][\relax]}} + +% #1 = decl; #2 = t,b,c; #3 = width, #4 = col specs +\def\@@@@IEEEeqnarraybox[#1][#2][#3]#4{\@IEEEeqnarrayISinnerfalse % not yet within the lines of the halign + \@IEEEeqnarraymasterstrutsave% save current master strut values + \@IEEEeqnarraystrutsize{0pt}{0pt}[\relax]% turn off struts by default + \@IEEEeqnarrayusemasterstruttrue% use master strut till user asks otherwise + \IEEEvisiblestrutsfalse% diagnostic mode defaults to off + % no extra space unless the user specifically requests it + \lineskip=0pt\relax% + \lineskiplimit=0pt\relax% + \baselineskip=\normalbaselineskip\relax% + \jot=\IEEEnormaljot\relax% + \mathsurround\z@\relax% no extra spacing around math + % the default end glues are zero for an \IEEEeqnarraybox + \edef\@IEEEeqnarraycolSEPdefaultstart{\@IEEEeqnarraycolSEPzero}% default start glue + \edef\@IEEEeqnarraycolSEPdefaultend{\@IEEEeqnarraycolSEPzero}% default end glue + \edef\@IEEEeqnarraycolSEPdefaultmid{\@IEEEeqnarraycolSEPzero}% default inter-column glue + \@advanceIEEEeqncolcntfalse% do not advance the col counter for each col the user uses, + % used in \IEEEeqnarraymulticol and in the preamble build + \IEEEeqnarrayboxdecl\relax% allow a way for the user to make global overrides + #1\relax% allow user to override defaults + \let\\\@IEEEeqnarrayboxcr% replace newline with one that allows optional spacing + \@IEEEbuildpreamble #4\end\relax% build the preamble and put it into \@IEEEtrantmptoksA + % add an isolation column to the preamble to stop \\'s {} from getting into the last col + \ifnum\@IEEEeqnnumcols>0\relax\@IEEEappendtoksA{&}\fi% col separator for those after the first + \toks0={##}% + % add the isolation column to the preamble + \@IEEEappendtoksA{\tabskip\z@skip\bgroup\the\toks0\egroup}% + % set the starting tabskip glue as determined by the preamble build + \tabskip=\@IEEEBPstartglue\relax + % begin the alignment + \everycr{}% + % use only the very first token to determine the positioning + % this stops some problems when the user uses more than one letter, + % but is probably not worth the effort + % \noindent is used as a delimiter + \def\@IEEEgrabfirstoken##1##2\noindent{\let\@IEEEgrabbedfirstoken=##1}% + \@IEEEgrabfirstoken#2\relax\relax\noindent + % \@IEEEgrabbedfirstoken has the first token, the rest are discarded + % if we need to put things into and hbox and go into math mode, do so now + \if@IEEEeqnarrayboxHBOXSW \leavevmode \hbox \bgroup $\fi% + % use the appropriate vbox type + \if\@IEEEgrabbedfirstoken t\relax\vtop\else\if\@IEEEgrabbedfirstoken c\relax% + \vcenter\else\vbox\fi\fi\bgroup% + \@IEEEeqnarrayISinnertrue% commands are now within the lines + \ifx#3\relax\halign\else\halign to #3\relax\fi% + \bgroup + % "exspand" the preamble + \span\the\@IEEEtrantmptoksA\cr} + +% carry strut status and enter the isolation/strut column, +% exit from math mode if needed, and exit +\def\end@IEEEeqnarraybox{\@IEEEeqnarrayglobalizestrutstatus% carry strut status +&% enter isolation/strut column +\@IEEEeqnarrayinsertstrut% do strut if needed +\@IEEEeqnarraymasterstrutrestore% restore the previous master strut values +% reset the strut system for next IEEEeqnarray +% (sets local strut values back to previous master strut values) +\@IEEEeqnarraystrutreset% +% ensure last line, exit from halign, close vbox +\crcr\egroup\egroup% +% exit from math mode and close hbox if needed +\if@IEEEeqnarrayboxHBOXSW $\egroup\fi} + + + +% IEEEeqnarraybox uses a modifed \\ instead of the plain \cr to +% end rows. This allows for things like \\[vskip amount] +% This "cr" macros are modified versions those for LaTeX2e's eqnarray +% For IEEEeqnarraybox, \\* is the same as \\ +% the {\ifnum0=`} braces must be kept away from the last column to avoid +% altering spacing of its math, so we use & to advance to the isolation/strut column +% carry strut status into isolation/strut column +\def\@IEEEeqnarrayboxcr{\@IEEEeqnarrayglobalizestrutstatus% carry strut status +&% enter isolation/strut column +\@IEEEeqnarrayinsertstrut% do strut if needed +% reset the strut system for next line or IEEEeqnarray +\@IEEEeqnarraystrutreset% +{\ifnum0=`}\fi% +\@ifstar{\@IEEEeqnarrayboxYCR}{\@IEEEeqnarrayboxYCR}} + +% test and setup the optional argument to \\[] +\def\@IEEEeqnarrayboxYCR{\@testopt\@IEEEeqnarrayboxXCR\z@skip} + +% IEEEeqnarraybox does not automatically increase line spacing by \jot +\def\@IEEEeqnarrayboxXCR[#1]{\ifnum0=`{\fi}% +\cr\noalign{\if@IEEEeqnarraystarform\else\vskip\jot\fi\vskip#1\relax}} + + + +% starts the halign preamble build +\def\@IEEEbuildpreamble{\@IEEEtrantmptoksA={}% clear token register +\let\@IEEEBPcurtype=u%current column type is not yet known +\let\@IEEEBPprevtype=s%the previous column type was the start +\let\@IEEEBPnexttype=u%next column type is not yet known +% ensure these are valid +\def\@IEEEBPcurglue={0pt plus 0pt minus 0pt}% +\def\@IEEEBPcurcolname{@IEEEdefault}% name of current column definition +% currently acquired numerically referenced glue +% use a name that is easier to remember +\let\@IEEEBPcurnum=\@IEEEtrantmpcountA% +\@IEEEBPcurnum=0% +% tracks number of columns in the preamble +\@IEEEeqnnumcols=0% +% record the default end glues +\edef\@IEEEBPstartglue{\@IEEEeqnarraycolSEPdefaultstart}% +\edef\@IEEEBPendglue{\@IEEEeqnarraycolSEPdefaultend}% +% now parse the user's column specifications +\@@IEEEbuildpreamble} + + +% parses and builds the halign preamble +\def\@@IEEEbuildpreamble#1#2{\let\@@nextIEEEbuildpreamble=\@@IEEEbuildpreamble% +% use only the very first token to check the end +% \noindent is used as a delimiter as \end can be present here +\def\@IEEEgrabfirstoken##1##2\noindent{\let\@IEEEgrabbedfirstoken=##1}% +\@IEEEgrabfirstoken#1\relax\relax\noindent +\ifx\@IEEEgrabbedfirstoken\end\let\@@nextIEEEbuildpreamble=\@@IEEEfinishpreamble\else% +% identify current and next token type +\@IEEEgetcoltype{#1}{\@IEEEBPcurtype}{1}% current, error on invalid +\@IEEEgetcoltype{#2}{\@IEEEBPnexttype}{0}% next, no error on invalid next +% if curtype is a glue, get the glue def +\if\@IEEEBPcurtype g\@IEEEgetcurglue{#1}{\@IEEEBPcurglue}\fi% +% if curtype is a column, get the column def and set the current column name +\if\@IEEEBPcurtype c\@IEEEgetcurcol{#1}\fi% +% if curtype is a numeral, acquire the user defined glue +\if\@IEEEBPcurtype n\@IEEEprocessNcol{#1}\fi% +% process the acquired glue +\if\@IEEEBPcurtype g\@IEEEprocessGcol\fi% +% process the acquired col +\if\@IEEEBPcurtype c\@IEEEprocessCcol\fi% +% ready prevtype for next col spec. +\let\@IEEEBPprevtype=\@IEEEBPcurtype% +% be sure and put back the future token(s) as a group +\fi\@@nextIEEEbuildpreamble{#2}} + + +% executed just after preamble build is completed +% warn about zero cols, and if prevtype type = u, put in end tabskip glue +\def\@@IEEEfinishpreamble#1{\ifnum\@IEEEeqnnumcols<1\relax +\@IEEEclspkgerror{No column specifiers declared for IEEEeqnarray}% +{At least one column type must be declared for each IEEEeqnarray.}% +\fi%num cols less than 1 +%if last type undefined, set default end tabskip glue +\if\@IEEEBPprevtype u\@IEEEappendtoksA{\tabskip=\@IEEEBPendglue}\fi} + + +% Identify and return the column specifier's type code +\def\@IEEEgetcoltype#1#2#3{% +% use only the very first token to determine the type +% \noindent is used as a delimiter as \end can be present here +\def\@IEEEgrabfirstoken##1##2\noindent{\let\@IEEEgrabbedfirstoken=##1}% +\@IEEEgrabfirstoken#1\relax\relax\noindent +% \@IEEEgrabfirstoken has the first token, the rest are discarded +% n = number +% g = glue (any other char in catagory 12) +% c = letter +% e = \end +% u = undefined +% third argument: 0 = no error message, 1 = error on invalid char +\let#2=u\relax% assume invalid until know otherwise +\ifx\@IEEEgrabbedfirstoken\end\let#2=e\else +\ifcat\@IEEEgrabbedfirstoken\relax\else% screen out control sequences +\if0\@IEEEgrabbedfirstoken\let#2=n\else +\if1\@IEEEgrabbedfirstoken\let#2=n\else +\if2\@IEEEgrabbedfirstoken\let#2=n\else +\if3\@IEEEgrabbedfirstoken\let#2=n\else +\if4\@IEEEgrabbedfirstoken\let#2=n\else +\if5\@IEEEgrabbedfirstoken\let#2=n\else +\if6\@IEEEgrabbedfirstoken\let#2=n\else +\if7\@IEEEgrabbedfirstoken\let#2=n\else +\if8\@IEEEgrabbedfirstoken\let#2=n\else +\if9\@IEEEgrabbedfirstoken\let#2=n\else +\ifcat,\@IEEEgrabbedfirstoken\let#2=g\relax +\else\ifcat a\@IEEEgrabbedfirstoken\let#2=c\relax\fi\fi\fi\fi\fi\fi\fi\fi\fi\fi\fi\fi\fi\fi +\if#2u\relax +\if0\noexpand#3\relax\else\@IEEEclspkgerror{Invalid character in column specifications}% +{Only letters, numerals and certain other symbols are allowed \MessageBreak +as IEEEeqnarray column specifiers.}\fi\fi} + + +% identify the current letter referenced column +% if invalid, use a default column +\def\@IEEEgetcurcol#1{\expandafter\ifx\csname @IEEEeqnarraycolDEF#1\endcsname\@IEEEeqnarraycolisdefined% +\def\@IEEEBPcurcolname{#1}\else% invalid column name +\@IEEEclspkgerror{Invalid column type "#1" in column specifications.\MessageBreak +Using a default centering column instead}% +{You must define IEEEeqnarray column types before use.}% +\def\@IEEEBPcurcolname{@IEEEdefault}\fi} + + +% identify and return the predefined (punctuation) glue value +\def\@IEEEgetcurglue#1#2{% +% ! = \! (neg small) -0.16667em (-3/18 em) +% , = \, (small) 0.16667em ( 3/18 em) +% : = \: (med) 0.22222em ( 4/18 em) +% ; = \; (large) 0.27778em ( 5/18 em) +% ' = \quad 1em +% " = \qquad 2em +% . = 0.5\arraycolsep +% / = \arraycolsep +% ? = 2\arraycolsep +% * = 1fil +% + = \@IEEEeqnarraycolSEPcenter +% - = \@IEEEeqnarraycolSEPzero +% Note that all em values are referenced to the math font (textfont2) fontdimen6 +% value for 1em. +% +% use only the very first token to determine the type +% this prevents errant tokens from getting in the main text +% \noindent is used as a delimiter here +\def\@IEEEgrabfirstoken##1##2\noindent{\let\@IEEEgrabbedfirstoken=##1}% +\@IEEEgrabfirstoken#1\relax\relax\noindent +% get the math font 1em value +% LaTeX2e's NFSS2 does not preload the fonts, but \IEEEeqnarray needs +% to gain access to the math (\textfont2) font's spacing parameters. +% So we create a bogus box here that uses the math font to ensure +% that \textfont2 is loaded and ready. If this is not done, +% the \textfont2 stuff here may not work. +% Thanks to Bernd Raichle for his 1997 post on this topic. +{\setbox0=\hbox{$\displaystyle\relax$}}% +% fontdimen6 has the width of 1em (a quad). +\@IEEEtrantmpdimenA=\fontdimen6\textfont2\relax% +% identify the glue value based on the first token +% we discard anything after the first +\if!\@IEEEgrabbedfirstoken\@IEEEtrantmpdimenA=-0.16667\@IEEEtrantmpdimenA\edef#2{\the\@IEEEtrantmpdimenA}\else +\if,\@IEEEgrabbedfirstoken\@IEEEtrantmpdimenA=0.16667\@IEEEtrantmpdimenA\edef#2{\the\@IEEEtrantmpdimenA}\else +\if:\@IEEEgrabbedfirstoken\@IEEEtrantmpdimenA=0.22222\@IEEEtrantmpdimenA\edef#2{\the\@IEEEtrantmpdimenA}\else +\if;\@IEEEgrabbedfirstoken\@IEEEtrantmpdimenA=0.27778\@IEEEtrantmpdimenA\edef#2{\the\@IEEEtrantmpdimenA}\else +\if'\@IEEEgrabbedfirstoken\@IEEEtrantmpdimenA=1\@IEEEtrantmpdimenA\edef#2{\the\@IEEEtrantmpdimenA}\else +\if"\@IEEEgrabbedfirstoken\@IEEEtrantmpdimenA=2\@IEEEtrantmpdimenA\edef#2{\the\@IEEEtrantmpdimenA}\else +\if.\@IEEEgrabbedfirstoken\@IEEEtrantmpdimenA=0.5\arraycolsep\edef#2{\the\@IEEEtrantmpdimenA}\else +\if/\@IEEEgrabbedfirstoken\edef#2{\the\arraycolsep}\else +\if?\@IEEEgrabbedfirstoken\@IEEEtrantmpdimenA=2\arraycolsep\edef#2{\the\@IEEEtrantmpdimenA}\else +\if *\@IEEEgrabbedfirstoken\edef#2{0pt plus 1fil minus 0pt}\else +\if+\@IEEEgrabbedfirstoken\edef#2{\@IEEEeqnarraycolSEPcenter}\else +\if-\@IEEEgrabbedfirstoken\edef#2{\@IEEEeqnarraycolSEPzero}\else +\edef#2{\@IEEEeqnarraycolSEPzero}% +\@IEEEclspkgerror{Invalid predefined inter-column glue type "#1" in\MessageBreak +column specifications. Using a default value of\MessageBreak +0pt instead}% +{Only !,:;'"./?*+ and - are valid predefined glue types in the\MessageBreak +IEEEeqnarray column specifications.}\fi\fi\fi\fi\fi\fi\fi\fi\fi\fi\fi\fi} + + + +% process a numerical digit from the column specification +% and look up the corresponding user defined glue value +% can transform current type from n to g or a as the user defined glue is acquired +\def\@IEEEprocessNcol#1{\if\@IEEEBPprevtype g% +\@IEEEclspkgerror{Back-to-back inter-column glue specifiers in column\MessageBreak +specifications. Ignoring consecutive glue specifiers\MessageBreak +after the first}% +{You cannot have two or more glue types next to each other\MessageBreak +in the IEEEeqnarray column specifications.}% +\let\@IEEEBPcurtype=a% abort this glue, future digits will be discarded +\@IEEEBPcurnum=0\relax% +\else% if we previously aborted a glue +\if\@IEEEBPprevtype a\@IEEEBPcurnum=0\let\@IEEEBPcurtype=a%maintain digit abortion +\else%acquire this number +% save the previous type before the numerical digits started +\if\@IEEEBPprevtype n\else\let\@IEEEBPprevsavedtype=\@IEEEBPprevtype\fi% +\multiply\@IEEEBPcurnum by 10\relax% +\advance\@IEEEBPcurnum by #1\relax% add in number, \relax is needed to stop TeX's number scan +\if\@IEEEBPnexttype n\else%close acquisition +\expandafter\ifx\csname @IEEEeqnarraycolSEPDEF\expandafter\romannumeral\number\@IEEEBPcurnum\endcsname\@IEEEeqnarraycolisdefined% +\edef\@IEEEBPcurglue{\csname @IEEEeqnarraycolSEP\expandafter\romannumeral\number\@IEEEBPcurnum\endcsname}% +\else%user glue not defined +\@IEEEclspkgerror{Invalid user defined inter-column glue type "\number\@IEEEBPcurnum" in\MessageBreak +column specifications. Using a default value of\MessageBreak +0pt instead}% +{You must define all IEEEeqnarray numerical inter-column glue types via\MessageBreak +\string\IEEEeqnarraydefcolsep \space before they are used in column specifications.}% +\edef\@IEEEBPcurglue{\@IEEEeqnarraycolSEPzero}% +\fi% glue defined or not +\let\@IEEEBPcurtype=g% change the type to reflect the acquired glue +\let\@IEEEBPprevtype=\@IEEEBPprevsavedtype% restore the prev type before this number glue +\@IEEEBPcurnum=0\relax%ready for next acquisition +\fi%close acquisition, get glue +\fi%discard or acquire number +\fi%prevtype glue or not +} + + +% process an acquired glue +% add any acquired column/glue pair to the preamble +\def\@IEEEprocessGcol{\if\@IEEEBPprevtype a\let\@IEEEBPcurtype=a%maintain previous glue abortions +\else +% if this is the start glue, save it, but do nothing else +% as this is not used in the preamble, but before +\if\@IEEEBPprevtype s\edef\@IEEEBPstartglue{\@IEEEBPcurglue}% +\else%not the start glue +\if\@IEEEBPprevtype g%ignore if back to back glues +\@IEEEclspkgerror{Back-to-back inter-column glue specifiers in column\MessageBreak +specifications. Ignoring consecutive glue specifiers\MessageBreak +after the first}% +{You cannot have two or more glue types next to each other\MessageBreak +in the IEEEeqnarray column specifications.}% +\let\@IEEEBPcurtype=a% abort this glue +\else% not a back to back glue +\if\@IEEEBPprevtype c\relax% if the previoustype was a col, add column/glue pair to preamble +\ifnum\@IEEEeqnnumcols>0\relax\@IEEEappendtoksA{&}\fi +\toks0={##}% +% make preamble advance col counter if this environment needs this +\if@advanceIEEEeqncolcnt\@IEEEappendtoksA{\global\advance\@IEEEeqncolcnt by 1\relax}\fi +% insert the column defintion into the preamble, being careful not to expand +% the column definition +\@IEEEappendtoksA{\tabskip=\@IEEEBPcurglue}% +\@IEEEappendNOEXPANDtoksA{\begingroup\csname @IEEEeqnarraycolPRE}% +\@IEEEappendtoksA{\@IEEEBPcurcolname}% +\@IEEEappendNOEXPANDtoksA{\endcsname}% +\@IEEEappendtoksA{\the\toks0}% +\@IEEEappendNOEXPANDtoksA{\relax\relax\relax\relax\relax% +\relax\relax\relax\relax\relax\csname @IEEEeqnarraycolPOST}% +\@IEEEappendtoksA{\@IEEEBPcurcolname}% +\@IEEEappendNOEXPANDtoksA{\endcsname\relax\relax\relax\relax\relax% +\relax\relax\relax\relax\relax\endgroup}% +\advance\@IEEEeqnnumcols by 1\relax%one more column in the preamble +\else% error: non-start glue with no pending column +\@IEEEclspkgerror{Inter-column glue specifier without a prior column\MessageBreak +type in the column specifications. Ignoring this glue\MessageBreak +specifier}% +{Except for the first and last positions, glue can be placed only\MessageBreak +between column types.}% +\let\@IEEEBPcurtype=a% abort this glue +\fi% previous was a column +\fi% back-to-back glues +\fi% is start column glue +\fi% prev type not a +} + + +% process an acquired letter referenced column and, if necessary, add it to the preamble +\def\@IEEEprocessCcol{\if\@IEEEBPnexttype g\else +\if\@IEEEBPnexttype n\else +% we have a column followed by something other than a glue (or numeral glue) +% so we must add this column to the preamble now +\ifnum\@IEEEeqnnumcols>0\relax\@IEEEappendtoksA{&}\fi%col separator for those after the first +\if\@IEEEBPnexttype e\@IEEEappendtoksA{\tabskip=\@IEEEBPendglue\relax}\else%put in end glue +\@IEEEappendtoksA{\tabskip=\@IEEEeqnarraycolSEPdefaultmid\relax}\fi% or default mid glue +\toks0={##}% +% make preamble advance col counter if this environment needs this +\if@advanceIEEEeqncolcnt\@IEEEappendtoksA{\global\advance\@IEEEeqncolcnt by 1\relax}\fi +% insert the column definition into the preamble, being careful not to expand +% the column definition +\@IEEEappendNOEXPANDtoksA{\begingroup\csname @IEEEeqnarraycolPRE}% +\@IEEEappendtoksA{\@IEEEBPcurcolname}% +\@IEEEappendNOEXPANDtoksA{\endcsname}% +\@IEEEappendtoksA{\the\toks0}% +\@IEEEappendNOEXPANDtoksA{\relax\relax\relax\relax\relax% +\relax\relax\relax\relax\relax\csname @IEEEeqnarraycolPOST}% +\@IEEEappendtoksA{\@IEEEBPcurcolname}% +\@IEEEappendNOEXPANDtoksA{\endcsname\relax\relax\relax\relax\relax% +\relax\relax\relax\relax\relax\endgroup}% +\advance\@IEEEeqnnumcols by 1\relax%one more column in the preamble +\fi%next type not numeral +\fi%next type not glue +} + + +%% +%% END OF IEEEeqnarry DEFINITIONS +%% + + + + +% set up the running headings, this complex because of all the different +% modes IEEEtran supports +\if@twoside + \ifCLASSOPTIONtechnote + \def\ps@headings{% + \def\@oddhead{\hbox{}\scriptsize\leftmark \hfil \thepage} + \def\@evenhead{\scriptsize\thepage \hfil \leftmark\hbox{}} + \ifCLASSOPTIONdraftcls + \ifCLASSOPTIONdraftclsnofoot + \def\@oddfoot{}\def\@evenfoot{}% + \else + \def\@oddfoot{\scriptsize\@date\hfil DRAFT} + \def\@evenfoot{\scriptsize DRAFT\hfil\@date} + \fi + \else + \def\@oddfoot{}\def\@evenfoot{} + \fi} + \else % not a technote + \def\ps@headings{% + \ifCLASSOPTIONconference + \def\@oddhead{} + \def\@evenhead{} + \else + \def\@oddhead{\hbox{}\scriptsize\rightmark \hfil \thepage} + \def\@evenhead{\scriptsize\thepage \hfil \leftmark\hbox{}} + \fi + \ifCLASSOPTIONdraftcls + \def\@oddhead{\hbox{}\scriptsize\rightmark \hfil \thepage} + \def\@evenhead{\scriptsize\thepage \hfil \leftmark\hbox{}} + \ifCLASSOPTIONdraftclsnofoot + \def\@oddfoot{}\def\@evenfoot{}% + \else + \def\@oddfoot{\scriptsize\@date\hfil DRAFT} + \def\@evenfoot{\scriptsize DRAFT\hfil\@date} + \fi + \else + \def\@oddfoot{}\def\@evenfoot{}% + \fi} + \fi +\else % single side +\def\ps@headings{% + \ifCLASSOPTIONconference + \def\@oddhead{} + \def\@evenhead{} + \else + \def\@oddhead{\hbox{}\scriptsize\leftmark \hfil \thepage} + \def\@evenhead{} + \fi + \ifCLASSOPTIONdraftcls + \def\@oddhead{\hbox{}\scriptsize\leftmark \hfil \thepage} + \def\@evenhead{} + \ifCLASSOPTIONdraftclsnofoot + \def\@oddfoot{} + \else + \def\@oddfoot{\scriptsize \@date \hfil DRAFT} + \fi + \else + \def\@oddfoot{} + \fi + \def\@evenfoot{}} +\fi + + +% title page style +\def\ps@IEEEtitlepagestyle{\def\@oddfoot{}\def\@evenfoot{}% +\ifCLASSOPTIONconference + \def\@oddhead{}% + \def\@evenhead{}% +\else + \def\@oddhead{\hbox{}\scriptsize\leftmark \hfil \thepage}% + \def\@evenhead{\scriptsize\thepage \hfil \leftmark\hbox{}}% +\fi +\ifCLASSOPTIONdraftcls + \def\@oddhead{\hbox{}\scriptsize\leftmark \hfil \thepage}% + \def\@evenhead{\scriptsize\thepage \hfil \leftmark\hbox{}}% + \ifCLASSOPTIONdraftclsnofoot\else + \def\@oddfoot{\scriptsize \@date\hfil DRAFT}% + \def\@evenfoot{\scriptsize DRAFT\hfil \@date}% + \fi +\else + % all non-draft mode footers + \if@IEEEusingpubid + % for title pages that are using a pubid + % do not repeat pubid if using peer review option + \ifCLASSOPTIONpeerreview + \else + \footskip 0pt% + \ifCLASSOPTIONcompsoc + \def\@oddfoot{\hss\normalfont\scriptsize\raisebox{-1.5\@IEEEnormalsizeunitybaselineskip}[0ex][0ex]{\@IEEEpubid}\hss}% + \def\@evenfoot{\hss\normalfont\scriptsize\raisebox{-1.5\@IEEEnormalsizeunitybaselineskip}[0ex][0ex]{\@IEEEpubid}\hss}% + \else + \def\@oddfoot{\hss\normalfont\footnotesize\raisebox{1.5ex}[1.5ex]{\@IEEEpubid}\hss}% + \def\@evenfoot{\hss\normalfont\footnotesize\raisebox{1.5ex}[1.5ex]{\@IEEEpubid}\hss}% + \fi + \fi + \fi +\fi} + + +% peer review cover page style +\def\ps@IEEEpeerreviewcoverpagestyle{% +\def\@oddhead{}\def\@evenhead{}% +\def\@oddfoot{}\def\@evenfoot{}% +\ifCLASSOPTIONdraftcls + \ifCLASSOPTIONdraftclsnofoot\else + \def\@oddfoot{\scriptsize \@date\hfil DRAFT}% + \def\@evenfoot{\scriptsize DRAFT\hfil \@date}% + \fi +\else + % non-draft mode footers + \if@IEEEusingpubid + \footskip 0pt% + \ifCLASSOPTIONcompsoc + \def\@oddfoot{\hss\normalfont\scriptsize\raisebox{-1.5\@IEEEnormalsizeunitybaselineskip}[0ex][0ex]{\@IEEEpubid}\hss}% + \def\@evenfoot{\hss\normalfont\scriptsize\raisebox{-1.5\@IEEEnormalsizeunitybaselineskip}[0ex][0ex]{\@IEEEpubid}\hss}% + \else + \def\@oddfoot{\hss\normalfont\footnotesize\raisebox{1.5ex}[1.5ex]{\@IEEEpubid}\hss}% + \def\@evenfoot{\hss\normalfont\footnotesize\raisebox{1.5ex}[1.5ex]{\@IEEEpubid}\hss}% + \fi + \fi +\fi} + + +% start with empty headings +\def\rightmark{}\def\leftmark{} + + +%% Defines the command for putting the header. \footernote{TEXT} is the same +%% as \markboth{TEXT}{TEXT}. +%% Note that all the text is forced into uppercase, if you have some text +%% that needs to be in lower case, for instance et. al., then either manually +%% set \leftmark and \rightmark or use \MakeLowercase{et. al.} within the +%% arguments to \markboth. +\def\markboth#1#2{\def\leftmark{\@IEEEcompsoconly{\sffamily}\MakeUppercase{#1}}% +\def\rightmark{\@IEEEcompsoconly{\sffamily}\MakeUppercase{#2}}} +\def\footernote#1{\markboth{#1}{#1}} + +\def\today{\ifcase\month\or + January\or February\or March\or April\or May\or June\or + July\or August\or September\or October\or November\or December\fi + \space\number\day, \number\year} + + + + +%% CITATION AND BIBLIOGRAPHY COMMANDS +%% +%% V1.6 no longer supports the older, nonstandard \shortcite and \citename setup stuff +% +% +% Modify Latex2e \@citex to separate citations with "], [" +\def\@citex[#1]#2{% + \let\@citea\@empty + \@cite{\@for\@citeb:=#2\do + {\@citea\def\@citea{], [}% + \edef\@citeb{\expandafter\@firstofone\@citeb\@empty}% + \if@filesw\immediate\write\@auxout{\string\citation{\@citeb}}\fi + \@ifundefined{b@\@citeb}{\mbox{\reset@font\bfseries ?}% + \G@refundefinedtrue + \@latex@warning + {Citation `\@citeb' on page \thepage \space undefined}}% + {\hbox{\csname b@\@citeb\endcsname}}}}{#1}} + +% V1.6 we create hooks for the optional use of Donald Arseneau's +% cite.sty package. cite.sty is "smart" and will notice that the +% following format controls are already defined and will not +% redefine them. The result will be the proper sorting of the +% citation numbers and auto detection of 3 or more entry "ranges" - +% all in IEEE style: [1], [2], [5]--[7], [12] +% This also allows for an optional note, i.e., \cite[mynote]{..}. +% If the \cite with note has more than one reference, the note will +% be applied to the last of the listed references. It is generally +% desired that if a note is given, only one reference is listed in +% that \cite. +% Thanks to Mr. Arseneau for providing the required format arguments +% to produce the IEEE style. +\def\citepunct{], [} +\def\citedash{]--[} + +% V1.7 default to using same font for urls made by url.sty +\AtBeginDocument{\csname url@samestyle\endcsname} + +% V1.6 class files should always provide these +\def\newblock{\hskip .11em\@plus.33em\@minus.07em} +\let\@openbib@code\@empty + + +% Provide support for the control entries of IEEEtran.bst V1.00 and later. +% V1.7 optional argument allows for a different aux file to be specified in +% order to handle multiple bibliographies. For example, with multibib.sty: +% \newcites{sec}{Secondary Literature} +% \bstctlcite[@auxoutsec]{BSTcontrolhak} +\def\bstctlcite{\@ifnextchar[{\@bstctlcite}{\@bstctlcite[@auxout]}} +\def\@bstctlcite[#1]#2{\@bsphack + \@for\@citeb:=#2\do{% + \edef\@citeb{\expandafter\@firstofone\@citeb}% + \if@filesw\immediate\write\csname #1\endcsname{\string\citation{\@citeb}}\fi}% + \@esphack} + +% V1.6 provide a way for a user to execute a command just before +% a given reference number - used to insert a \newpage to balance +% the columns on the last page +\edef\@IEEEtriggerrefnum{0} % the default of zero means that + % the command is not executed +\def\@IEEEtriggercmd{\newpage} + +% allow the user to alter the triggered command +\long\def\IEEEtriggercmd#1{\long\def\@IEEEtriggercmd{#1}} + +% allow user a way to specify the reference number just before the +% command is executed +\def\IEEEtriggeratref#1{\@IEEEtrantmpcountA=#1% +\edef\@IEEEtriggerrefnum{\the\@IEEEtrantmpcountA}}% + +% trigger command at the given reference +\def\@IEEEbibitemprefix{\@IEEEtrantmpcountA=\@IEEEtriggerrefnum\relax% +\advance\@IEEEtrantmpcountA by -1\relax% +\ifnum\c@enumiv=\@IEEEtrantmpcountA\relax\@IEEEtriggercmd\relax\fi} + + +\def\@biblabel#1{[#1]} + +% compsoc journals left align the reference numbers +\@IEEEcompsocnotconfonly{\def\@biblabel#1{[#1]\hfill}} + +% controls bib item spacing +\def\IEEEbibitemsep{2.5pt plus .5pt} + +\@IEEEcompsocconfonly{\def\IEEEbibitemsep{1\baselineskip plus 0.25\baselineskip minus 0.25\baselineskip}} + + +\def\thebibliography#1{\section*{\refname}% + \addcontentsline{toc}{section}{\refname}% + % V1.6 add some rubber space here and provide a command trigger + \footnotesize\@IEEEcompsocconfonly{\small}\vskip 0.3\baselineskip plus 0.1\baselineskip minus 0.1\baselineskip% + \list{\@biblabel{\@arabic\c@enumiv}}% + {\settowidth\labelwidth{\@biblabel{#1}}% + \leftmargin\labelwidth + \labelsep 1em + \advance\leftmargin\labelsep\relax + \itemsep \IEEEbibitemsep\relax + \usecounter{enumiv}% + \let\p@enumiv\@empty + \renewcommand\theenumiv{\@arabic\c@enumiv}}% + \let\@IEEElatexbibitem\bibitem% + \def\bibitem{\@IEEEbibitemprefix\@IEEElatexbibitem}% +\def\newblock{\hskip .11em plus .33em minus .07em}% +% originally: +% \sloppy\clubpenalty4000\widowpenalty4000% +% by adding the \interlinepenalty here, we make it more +% difficult, but not impossible, for LaTeX to break within a reference. +% IEEE almost never breaks a reference (but they do it more often with +% technotes). You may get an underfull vbox warning around the bibliography, +% but the final result will be much more like what IEEE will publish. +% MDS 11/2000 +\ifCLASSOPTIONtechnote\sloppy\clubpenalty4000\widowpenalty4000\interlinepenalty100% +\else\sloppy\clubpenalty4000\widowpenalty4000\interlinepenalty500\fi% + \sfcode`\.=1000\relax} +\let\endthebibliography=\endlist + + + + +% TITLE PAGE COMMANDS +% +% +% \IEEEmembership is used to produce the sublargesize italic font used to indicate author +% IEEE membership. compsoc uses a large size sans slant font +\def\IEEEmembership#1{{\@IEEEnotcompsoconly{\sublargesize}\normalfont\@IEEEcompsoconly{\sffamily}\textit{#1}}} + + +% \IEEEauthorrefmark{} produces a footnote type symbol to indicate author affiliation. +% When given an argument of 1 to 9, \IEEEauthorrefmark{} follows the standard LaTeX footnote +% symbol sequence convention. However, for arguments 10 and above, \IEEEauthorrefmark{} +% reverts to using lower case roman numerals, so it cannot overflow. Do note that you +% cannot use \footnotemark[] in place of \IEEEauthorrefmark{} within \author as the footnote +% symbols will have been turned off to prevent \thanks from creating footnote marks. +% \IEEEauthorrefmark{} produces a symbol that appears to LaTeX as having zero vertical +% height - this allows for a more compact line packing, but the user must ensure that +% the interline spacing is large enough to prevent \IEEEauthorrefmark{} from colliding +% with the text above. +% V1.7 make this a robust command +\DeclareRobustCommand*{\IEEEauthorrefmark}[1]{\raisebox{0pt}[0pt][0pt]{\textsuperscript{\footnotesize\ensuremath{\ifcase#1\or *\or \dagger\or \ddagger\or% + \mathsection\or \mathparagraph\or \|\or **\or \dagger\dagger% + \or \ddagger\ddagger \else\textsuperscript{\expandafter\romannumeral#1}\fi}}}} + + +% FONT CONTROLS AND SPACINGS FOR CONFERENCE MODE AUTHOR NAME AND AFFILIATION BLOCKS +% +% The default font styles for the author name and affiliation blocks (confmode) +\def\@IEEEauthorblockNstyle{\normalfont\@IEEEcompsocnotconfonly{\sffamily}\sublargesize\@IEEEcompsocconfonly{\large}} +\def\@IEEEauthorblockAstyle{\normalfont\@IEEEcompsocnotconfonly{\sffamily}\@IEEEcompsocconfonly{\itshape}\normalsize\@IEEEcompsocconfonly{\large}} +% The default if the user does not use an author block +\def\@IEEEauthordefaulttextstyle{\normalfont\@IEEEcompsocnotconfonly{\sffamily}\sublargesize} + +% spacing from title (or special paper notice) to author name blocks (confmode) +% can be negative +\def\@IEEEauthorblockconfadjspace{-0.25em} +% compsoc conferences need more space here +\@IEEEcompsocconfonly{\def\@IEEEauthorblockconfadjspace{0.75\@IEEEnormalsizeunitybaselineskip}} +\ifCLASSOPTIONconference\def\@IEEEauthorblockconfadjspace{20pt}\fi + +% spacing between name and affiliation blocks (confmode) +% This can be negative. +% IEEE doesn't want any added spacing here, but I will leave these +% controls in place in case they ever change their mind. +% Personally, I like 0.75ex. +%\def\@IEEEauthorblockNtopspace{0.75ex} +%\def\@IEEEauthorblockAtopspace{0.75ex} +\def\@IEEEauthorblockNtopspace{0.0ex} +\def\@IEEEauthorblockAtopspace{0.0ex} +% baseline spacing within name and affiliation blocks (confmode) +% must be positive, spacings below certain values will make +% the position of line of text sensitive to the contents of the +% line above it i.e., whether or not the prior line has descenders, +% subscripts, etc. For this reason it is a good idea to keep +% these above 2.6ex +\def\@IEEEauthorblockNinterlinespace{2.6ex} +\def\@IEEEauthorblockAinterlinespace{2.75ex} + +% This tracks the required strut size. +% See the \@IEEEauthorhalign command for the actual default value used. +\def\@IEEEauthorblockXinterlinespace{2.7ex} + +% variables to retain font size and style across groups +% values given here have no effect as they will be overwritten later +\gdef\@IEEESAVESTATEfontsize{10} +\gdef\@IEEESAVESTATEfontbaselineskip{12} +\gdef\@IEEESAVESTATEfontencoding{OT1} +\gdef\@IEEESAVESTATEfontfamily{ptm} +\gdef\@IEEESAVESTATEfontseries{m} +\gdef\@IEEESAVESTATEfontshape{n} + +% saves the current font attributes +\def\@IEEEcurfontSAVE{\global\let\@IEEESAVESTATEfontsize\f@size% +\global\let\@IEEESAVESTATEfontbaselineskip\f@baselineskip% +\global\let\@IEEESAVESTATEfontencoding\f@encoding% +\global\let\@IEEESAVESTATEfontfamily\f@family% +\global\let\@IEEESAVESTATEfontseries\f@series% +\global\let\@IEEESAVESTATEfontshape\f@shape} + +% restores the saved font attributes +\def\@IEEEcurfontRESTORE{\fontsize{\@IEEESAVESTATEfontsize}{\@IEEESAVESTATEfontbaselineskip}% +\fontencoding{\@IEEESAVESTATEfontencoding}% +\fontfamily{\@IEEESAVESTATEfontfamily}% +\fontseries{\@IEEESAVESTATEfontseries}% +\fontshape{\@IEEESAVESTATEfontshape}% +\selectfont} + + +% variable to indicate if the current block is the first block in the column +\newif\if@IEEEprevauthorblockincol \@IEEEprevauthorblockincolfalse + + +% the command places a strut with height and depth = \@IEEEauthorblockXinterlinespace +% we use this technique to have complete manual control over the spacing of the lines +% within the halign environment. +% We set the below baseline portion at 30%, the above +% baseline portion at 70% of the total length. +% Responds to changes in the document's \baselinestretch +\def\@IEEEauthorstrutrule{\@IEEEtrantmpdimenA\@IEEEauthorblockXinterlinespace% +\@IEEEtrantmpdimenA=\baselinestretch\@IEEEtrantmpdimenA% +\rule[-0.3\@IEEEtrantmpdimenA]{0pt}{\@IEEEtrantmpdimenA}} + + +% blocks to hold the authors' names and affilations. +% Makes formatting easy for conferences +% +% use real definitions in conference mode +% name block +\def\IEEEauthorblockN#1{\relax\@IEEEauthorblockNstyle% set the default text style +\gdef\@IEEEauthorblockXinterlinespace{0pt}% disable strut for spacer row +% the \expandafter hides the \cr in conditional tex, see the array.sty docs +% for details, probably not needed here as the \cr is in a macro +% do a spacer row if needed +\if@IEEEprevauthorblockincol\expandafter\@IEEEauthorblockNtopspaceline\fi +\global\@IEEEprevauthorblockincoltrue% we now have a block in this column +%restore the correct strut value +\gdef\@IEEEauthorblockXinterlinespace{\@IEEEauthorblockNinterlinespace}% +% input the author names +#1% +% end the row if the user did not already +\crcr} +% spacer row for names +\def\@IEEEauthorblockNtopspaceline{\cr\noalign{\vskip\@IEEEauthorblockNtopspace}} +% +% affiliation block +\def\IEEEauthorblockA#1{\relax\@IEEEauthorblockAstyle% set the default text style +\gdef\@IEEEauthorblockXinterlinespace{0pt}%disable strut for spacer row +% the \expandafter hides the \cr in conditional tex, see the array.sty docs +% for details, probably not needed here as the \cr is in a macro +% do a spacer row if needed +\if@IEEEprevauthorblockincol\expandafter\@IEEEauthorblockAtopspaceline\fi +\global\@IEEEprevauthorblockincoltrue% we now have a block in this column +%restore the correct strut value +\gdef\@IEEEauthorblockXinterlinespace{\@IEEEauthorblockAinterlinespace}% +% input the author affiliations +#1% +% end the row if the user did not already +\crcr} +% spacer row for affiliations +\def\@IEEEauthorblockAtopspaceline{\cr\noalign{\vskip\@IEEEauthorblockAtopspace}} + + +% allow papers to compile even if author blocks are used in modes other +% than conference or peerreviewca. For such cases, we provide dummy blocks. +\ifCLASSOPTIONconference +\else + \ifCLASSOPTIONpeerreviewca\else + % not conference or peerreviewca mode + \def\IEEEauthorblockN#1{#1}% + \def\IEEEauthorblockA#1{#1}% + \fi +\fi + + + +% we provide our own halign so as not to have to depend on tabular +\def\@IEEEauthorhalign{\@IEEEauthordefaulttextstyle% default text style + \lineskip=0pt\relax% disable line spacing + \lineskiplimit=0pt\relax% + \baselineskip=0pt\relax% + \@IEEEcurfontSAVE% save the current font + \mathsurround\z@\relax% no extra spacing around math + \let\\\@IEEEauthorhaligncr% replace newline with halign friendly one + \tabskip=0pt\relax% no column spacing + \everycr{}% ensure no problems here + \@IEEEprevauthorblockincolfalse% no author blocks yet + \def\@IEEEauthorblockXinterlinespace{2.7ex}% default interline space + \vtop\bgroup%vtop box + \halign\bgroup&\relax\hfil\@IEEEcurfontRESTORE\relax ##\relax + \hfil\@IEEEcurfontSAVE\@IEEEauthorstrutrule\cr} + +% ensure last line, exit from halign, close vbox +\def\end@IEEEauthorhalign{\crcr\egroup\egroup} + +% handle bogus star form +\def\@IEEEauthorhaligncr{{\ifnum0=`}\fi\@ifstar{\@@IEEEauthorhaligncr}{\@@IEEEauthorhaligncr}} + +% test and setup the optional argument to \\[] +\def\@@IEEEauthorhaligncr{\@testopt\@@@IEEEauthorhaligncr\z@skip} + +% end the line and do the optional spacer +\def\@@@IEEEauthorhaligncr[#1]{\ifnum0=`{\fi}\cr\noalign{\vskip#1\relax}} + + + +% flag to prevent multiple \and warning messages +\newif\if@IEEEWARNand +\@IEEEWARNandtrue + +% if in conference or peerreviewca modes, we support the use of \and as \author is a +% tabular environment, otherwise we warn the user that \and is invalid +% outside of conference or peerreviewca modes. +\def\and{\relax} % provide a bogus \and that we will then override + +\renewcommand{\and}[1][\relax]{\if@IEEEWARNand\typeout{** WARNING: \noexpand\and is valid only + when in conference or peerreviewca}\typeout{modes (line \the\inputlineno).}\fi\global\@IEEEWARNandfalse} + +\ifCLASSOPTIONconference% +\renewcommand{\and}[1][\hfill]{\end{@IEEEauthorhalign}#1\begin{@IEEEauthorhalign}}% +\fi +\ifCLASSOPTIONpeerreviewca +\renewcommand{\and}[1][\hfill]{\end{@IEEEauthorhalign}#1\begin{@IEEEauthorhalign}}% +\fi + + +% page clearing command +% based on LaTeX2e's \cleardoublepage, but allows different page styles +% for the inserted blank pages +\def\@IEEEcleardoublepage#1{\clearpage\if@twoside\ifodd\c@page\else +\hbox{}\thispagestyle{#1}\newpage\if@twocolumn\hbox{}\thispagestyle{#1}\newpage\fi\fi\fi} + + +% user command to invoke the title page +\def\maketitle{\par% + \begingroup% + \normalfont% + \def\thefootnote{}% the \thanks{} mark type is empty + \def\footnotemark{}% and kill space from \thanks within author + \let\@makefnmark\relax% V1.7, must *really* kill footnotemark to remove all \textsuperscript spacing as well. + \footnotesize% equal spacing between thanks lines + \footnotesep 0.7\baselineskip%see global setting of \footnotesep for more info + % V1.7 disable \thanks note indention for compsoc + \@IEEEcompsoconly{\long\def\@makefntext##1{\parindent 1em\noindent\hbox{\@makefnmark}##1}}% + \normalsize% + \ifCLASSOPTIONpeerreview + \newpage\global\@topnum\z@ \@maketitle\@IEEEstatictitlevskip\@IEEEaftertitletext% + \thispagestyle{IEEEpeerreviewcoverpagestyle}\@thanks% + \else + \if@twocolumn% + \ifCLASSOPTIONtechnote% + \newpage\global\@topnum\z@ \@maketitle\@IEEEstatictitlevskip\@IEEEaftertitletext% + \else + \twocolumn[\@maketitle\@IEEEstatictitlevskip\@IEEEaftertitletext]% + \fi + \else + \newpage\global\@topnum\z@ \@maketitle\@IEEEstatictitlevskip\@IEEEaftertitletext% + \fi + \thispagestyle{IEEEtitlepagestyle}\@thanks% + \fi + % pullup page for pubid if used. + \if@IEEEusingpubid + \enlargethispage{-\@IEEEpubidpullup}% + \fi + \endgroup + \setcounter{footnote}{0}\let\maketitle\relax\let\@maketitle\relax + \gdef\@thanks{}% + % v1.6b do not clear these as we will need the title again for peer review papers + % \gdef\@author{}\gdef\@title{}% + \let\thanks\relax} + + + +% V1.7 parbox to format \@IEEEcompsoctitleabstractindextext +\long\def\@IEEEcompsoctitleabstractindextextbox#1{\parbox{0.915\textwidth}{#1}} + +% formats the Title, authors names, affiliations and special paper notice +% THIS IS A CONTROLLED SPACING COMMAND! Do not allow blank lines or unintentional +% spaces to enter the definition - use % at the end of each line +\def\@maketitle{\newpage +\begingroup\centering +\ifCLASSOPTIONtechnote% technotes + {\bfseries\large\@IEEEcompsoconly{\sffamily}\@title\par}\vskip 1.3em{\lineskip .5em\@IEEEcompsoconly{\sffamily}\@author + \@IEEEspecialpapernotice\par{\@IEEEcompsoconly{\vskip 1.5em\relax + \@IEEEcompsoctitleabstractindextextbox{\@IEEEcompsoctitleabstractindextext}\par + \hfill\@IEEEcompsocdiamondline\hfill\hbox{}\par}}}\relax +\else% not a technote + \vskip0.2em{\Huge\@IEEEcompsoconly{\sffamily}\@IEEEcompsocconfonly{\normalfont\normalsize\vskip 2\@IEEEnormalsizeunitybaselineskip + \bfseries\Large}\@title\par}\vskip1.0em\par% + % V1.6 handle \author differently if in conference mode + \ifCLASSOPTIONconference% + {\@IEEEspecialpapernotice\mbox{}\vskip\@IEEEauthorblockconfadjspace% + \mbox{}\hfill\begin{@IEEEauthorhalign}\@author\end{@IEEEauthorhalign}\hfill\mbox{}\par}\relax + \else% peerreviewca, peerreview or journal + \ifCLASSOPTIONpeerreviewca + % peerreviewca handles author names just like conference mode + {\@IEEEcompsoconly{\sffamily}\@IEEEspecialpapernotice\mbox{}\vskip\@IEEEauthorblockconfadjspace% + \mbox{}\hfill\begin{@IEEEauthorhalign}\@author\end{@IEEEauthorhalign}\hfill\mbox{}\par + {\@IEEEcompsoconly{\vskip 1.5em\relax + \@IEEEcompsoctitleabstractindextextbox{\@IEEEcompsoctitleabstractindextext}\par\hfill + \@IEEEcompsocdiamondline\hfill\hbox{}\par}}}\relax + \else% journal or peerreview + {\lineskip.5em\@IEEEcompsoconly{\sffamily}\sublargesize\@author\@IEEEspecialpapernotice\par + {\@IEEEcompsoconly{\vskip 1.5em\relax + \@IEEEcompsoctitleabstractindextextbox{\@IEEEcompsoctitleabstractindextext}\par\hfill + \@IEEEcompsocdiamondline\hfill\hbox{}\par}}}\relax + \fi + \fi +\fi\par\endgroup} + + + +% V1.7 Computer Society "diamond line" which follows index terms for nonconference papers +\def\@IEEEcompsocdiamondline{\vrule depth 0pt height 0.5pt width 4cm\hspace{7.5pt}% +\raisebox{-3.5pt}{\fontfamily{pzd}\fontencoding{U}\fontseries{m}\fontshape{n}\fontsize{11}{12}\selectfont\char70}% +\hspace{7.5pt}\vrule depth 0pt height 0.5pt width 4cm\relax} + +% V1.7 standard LateX2e \thanks, but with \itshape under compsoc. Also make it a \long\def +% We also need to trigger the one-shot footnote rule +\def\@IEEEtriggeroneshotfootnoterule{\global\@IEEEenableoneshotfootnoteruletrue} + + +\long\def\thanks#1{\footnotemark + \protected@xdef\@thanks{\@thanks + \protect\footnotetext[\the\c@footnote]{\@IEEEcompsoconly{\itshape + \protect\@IEEEtriggeroneshotfootnoterule\relax}\ignorespaces#1}}} +\let\@thanks\@empty + +% V1.7 allow \author to contain \par's. This is needed to allow \thanks to contain \par. +\long\def\author#1{\gdef\@author{#1}} + + +% in addition to setting up IEEEitemize, we need to remove a baselineskip space above and +% below it because \list's \pars introduce blank lines because of the footnote struts. +\def\@IEEEsetupcompsocitemizelist{\def\labelitemi{$\bullet$}% +\setlength{\IEEElabelindent}{0pt}\setlength{\parskip}{0pt}% +\setlength{\partopsep}{0pt}\setlength{\topsep}{0.5\baselineskip}\vspace{-1\baselineskip}\relax} + + +% flag for fake non-compsoc \IEEEcompsocthanksitem - prevents line break on very first item +\newif\if@IEEEbreakcompsocthanksitem \@IEEEbreakcompsocthanksitemfalse + +\ifCLASSOPTIONcompsoc +% V1.7 compsoc bullet item \thanks +% also, we need to redefine this to destroy the argument in \@IEEEdynamictitlevspace +\long\def\IEEEcompsocitemizethanks#1{\relax\@IEEEbreakcompsocthanksitemfalse\footnotemark + \protected@xdef\@thanks{\@thanks + \protect\footnotetext[\the\c@footnote]{\itshape\protect\@IEEEtriggeroneshotfootnoterule + {\let\IEEEiedlistdecl\relax\protect\begin{IEEEitemize}[\protect\@IEEEsetupcompsocitemizelist]\ignorespaces#1\relax + \protect\end{IEEEitemize}}\protect\vspace{-1\baselineskip}}}} +\DeclareRobustCommand*{\IEEEcompsocthanksitem}{\item} +\else +% non-compsoc, allow for dual compilation via rerouting to normal \thanks +\long\def\IEEEcompsocitemizethanks#1{\thanks{#1}} +% redirect to "pseudo-par" \hfil\break\indent after swallowing [] from \IEEEcompsocthanksitem[] +\DeclareRobustCommand{\IEEEcompsocthanksitem}{\@ifnextchar [{\@IEEEthanksswallowoptionalarg}% +{\@IEEEthanksswallowoptionalarg[\relax]}} +% be sure and break only after first item, be sure and ignore spaces after optional argument +\def\@IEEEthanksswallowoptionalarg[#1]{\relax\if@IEEEbreakcompsocthanksitem\hfil\break +\indent\fi\@IEEEbreakcompsocthanksitemtrue\ignorespaces} +\fi + + +% V1.6b define the \IEEEpeerreviewmaketitle as needed +\ifCLASSOPTIONpeerreview +\def\IEEEpeerreviewmaketitle{\@IEEEcleardoublepage{empty}% +\ifCLASSOPTIONtwocolumn +\twocolumn[\@IEEEpeerreviewmaketitle\@IEEEdynamictitlevspace] +\else +\newpage\@IEEEpeerreviewmaketitle\@IEEEstatictitlevskip +\fi +\thispagestyle{IEEEtitlepagestyle}} +\else +% \IEEEpeerreviewmaketitle does nothing if peer review option has not been selected +\def\IEEEpeerreviewmaketitle{\relax} +\fi + +% peerreview formats the repeated title like the title in journal papers. +\def\@IEEEpeerreviewmaketitle{\begin{center}\@IEEEcompsoconly{\sffamily}% +\normalfont\normalsize\vskip0.2em{\Huge\@title\par}\vskip1.0em\par +\end{center}} + + + +% V1.6 +% this is a static rubber spacer between the title/authors and the main text +% used for single column text, or when the title appears in the first column +% of two column text (technotes). +\def\@IEEEstatictitlevskip{{\normalfont\normalsize +% adjust spacing to next text +% v1.6b handle peer review papers +\ifCLASSOPTIONpeerreview +% for peer review papers, the same value is used for both title pages +% regardless of the other paper modes + \vskip 1\baselineskip plus 0.375\baselineskip minus 0.1875\baselineskip +\else + \ifCLASSOPTIONconference% conference + \vskip 0.6\baselineskip + \else% + \ifCLASSOPTIONtechnote% technote + \vskip 1\baselineskip plus 0.375\baselineskip minus 0.1875\baselineskip% + \else% journal uses more space + \vskip 2.5\baselineskip plus 0.75\baselineskip minus 0.375\baselineskip% + \fi + \fi +\fi}} + + +% V1.6 +% This is a dynamically determined rigid spacer between the title/authors +% and the main text. This is used only for single column titles over two +% column text (most common) +% This is bit tricky because we have to ensure that the textheight of the +% main text is an integer multiple of \baselineskip +% otherwise underfull vbox problems may develop in the second column of the +% text on the titlepage +% The possible use of \IEEEpubid must also be taken into account. +\def\@IEEEdynamictitlevspace{{% + % we run within a group so that all the macros can be forgotten when we are done + \long\def\thanks##1{\relax}%don't allow \thanks to run when we evaluate the vbox height + \long\def\IEEEcompsocitemizethanks##1{\relax}%don't allow \IEEEcompsocitemizethanks to run when we evaluate the vbox height + \normalfont\normalsize% we declare more descriptive variable names + \let\@IEEEmaintextheight=\@IEEEtrantmpdimenA%height of the main text columns + \let\@IEEEINTmaintextheight=\@IEEEtrantmpdimenB%height of the main text columns with integer # lines + % set the nominal and minimum values for the title spacer + % the dynamic algorithm will not allow the spacer size to + % become less than \@IEEEMINtitlevspace - instead it will be + % lengthened + % default to journal values + \def\@IEEENORMtitlevspace{2.5\baselineskip}% + \def\@IEEEMINtitlevspace{2\baselineskip}% + % conferences and technotes need tighter spacing + \ifCLASSOPTIONconference%conference + \def\@IEEENORMtitlevspace{1\baselineskip}% + \def\@IEEEMINtitlevspace{0.75\baselineskip}% + \fi + \ifCLASSOPTIONtechnote%technote + \def\@IEEENORMtitlevspace{1\baselineskip}% + \def\@IEEEMINtitlevspace{0.75\baselineskip}% + \fi% + % get the height that the title will take up + \ifCLASSOPTIONpeerreview + \settoheight{\@IEEEmaintextheight}{\vbox{\hsize\textwidth \@IEEEpeerreviewmaketitle}}% + \else + \settoheight{\@IEEEmaintextheight}{\vbox{\hsize\textwidth \@maketitle}}% + \fi + \@IEEEmaintextheight=-\@IEEEmaintextheight% title takes away from maintext, so reverse sign + % add the height of the page textheight + \advance\@IEEEmaintextheight by \textheight% + % correct for title pages using pubid + \ifCLASSOPTIONpeerreview\else + % peerreview papers use the pubid on the cover page only. + % And the cover page uses a static spacer. + \if@IEEEusingpubid\advance\@IEEEmaintextheight by -\@IEEEpubidpullup\fi + \fi% + % subtract off the nominal value of the title bottom spacer + \advance\@IEEEmaintextheight by -\@IEEENORMtitlevspace% + % \topskip takes away some too + \advance\@IEEEmaintextheight by -\topskip% + % calculate the column height of the main text for lines + % now we calculate the main text height as if holding + % an integer number of \normalsize lines after the first + % and discard any excess fractional remainder + % we subtracted the first line, because the first line + % is placed \topskip into the maintext, not \baselineskip like the + % rest of the lines. + \@IEEEINTmaintextheight=\@IEEEmaintextheight% + \divide\@IEEEINTmaintextheight by \baselineskip% + \multiply\@IEEEINTmaintextheight by \baselineskip% + % now we calculate how much the title spacer height will + % have to be reduced from nominal (\@IEEEREDUCEmaintextheight is always + % a positive value) so that the maintext area will contain an integer + % number of normal size lines + % we change variable names here (to avoid confusion) as we no longer + % need \@IEEEINTmaintextheight and can reuse its dimen register + \let\@IEEEREDUCEmaintextheight=\@IEEEINTmaintextheight% + \advance\@IEEEREDUCEmaintextheight by -\@IEEEmaintextheight% + \advance\@IEEEREDUCEmaintextheight by \baselineskip% + % this is the calculated height of the spacer + % we change variable names here (to avoid confusion) as we no longer + % need \@IEEEmaintextheight and can reuse its dimen register + \let\@IEEECOMPENSATElen=\@IEEEmaintextheight% + \@IEEECOMPENSATElen=\@IEEENORMtitlevspace% set the nominal value + % we go with the reduced length if it is smaller than an increase + \ifdim\@IEEEREDUCEmaintextheight < 0.5\baselineskip\relax% + \advance\@IEEECOMPENSATElen by -\@IEEEREDUCEmaintextheight% + % if the resulting spacer is too small back out and go with an increase instead + \ifdim\@IEEECOMPENSATElen<\@IEEEMINtitlevspace\relax% + \advance\@IEEECOMPENSATElen by \baselineskip% + \fi% + \else% + % go with an increase because it is closer to the nominal than a decrease + \advance\@IEEECOMPENSATElen by -\@IEEEREDUCEmaintextheight% + \advance\@IEEECOMPENSATElen by \baselineskip% + \fi% + % set the calculated rigid spacer + \vspace{\@IEEECOMPENSATElen}}} + + + +% V1.6 +% we allow the user access to the last part of the title area +% useful in emergencies such as when a different spacing is needed +% This text is NOT compensated for in the dynamic sizer. +\let\@IEEEaftertitletext=\relax +\long\def\IEEEaftertitletext#1{\def\@IEEEaftertitletext{#1}} + +% V1.7 provide a way for users to enter abstract and keywords +% into the onecolumn title are. This text is compensated for +% in the dynamic sizer. +\let\@IEEEcompsoctitleabstractindextext=\relax +\long\def\IEEEcompsoctitleabstractindextext#1{\def\@IEEEcompsoctitleabstractindextext{#1}} +% V1.7 provide a way for users to get the \@IEEEcompsoctitleabstractindextext if +% not in compsoc journal mode - this way abstract and keywords can be placed +% in their conventional position if not in compsoc mode. +\def\IEEEdisplaynotcompsoctitleabstractindextext{% +\ifCLASSOPTIONcompsoc% display if compsoc conf +\ifCLASSOPTIONconference\@IEEEcompsoctitleabstractindextext\fi +\else% or if not compsoc +\@IEEEcompsoctitleabstractindextext\fi} + + +% command to allow alteration of baselinestretch, but only if the current +% baselineskip is unity. Used to tweak the compsoc abstract and keywords line spacing. +\def\@IEEEtweakunitybaselinestretch#1{{\def\baselinestretch{1}\selectfont +\global\@tempskipa\baselineskip}\ifnum\@tempskipa=\baselineskip% +\def\baselinestretch{#1}\selectfont\fi\relax} + + +% abstract and keywords are in \small, except +% for 9pt docs in which they are in \footnotesize +% Because 9pt docs use an 8pt footnotesize, \small +% becomes a rather awkward 8.5pt +\def\@IEEEabskeysecsize{\small} +\ifx\CLASSOPTIONpt\@IEEEptsizenine + \def\@IEEEabskeysecsize{\footnotesize} +\fi + +% compsoc journals use \footnotesize, compsoc conferences use normalsize +\@IEEEcompsoconly{\def\@IEEEabskeysecsize{\footnotesize}} +\@IEEEcompsocconfonly{\def\@IEEEabskeysecsize{\normalsize}} + + + + +% V1.6 have abstract and keywords strip leading spaces, pars and newlines +% so that spacing is more tightly controlled. +\def\abstract{\normalfont + \if@twocolumn + \par\@IEEEabskeysecsize\bfseries\leavevmode\kern-1pt\textit{\abstractname}---\relax + \else + \begin{center}\vspace{-1.78ex}\@IEEEabskeysecsize\textbf{\abstractname}\end{center}\quotation\@IEEEabskeysecsize + \fi\@IEEEgobbleleadPARNLSP} +% V1.6 IEEE wants only 1 pica from end of abstract to introduction heading when in +% conference mode (the heading already has this much above it) +\def\endabstract{\relax\ifCLASSOPTIONconference\vspace{0ex}\else\vspace{1.34ex}\fi\par\if@twocolumn\else\endquotation\fi + \normalfont\normalsize} + +\def\IEEEkeywords{\normalfont + \if@twocolumn + \@IEEEabskeysecsize\bfseries\leavevmode\kern-1pt\textit{\IEEEkeywordsname}---\relax + \else + \begin{center}\@IEEEabskeysecsize\textbf{\IEEEkeywordsname}\end{center}\quotation\@IEEEabskeysecsize + \fi\itshape\@IEEEgobbleleadPARNLSP} +\def\endIEEEkeywords{\relax\ifCLASSOPTIONtechnote\vspace{1.34ex}\else\vspace{0.5ex}\fi + \par\if@twocolumn\else\endquotation\fi% + \normalfont\normalsize} + +% V1.7 compsoc keywords index terms +\ifCLASSOPTIONcompsoc + \ifCLASSOPTIONconference% compsoc conference +\def\abstract{\normalfont + \begin{center}\@IEEEabskeysecsize\textbf{\large\abstractname}\end{center}\vskip 0.5\baselineskip plus 0.1\baselineskip minus 0.1\baselineskip + \if@twocolumn\else\quotation\fi\itshape\@IEEEabskeysecsize% + \par\@IEEEgobbleleadPARNLSP} +\def\IEEEkeywords{\normalfont\vskip 1.5\baselineskip plus 0.25\baselineskip minus 0.25\baselineskip + \begin{center}\@IEEEabskeysecsize\textbf{\large\IEEEkeywordsname}\end{center}\vskip 0.5\baselineskip plus 0.1\baselineskip minus 0.1\baselineskip + \if@twocolumn\else\quotation\fi\itshape\@IEEEabskeysecsize% + \par\@IEEEgobbleleadPARNLSP} + \else% compsoc not conference +\def\abstract{\normalfont\@IEEEtweakunitybaselinestretch{1.15}\sffamily + \if@twocolumn + \@IEEEabskeysecsize\noindent\textbf{\abstractname}---\relax + \else + \begin{center}\vspace{-1.78ex}\@IEEEabskeysecsize\textbf{\abstractname}\end{center}\quotation\@IEEEabskeysecsize% + \fi\@IEEEgobbleleadPARNLSP} +\def\IEEEkeywords{\normalfont\@IEEEtweakunitybaselinestretch{1.15}\sffamily + \if@twocolumn + \@IEEEabskeysecsize\vskip 0.5\baselineskip plus 0.25\baselineskip minus 0.25\baselineskip\noindent + \textbf{\IEEEkeywordsname}---\relax + \else + \begin{center}\@IEEEabskeysecsize\textbf{\IEEEkeywordsname}\end{center}\quotation\@IEEEabskeysecsize% + \fi\@IEEEgobbleleadPARNLSP} + \fi +\fi + + + +% gobbles all leading \, \\ and \par, upon finding first token that +% is not a \ , \\ or a \par, it ceases and returns that token +% +% used to strip leading \, \\ and \par from the input +% so that such things in the beginning of an environment will not +% affect the formatting of the text +\long\def\@IEEEgobbleleadPARNLSP#1{\let\@IEEEswallowthistoken=0% +\let\@IEEEgobbleleadPARNLSPtoken#1% +\let\@IEEEgobbleleadPARtoken=\par% +\let\@IEEEgobbleleadNLtoken=\\% +\let\@IEEEgobbleleadSPtoken=\ % +\def\@IEEEgobbleleadSPMACRO{\ }% +\ifx\@IEEEgobbleleadPARNLSPtoken\@IEEEgobbleleadPARtoken% +\let\@IEEEswallowthistoken=1% +\fi% +\ifx\@IEEEgobbleleadPARNLSPtoken\@IEEEgobbleleadNLtoken% +\let\@IEEEswallowthistoken=1% +\fi% +\ifx\@IEEEgobbleleadPARNLSPtoken\@IEEEgobbleleadSPtoken% +\let\@IEEEswallowthistoken=1% +\fi% +% a control space will come in as a macro +% when it is the last one on a line +\ifx\@IEEEgobbleleadPARNLSPtoken\@IEEEgobbleleadSPMACRO% +\let\@IEEEswallowthistoken=1% +\fi% +% if we have to swallow this token, do so and taste the next one +% else spit it out and stop gobbling +\ifx\@IEEEswallowthistoken 1\let\@IEEEnextgobbleleadPARNLSP=\@IEEEgobbleleadPARNLSP\else% +\let\@IEEEnextgobbleleadPARNLSP=#1\fi% +\@IEEEnextgobbleleadPARNLSP}% + + + + +% TITLING OF SECTIONS +\def\@IEEEsectpunct{:\ \,} % Punctuation after run-in section heading (headings which are + % part of the paragraphs), need little bit more than a single space + % spacing from section number to title +% compsoc conferences use regular period/space punctuation +\ifCLASSOPTIONcompsoc +\ifCLASSOPTIONconference +\def\@IEEEsectpunct{.\ } +\fi\fi + +\def\@seccntformat#1{\hb@xt@ 1.4em{\csname the#1dis\endcsname\hss\relax}} +\def\@seccntformatinl#1{\hb@xt@ 1.1em{\csname the#1dis\endcsname\hss\relax}} +\def\@seccntformatch#1{\csname the#1dis\endcsname\hskip 1em\relax} + +\ifCLASSOPTIONcompsoc +% compsoc journals need extra spacing +\ifCLASSOPTIONconference\else +\def\@seccntformat#1{\csname the#1dis\endcsname\hskip 1em\relax} +\fi\fi + +%v1.7 put {} after #6 to allow for some types of user font control +%and use \@@par rather than \par +\def\@sect#1#2#3#4#5#6[#7]#8{% + \ifnum #2>\c@secnumdepth + \let\@svsec\@empty + \else + \refstepcounter{#1}% + % load section label and spacer into \@svsec + \ifnum #2=1 + \protected@edef\@svsec{\@seccntformatch{#1}\relax}% + \else + \ifnum #2>2 + \protected@edef\@svsec{\@seccntformatinl{#1}\relax}% + \else + \protected@edef\@svsec{\@seccntformat{#1}\relax}% + \fi + \fi + \fi% + \@tempskipa #5\relax + \ifdim \@tempskipa>\z@% tempskipa determines whether is treated as a high + \begingroup #6{\relax% or low level heading + \noindent % subsections are NOT indented + % print top level headings. \@svsec is label, #8 is heading title + % IEEE does not block indent the section title text, it flows like normal + {\hskip #3\relax\@svsec}{\interlinepenalty \@M #8\@@par}}% + \endgroup + \addcontentsline{toc}{#1}{\ifnum #2>\c@secnumdepth\relax\else + \protect\numberline{\csname the#1\endcsname}\fi#7}% + \else % printout low level headings + % svsechd seems to swallow the trailing space, protect it with \mbox{} + % got rid of sectionmark stuff + \def\@svsechd{#6{\hskip #3\relax\@svsec #8\@IEEEsectpunct\mbox{}}% + \addcontentsline{toc}{#1}{\ifnum #2>\c@secnumdepth\relax\else + \protect\numberline{\csname the#1\endcsname}\fi#7}}% + \fi%skip down + \@xsect{#5}} + + +% section* handler +%v1.7 put {} after #4 to allow for some types of user font control +%and use \@@par rather than \par +\def\@ssect#1#2#3#4#5{\@tempskipa #3\relax + \ifdim \@tempskipa>\z@ + %\begingroup #4\@hangfrom{\hskip #1}{\interlinepenalty \@M #5\par}\endgroup + % IEEE does not block indent the section title text, it flows like normal + \begingroup \noindent #4{\relax{\hskip #1}{\interlinepenalty \@M #5\@@par}}\endgroup + % svsechd swallows the trailing space, protect it with \mbox{} + \else \def\@svsechd{#4{\hskip #1\relax #5\@IEEEsectpunct\mbox{}}}\fi + \@xsect{#3}} + + +%% SECTION heading spacing and font +%% +% arguments are: #1 - sectiontype name +% (for \@sect) #2 - section level +% #3 - section heading indent +% #4 - top separation (absolute value used, neg indicates not to indent main text) +% If negative, make stretch parts negative too! +% #5 - (absolute value used) positive: bottom separation after heading, +% negative: amount to indent main text after heading +% Both #4 and #5 negative means to indent main text and use negative top separation +% #6 - font control +% You've got to have \normalfont\normalsize in the font specs below to prevent +% trouble when you do something like: +% \section{Note}{\ttfamily TT-TEXT} is known to ... +% IEEE sometimes REALLY stretches the area before a section +% heading by up to about 0.5in. However, it may not be a good +% idea to let LaTeX have quite this much rubber. +\ifCLASSOPTIONconference% +% IEEE wants section heading spacing to decrease for conference mode +\def\section{\@startsection{section}{1}{\z@}{1.5ex plus 1.5ex minus 0.5ex}% +{1sp}{\normalfont\normalsize\centering\scshape}}% +\def\subsection{\@startsection{subsection}{2}{\z@}{1.5ex plus 1.5ex minus 0.5ex}% +{1sp}{\normalfont\normalsize\itshape}}% +\else % for journals +\def\section{\@startsection{section}{1}{\z@}{3.0ex plus 1.5ex minus 1.5ex}% V1.6 3.0ex from 3.5ex +{0.7ex plus 1ex minus 0ex}{\normalfont\normalsize\centering\scshape}}% +\def\subsection{\@startsection{subsection}{2}{\z@}{3.5ex plus 1.5ex minus 1.5ex}% +{0.7ex plus .5ex minus 0ex}{\normalfont\normalsize\itshape}}% +\fi + +% for both journals and conferences +% decided to put in a little rubber above the section, might help somebody +\def\subsubsection{\@startsection{subsubsection}{3}{\parindent}{0ex plus 0.1ex minus 0.1ex}% +{0ex}{\normalfont\normalsize\itshape}}% +\def\paragraph{\@startsection{paragraph}{4}{2\parindent}{0ex plus 0.1ex minus 0.1ex}% +{0ex}{\normalfont\normalsize\itshape}}% + + +% compsoc +\ifCLASSOPTIONcompsoc +\ifCLASSOPTIONconference +% compsoc conference +\def\section{\@startsection{section}{1}{\z@}{1\baselineskip plus 0.25\baselineskip minus 0.25\baselineskip}% +{1\baselineskip plus 0.25\baselineskip minus 0.25\baselineskip}{\normalfont\large\bfseries}}% +\def\subsection{\@startsection{subsection}{2}{\z@}{1\baselineskip plus 0.25\baselineskip minus 0.25\baselineskip}% +{1\baselineskip plus 0.25\baselineskip minus 0.25\baselineskip}{\normalfont\sublargesize\bfseries}}% +\def\subsubsection{\@startsection{subsubsection}{3}{\z@}{1\baselineskip plus 0.25\baselineskip minus 0.25\baselineskip}% +{0ex}{\normalfont\normalsize\bfseries}}% +\def\paragraph{\@startsection{paragraph}{4}{2\parindent}{0ex plus 0.1ex minus 0.1ex}% +{0ex}{\normalfont\normalsize}}% +\else% compsoc journals +% use negative top separation as compsoc journals do not indent paragraphs after section titles +\def\section{\@startsection{section}{1}{\z@}{-3ex plus -2ex minus -1.5ex}% +{0.7ex plus 1ex minus 0ex}{\normalfont\large\sffamily\bfseries\scshape}}% +% Note that subsection and smaller may not be correct for the Computer Society, +% I have to look up an example. +\def\subsection{\@startsection{subsection}{2}{\z@}{-3.5ex plus -1.5ex minus -1.5ex}% +{0.7ex plus .5ex minus 0ex}{\normalfont\normalsize\sffamily\bfseries}}% +\def\subsubsection{\@startsection{subsubsection}{3}{\z@}{-2.5ex plus -1ex minus -1ex}% +{0.5ex plus 0.5ex minus 0ex}{\normalfont\normalsize\sffamily\itshape}}% +\def\paragraph{\@startsection{paragraph}{4}{2\parindent}{-0ex plus -0.1ex minus -0.1ex}% +{0ex}{\normalfont\normalsize}}% +\fi\fi + + + + +%% ENVIRONMENTS +% "box" symbols at end of proofs +\def\IEEEQEDclosed{\mbox{\rule[0pt]{1.3ex}{1.3ex}}} % for a filled box +% V1.6 some journals use an open box instead that will just fit around a closed one +\def\IEEEQEDopen{{\setlength{\fboxsep}{0pt}\setlength{\fboxrule}{0.2pt}\fbox{\rule[0pt]{0pt}{1.3ex}\rule[0pt]{1.3ex}{0pt}}}} +\ifCLASSOPTIONcompsoc +\def\IEEEQED{\IEEEQEDopen} % default to open for compsoc +\else +\def\IEEEQED{\IEEEQEDclosed} % otherwise default to closed +\fi + +% v1.7 name change to avoid namespace collision with amsthm. Also add support +% for an optional argument. +\def\IEEEproof{\@ifnextchar[{\@IEEEproof}{\@IEEEproof[\IEEEproofname]}} +\def\@IEEEproof[#1]{\par\noindent\hspace{2em}{\itshape #1: }} +\def\endIEEEproof{\hspace*{\fill}~\IEEEQED\par} + + +%\itemindent is set to \z@ by list, so define new temporary variable +\newdimen\@IEEEtmpitemindent +\def\@begintheorem#1#2{\@IEEEtmpitemindent\itemindent\topsep 0pt\rmfamily\trivlist% + \item[\hskip \labelsep{\indent\itshape #1\ #2:}]\itemindent\@IEEEtmpitemindent} +\def\@opargbegintheorem#1#2#3{\@IEEEtmpitemindent\itemindent\topsep 0pt\rmfamily \trivlist% +% V1.6 IEEE is back to using () around theorem names which are also in italics +% Thanks to Christian Peel for reporting this. + \item[\hskip\labelsep{\indent\itshape #1\ #2\ (#3):}]\itemindent\@IEEEtmpitemindent} +% V1.7 remove bogus \unskip that caused equations in theorems to collide with +% lines below. +\def\@endtheorem{\endtrivlist} + +% V1.6 +% display command for the section the theorem is in - so that \thesection +% is not used as this will be in Roman numerals when we want arabic. +% LaTeX2e uses \def\@thmcounter#1{\noexpand\arabic{#1}} for the theorem number +% (second part) display and \def\@thmcountersep{.} as a separator. +% V1.7 intercept calls to the section counter and reroute to \@IEEEthmcounterinsection +% to allow \appendix(ices} to override as needed. +% +% special handler for sections, allows appendix(ices) to override +\gdef\@IEEEthmcounterinsection#1{\arabic{#1}} +% string macro +\edef\@IEEEstringsection{section} + +% redefine the #1#2[#3] form of newtheorem to use a hook to \@IEEEthmcounterinsection +% if section in_counter is used +\def\@xnthm#1#2[#3]{% + \expandafter\@ifdefinable\csname #1\endcsname + {\@definecounter{#1}\@newctr{#1}[#3]% + \edef\@IEEEstringtmp{#3} + \ifx\@IEEEstringtmp\@IEEEstringsection + \expandafter\xdef\csname the#1\endcsname{% + \noexpand\@IEEEthmcounterinsection{#3}\@thmcountersep + \@thmcounter{#1}}% + \else + \expandafter\xdef\csname the#1\endcsname{% + \expandafter\noexpand\csname the#3\endcsname \@thmcountersep + \@thmcounter{#1}}% + \fi + \global\@namedef{#1}{\@thm{#1}{#2}}% + \global\@namedef{end#1}{\@endtheorem}}} + + + +%% SET UP THE DEFAULT PAGESTYLE +\ps@headings +\pagenumbering{arabic} + +% normally the page counter starts at 1 +\setcounter{page}{1} +% however, for peerreview the cover sheet is page 0 or page -1 +% (for duplex printing) +\ifCLASSOPTIONpeerreview + \if@twoside + \setcounter{page}{-1} + \else + \setcounter{page}{0} + \fi +\fi + +% standard book class behavior - let bottom line float up and down as +% needed when single sided +\ifCLASSOPTIONtwoside\else\raggedbottom\fi +% if two column - turn on twocolumn, allow word spacings to stretch more and +% enforce a rigid position for the last lines +\ifCLASSOPTIONtwocolumn +% the peer review option delays invoking twocolumn + \ifCLASSOPTIONpeerreview\else + \twocolumn + \fi +\sloppy +\flushbottom +\fi + + + + +% \APPENDIX and \APPENDICES definitions + +% This is the \@ifmtarg command from the LaTeX ifmtarg package +% by Peter Wilson (CUA) and Donald Arseneau +% \@ifmtarg is used to determine if an argument to a command +% is present or not. +% For instance: +% \@ifmtarg{#1}{\typeout{empty}}{\typeout{has something}} +% \@ifmtarg is used with our redefined \section command if +% \appendices is invoked. +% The command \section will behave slightly differently depending +% on whether the user specifies a title: +% \section{My appendix title} +% or not: +% \section{} +% This way, we can eliminate the blank lines where the title +% would be, and the unneeded : after Appendix in the table of +% contents +\begingroup +\catcode`\Q=3 +\long\gdef\@ifmtarg#1{\@xifmtarg#1QQ\@secondoftwo\@firstoftwo\@nil} +\long\gdef\@xifmtarg#1#2Q#3#4#5\@nil{#4} +\endgroup +% end of \@ifmtarg defs + + +% V1.7 +% command that allows the one time saving of the original definition +% of section to \@IEEEappendixsavesection for \appendix or \appendices +% we don't save \section here as it may be redefined later by other +% packages (hyperref.sty, etc.) +\def\@IEEEsaveoriginalsectiononce{\let\@IEEEappendixsavesection\section +\let\@IEEEsaveoriginalsectiononce\relax} + +% neat trick to grab and process the argument from \section{argument} +% we process differently if the user invoked \section{} with no +% argument (title) +% note we reroute the call to the old \section* +\def\@IEEEprocessthesectionargument#1{% +\@ifmtarg{#1}{% +\@IEEEappendixsavesection*{\appendixname~\thesectiondis}% +\addcontentsline{toc}{section}{\appendixname~\thesection}}{% +\@IEEEappendixsavesection*{\appendixname~\thesectiondis \\* #1}% +\addcontentsline{toc}{section}{\appendixname~\thesection: #1}}} + +% we use this if the user calls \section{} after +% \appendix-- which has no meaning. So, we ignore the +% command and its argument. Then, warn the user. +\def\@IEEEdestroythesectionargument#1{\typeout{** WARNING: Ignoring useless +\protect\section\space in Appendix (line \the\inputlineno).}} + + +% remember \thesection forms will be displayed in \ref calls +% and in the Table of Contents. +% The \sectiondis form is used in the actual heading itself + +% appendix command for one single appendix +% normally has no heading. However, if you want a +% heading, you can do so via the optional argument: +% \appendix[Optional Heading] +\def\appendix{\relax} +\renewcommand{\appendix}[1][]{\@IEEEsaveoriginalsectiononce\par + % v1.6 keep hyperref's identifiers unique + \gdef\theHsection{Appendix.A}% + % v1.6 adjust hyperref's string name for the section + \xdef\Hy@chapapp{appendix}% + \setcounter{section}{0}% + \setcounter{subsection}{0}% + \setcounter{subsubsection}{0}% + \setcounter{paragraph}{0}% + \gdef\thesection{A}% + \gdef\thesectiondis{}% + \gdef\thesubsection{\Alph{subsection}}% + \gdef\@IEEEthmcounterinsection##1{A} + \refstepcounter{section}% update the \ref counter + \@ifmtarg{#1}{\@IEEEappendixsavesection*{\appendixname}% + \addcontentsline{toc}{section}{\appendixname}}{% + \@IEEEappendixsavesection*{\appendixname~\\* #1}% + \addcontentsline{toc}{section}{\appendixname: #1}}% + % redefine \section command for appendix + % leave \section* as is + \def\section{\@ifstar{\@IEEEappendixsavesection*}{% + \@IEEEdestroythesectionargument}}% throw out the argument + % of the normal form +} + + + +% appendices command for multiple appendices +% user then calls \section with an argument (possibly empty) to +% declare the individual appendices +\def\appendices{\@IEEEsaveoriginalsectiononce\par + % v1.6 keep hyperref's identifiers unique + \gdef\theHsection{Appendix.\Alph{section}}% + % v1.6 adjust hyperref's string name for the section + \xdef\Hy@chapapp{appendix}% + \setcounter{section}{-1}% we want \refstepcounter to use section 0 + \setcounter{subsection}{0}% + \setcounter{subsubsection}{0}% + \setcounter{paragraph}{0}% + \ifCLASSOPTIONromanappendices% + \gdef\thesection{\Roman{section}}% + \gdef\thesectiondis{\Roman{section}}% + \@IEEEcompsocconfonly{\gdef\thesectiondis{\Roman{section}.}}% + \gdef\@IEEEthmcounterinsection##1{A\arabic{##1}} + \else% + \gdef\thesection{\Alph{section}}% + \gdef\thesectiondis{\Alph{section}}% + \@IEEEcompsocconfonly{\gdef\thesectiondis{\Alph{section}.}}% + \gdef\@IEEEthmcounterinsection##1{\Alph{##1}} + \fi% + \refstepcounter{section}% update the \ref counter + \setcounter{section}{0}% NEXT \section will be the FIRST appendix + % redefine \section command for appendices + % leave \section* as is + \def\section{\@ifstar{\@IEEEappendixsavesection*}{% process the *-form + \refstepcounter{section}% or is a new section so, + \@IEEEprocessthesectionargument}}% process the argument + % of the normal form +} + + + +% \IEEEPARstart +% Definition for the big two line drop cap letter at the beginning of the +% first paragraph of journal papers. The first argument is the first letter +% of the first word, the second argument is the remaining letters of the +% first word which will be rendered in upper case. +% In V1.6 this has been completely rewritten to: +% +% 1. no longer have problems when the user begins an environment +% within the paragraph that uses \IEEEPARstart. +% 2. auto-detect and use the current font family +% 3. revise handling of the space at the end of the first word so that +% interword glue will now work as normal. +% 4. produce correctly aligned edges for the (two) indented lines. +% +% We generalize things via control macros - playing with these is fun too. +% +% V1.7 added more control macros to make it easy for IEEEtrantools.sty users +% to change the font style. +% +% the number of lines that are indented to clear it +% may need to increase if using decenders +\def\@IEEEPARstartDROPLINES{2} +% minimum number of lines left on a page to allow a \@IEEEPARstart +% Does not take into consideration rubber shrink, so it tends to +% be overly cautious +\def\@IEEEPARstartMINPAGELINES{2} +% V1.7 the height of the drop cap is adjusted to match the height of this text +% in the current font (when \IEEEPARstart is called). +\def\@IEEEPARstartHEIGHTTEXT{T} +% the depth the letter is lowered below the baseline +% the height (and size) of the letter is determined by the sum +% of this value and the height of the \@IEEEPARstartHEIGHTTEXT in the current +% font. It is a good idea to set this value in terms of the baselineskip +% so that it can respond to changes therein. +\def\@IEEEPARstartDROPDEPTH{1.1\baselineskip} +% V1.7 the font the drop cap will be rendered in, +% can take zero or one argument. +\def\@IEEEPARstartFONTSTYLE{\bfseries} +% V1.7 any additional, non-font related commands needed to modify +% the drop cap letter, can take zero or one argument. +\def\@IEEEPARstartCAPSTYLE{\MakeUppercase} +% V1.7 the font that will be used to render the rest of the word, +% can take zero or one argument. +\def\@IEEEPARstartWORDFONTSTYLE{\relax} +% V1.7 any additional, non-font related commands needed to modify +% the rest of the word, can take zero or one argument. +\def\@IEEEPARstartWORDCAPSTYLE{\MakeUppercase} +% This is the horizontal separation distance from the drop letter to the main text. +% Lengths that depend on the font (e.g., ex, em, etc.) will be referenced +% to the font that is active when \IEEEPARstart is called. +\def\@IEEEPARstartSEP{0.15em} +% V1.7 horizontal offset applied to the left of the drop cap. +\def\@IEEEPARstartHOFFSET{0em} +% V1.7 Italic correction command applied at the end of the drop cap. +\def\@IEEEPARstartITLCORRECT{\/} + +% V1.7 compoc uses nonbold drop cap and small caps word style +\ifCLASSOPTIONcompsoc +\def\@IEEEPARstartFONTSTYLE{\mdseries} +\def\@IEEEPARstartWORDFONTSTYLE{\scshape} +\def\@IEEEPARstartWORDCAPSTYLE{\relax} +\fi + +% definition of \IEEEPARstart +% THIS IS A CONTROLLED SPACING AREA, DO NOT ALLOW SPACES WITHIN THESE LINES +% +% The token \@IEEEPARstartfont will be globally defined after the first use +% of \IEEEPARstart and will be a font command which creates the big letter +% The first argument is the first letter of the first word and the second +% argument is the rest of the first word(s). +\def\IEEEPARstart#1#2{\par{% +% if this page does not have enough space, break it and lets start +% on a new one +\@IEEEtranneedspace{\@IEEEPARstartMINPAGELINES\baselineskip}{\relax}% +% V1.7 move this up here in case user uses \textbf for \@IEEEPARstartFONTSTYLE +% which uses command \leavevmode which causes an unwanted \indent to be issued +\noindent +% calculate the desired height of the big letter +% it extends from the top of \@IEEEPARstartHEIGHTTEXT in the current font +% down to \@IEEEPARstartDROPDEPTH below the current baseline +\settoheight{\@IEEEtrantmpdimenA}{\@IEEEPARstartHEIGHTTEXT}% +\addtolength{\@IEEEtrantmpdimenA}{\@IEEEPARstartDROPDEPTH}% +% extract the name of the current font in bold +% and place it in \@IEEEPARstartFONTNAME +\def\@IEEEPARstartGETFIRSTWORD##1 ##2\relax{##1}% +{\@IEEEPARstartFONTSTYLE{\selectfont\edef\@IEEEPARstartFONTNAMESPACE{\fontname\font\space}% +\xdef\@IEEEPARstartFONTNAME{\expandafter\@IEEEPARstartGETFIRSTWORD\@IEEEPARstartFONTNAMESPACE\relax}}}% +% define a font based on this name with a point size equal to the desired +% height of the drop letter +\font\@IEEEPARstartsubfont\@IEEEPARstartFONTNAME\space at \@IEEEtrantmpdimenA\relax% +% save this value as a counter (integer) value (sp points) +\@IEEEtrantmpcountA=\@IEEEtrantmpdimenA% +% now get the height of the actual letter produced by this font size +\settoheight{\@IEEEtrantmpdimenB}{\@IEEEPARstartsubfont\@IEEEPARstartCAPSTYLE{#1}}% +% If something bogus happens like the first argument is empty or the +% current font is strange, do not allow a zero height. +\ifdim\@IEEEtrantmpdimenB=0pt\relax% +\typeout{** WARNING: IEEEPARstart drop letter has zero height! (line \the\inputlineno)}% +\typeout{ Forcing the drop letter font size to 10pt.}% +\@IEEEtrantmpdimenB=10pt% +\fi% +% and store it as a counter +\@IEEEtrantmpcountB=\@IEEEtrantmpdimenB% +% Since a font size doesn't exactly correspond to the height of the capital +% letters in that font, the actual height of the letter, \@IEEEtrantmpcountB, +% will be less than that desired, \@IEEEtrantmpcountA +% we need to raise the font size, \@IEEEtrantmpdimenA +% by \@IEEEtrantmpcountA / \@IEEEtrantmpcountB +% But, TeX doesn't have floating point division, so we have to use integer +% division. Hence the use of the counters. +% We need to reduce the denominator so that the loss of the remainder will +% have minimal affect on the accuracy of the result +\divide\@IEEEtrantmpcountB by 200% +\divide\@IEEEtrantmpcountA by \@IEEEtrantmpcountB% +% Then reequalize things when we use TeX's ability to multiply by +% floating point values +\@IEEEtrantmpdimenB=0.005\@IEEEtrantmpdimenA% +\multiply\@IEEEtrantmpdimenB by \@IEEEtrantmpcountA% +% \@IEEEPARstartfont is globaly set to the calculated font of the big letter +% We need to carry this out of the local calculation area to to create the +% big letter. +\global\font\@IEEEPARstartfont\@IEEEPARstartFONTNAME\space at \@IEEEtrantmpdimenB% +% Now set \@IEEEtrantmpdimenA to the width of the big letter +% We need to carry this out of the local calculation area to set the +% hanging indent +\settowidth{\global\@IEEEtrantmpdimenA}{\@IEEEPARstartfont +\@IEEEPARstartCAPSTYLE{#1\@IEEEPARstartITLCORRECT}}}% +% end of the isolated calculation environment +% add in the extra clearance we want +\advance\@IEEEtrantmpdimenA by \@IEEEPARstartSEP\relax% +% add in the optional offset +\advance\@IEEEtrantmpdimenA by \@IEEEPARstartHOFFSET\relax% +% V1.7 don't allow negative offsets to produce negative hanging indents +\@IEEEtrantmpdimenB\@IEEEtrantmpdimenA +\ifnum\@IEEEtrantmpdimenB < 0 \@IEEEtrantmpdimenB 0pt\fi +% \@IEEEtrantmpdimenA has the width of the big letter plus the +% separation space and \@IEEEPARstartfont is the font we need to use +% Now, we make the letter and issue the hanging indent command +% The letter is placed in a box of zero width and height so that other +% text won't be displaced by it. +\hangindent\@IEEEtrantmpdimenB\hangafter=-\@IEEEPARstartDROPLINES% +\makebox[0pt][l]{\hspace{-\@IEEEtrantmpdimenA}% +\raisebox{-\@IEEEPARstartDROPDEPTH}[0pt][0pt]{\hspace{\@IEEEPARstartHOFFSET}% +\@IEEEPARstartfont\@IEEEPARstartCAPSTYLE{#1\@IEEEPARstartITLCORRECT}% +\hspace{\@IEEEPARstartSEP}}}% +{\@IEEEPARstartWORDFONTSTYLE{\@IEEEPARstartWORDCAPSTYLE{\selectfont#2}}}} + + + + + + +% determines if the space remaining on a given page is equal to or greater +% than the specified space of argument one +% if not, execute argument two (only if the remaining space is greater than zero) +% and issue a \newpage +% +% example: \@IEEEtranneedspace{2in}{\vfill} +% +% Does not take into consideration rubber shrinkage, so it tends to +% be overly cautious +% Based on an example posted by Donald Arseneau +% Note this macro uses \@IEEEtrantmpdimenB internally for calculations, +% so DO NOT PASS \@IEEEtrantmpdimenB to this routine +% if you need a dimen register, import with \@IEEEtrantmpdimenA instead +\def\@IEEEtranneedspace#1#2{\penalty-100\begingroup%shield temp variable +\@IEEEtrantmpdimenB\pagegoal\advance\@IEEEtrantmpdimenB-\pagetotal% space left +\ifdim #1>\@IEEEtrantmpdimenB\relax% not enough space left +\ifdim\@IEEEtrantmpdimenB>\z@\relax #2\fi% +\newpage% +\fi\endgroup} + + + +% IEEEbiography ENVIRONMENT +% Allows user to enter biography leaving place for picture (adapts to font size) +% As of V1.5, a new optional argument allows you to have a real graphic! +% V1.5 and later also fixes the "colliding biographies" which could happen when a +% biography's text was shorter than the space for the photo. +% MDS 7/2001 +% V1.6 prevent multiple biographies from making multiple TOC entries +\newif\if@IEEEbiographyTOCentrynotmade +\global\@IEEEbiographyTOCentrynotmadetrue + +% biography counter so hyperref can jump directly to the biographies +% and not just the previous section +\newcounter{IEEEbiography} +\setcounter{IEEEbiography}{0} + +% photo area size +\def\@IEEEBIOphotowidth{1.0in} % width of the biography photo area +\def\@IEEEBIOphotodepth{1.25in} % depth (height) of the biography photo area +% area cleared for photo +\def\@IEEEBIOhangwidth{1.14in} % width cleared for the biography photo area +\def\@IEEEBIOhangdepth{1.25in} % depth cleared for the biography photo area + % actual depth will be a multiple of + % \baselineskip, rounded up +\def\@IEEEBIOskipN{4\baselineskip}% nominal value of the vskip above the biography + +\newenvironment{IEEEbiography}[2][]{\normalfont\@IEEEcompsoconly{\sffamily}\footnotesize% +\unitlength 1in\parskip=0pt\par\parindent 1em\interlinepenalty500% +% we need enough space to support the hanging indent +% the nominal value of the spacer +% and one extra line for good measure +\@IEEEtrantmpdimenA=\@IEEEBIOhangdepth% +\advance\@IEEEtrantmpdimenA by \@IEEEBIOskipN% +\advance\@IEEEtrantmpdimenA by 1\baselineskip% +% if this page does not have enough space, break it and lets start +% with a new one +\@IEEEtranneedspace{\@IEEEtrantmpdimenA}{\relax}% +% nominal spacer can strech, not shrink use 1fil so user can out stretch with \vfill +\vskip \@IEEEBIOskipN plus 1fil minus 0\baselineskip% +% the default box for where the photo goes +\def\@IEEEtempbiographybox{{\setlength{\fboxsep}{0pt}\framebox{% +\begin{minipage}[b][\@IEEEBIOphotodepth][c]{\@IEEEBIOphotowidth}\centering PLACE\\ PHOTO\\ HERE \end{minipage}}}}% +% +% detect if the optional argument was supplied, this requires the +% \@ifmtarg command as defined in the appendix section above +% and if so, override the default box with what they want +\@ifmtarg{#1}{\relax}{\def\@IEEEtempbiographybox{\mbox{\begin{minipage}[b][\@IEEEBIOphotodepth][c]{\@IEEEBIOphotowidth}% +\centering% +#1% +\end{minipage}}}}% end if optional argument supplied +% Make an entry into the table of contents only if we have not done so before +\if@IEEEbiographyTOCentrynotmade% +% link labels to the biography counter so hyperref will jump +% to the biography, not the previous section +\setcounter{IEEEbiography}{-1}% +\refstepcounter{IEEEbiography}% +\addcontentsline{toc}{section}{Biographies}% +\global\@IEEEbiographyTOCentrynotmadefalse% +\fi% +% one more biography +\refstepcounter{IEEEbiography}% +% Make an entry for this name into the table of contents +\addcontentsline{toc}{subsection}{#2}% +% V1.6 properly handle if a new paragraph should occur while the +% hanging indent is still active. Do this by redefining \par so +% that it will not start a new paragraph. (But it will appear to the +% user as if it did.) Also, strip any leading pars, newlines, or spaces. +\let\@IEEEBIOORGparCMD=\par% save the original \par command +\edef\par{\hfil\break\indent}% the new \par will not be a "real" \par +\settoheight{\@IEEEtrantmpdimenA}{\@IEEEtempbiographybox}% get height of biography box +\@IEEEtrantmpdimenB=\@IEEEBIOhangdepth% +\@IEEEtrantmpcountA=\@IEEEtrantmpdimenB% countA has the hang depth +\divide\@IEEEtrantmpcountA by \baselineskip% calculates lines needed to produce the hang depth +\advance\@IEEEtrantmpcountA by 1% ensure we overestimate +% set the hanging indent +\hangindent\@IEEEBIOhangwidth% +\hangafter-\@IEEEtrantmpcountA% +% reference the top of the photo area to the top of a capital T +\settoheight{\@IEEEtrantmpdimenB}{\mbox{T}}% +% set the photo box, give it zero width and height so as not to disturb anything +\noindent\makebox[0pt][l]{\hspace{-\@IEEEBIOhangwidth}\raisebox{\@IEEEtrantmpdimenB}[0pt][0pt]{% +\raisebox{-\@IEEEBIOphotodepth}[0pt][0pt]{\@IEEEtempbiographybox}}}% +% now place the author name and begin the bio text +\noindent\textbf{#2\ }\@IEEEgobbleleadPARNLSP}{\relax\let\par=\@IEEEBIOORGparCMD\par% +% 7/2001 V1.5 detect when the biography text is shorter than the photo area +% and pad the unused area - preventing a collision from the next biography entry +% MDS +\ifnum \prevgraf <\@IEEEtrantmpcountA\relax% detect when the biography text is shorter than the photo + \advance\@IEEEtrantmpcountA by -\prevgraf% calculate how many lines we need to pad + \advance\@IEEEtrantmpcountA by -1\relax% we compensate for the fact that we indented an extra line + \@IEEEtrantmpdimenA=\baselineskip% calculate the length of the padding + \multiply\@IEEEtrantmpdimenA by \@IEEEtrantmpcountA% + \noindent\rule{0pt}{\@IEEEtrantmpdimenA}% insert an invisible support strut +\fi% +\par\normalfont} + + + +% V1.6 +% added biography without a photo environment +\newenvironment{IEEEbiographynophoto}[1]{% +% Make an entry into the table of contents only if we have not done so before +\if@IEEEbiographyTOCentrynotmade% +% link labels to the biography counter so hyperref will jump +% to the biography, not the previous section +\setcounter{IEEEbiography}{-1}% +\refstepcounter{IEEEbiography}% +\addcontentsline{toc}{section}{Biographies}% +\global\@IEEEbiographyTOCentrynotmadefalse% +\fi% +% one more biography +\refstepcounter{IEEEbiography}% +% Make an entry for this name into the table of contents +\addcontentsline{toc}{subsection}{#1}% +\normalfont\@IEEEcompsoconly{\sffamily}\footnotesize\interlinepenalty500% +\vskip 4\baselineskip plus 1fil minus 0\baselineskip% +\parskip=0pt\par% +\noindent\textbf{#1\ }\@IEEEgobbleleadPARNLSP}{\relax\par\normalfont} + + +% provide the user with some old font commands +% got this from article.cls +\DeclareOldFontCommand{\rm}{\normalfont\rmfamily}{\mathrm} +\DeclareOldFontCommand{\sf}{\normalfont\sffamily}{\mathsf} +\DeclareOldFontCommand{\tt}{\normalfont\ttfamily}{\mathtt} +\DeclareOldFontCommand{\bf}{\normalfont\bfseries}{\mathbf} +\DeclareOldFontCommand{\it}{\normalfont\itshape}{\mathit} +\DeclareOldFontCommand{\sl}{\normalfont\slshape}{\@nomath\sl} +\DeclareOldFontCommand{\sc}{\normalfont\scshape}{\@nomath\sc} +\DeclareRobustCommand*\cal{\@fontswitch\relax\mathcal} +\DeclareRobustCommand*\mit{\@fontswitch\relax\mathnormal} + + +% SPECIAL PAPER NOTICE COMMANDS +% +% holds the special notice text +\def\@IEEEspecialpapernotice{\relax} + +% for special papers, like invited papers, the user can do: +% \IEEEspecialpapernotice{(Invited Paper)} before \maketitle +\def\IEEEspecialpapernotice#1{\ifCLASSOPTIONconference% +\def\@IEEEspecialpapernotice{{\Large#1\vspace*{1em}}}% +\else% +\def\@IEEEspecialpapernotice{{\\*[1.5ex]\sublargesize\textit{#1}}\vspace*{-2ex}}% +\fi} + + + + +% PUBLISHER ID COMMANDS +% to insert a publisher's ID footer +% V1.6 \IEEEpubid has been changed so that the change in page size and style +% occurs in \maketitle. \IEEEpubid must now be issued prior to \maketitle +% use \IEEEpubidadjcol as before - in the second column of the title page +% These changes allow \maketitle to take the reduced page height into +% consideration when dynamically setting the space between the author +% names and the maintext. +% +% the amount the main text is pulled up to make room for the +% publisher's ID footer +% IEEE uses about 1.3\baselineskip for journals, +% dynamic title spacing will clean up the fraction +\def\@IEEEpubidpullup{1.3\baselineskip} +\ifCLASSOPTIONtechnote +% for technotes it must be an integer of baselineskip as there can be no +% dynamic title spacing for two column mode technotes (the title is in the +% in first column) and we should maintain an integer number of lines in the +% second column +% There are some examples (such as older issues of "Transactions on +% Information Theory") in which IEEE really pulls the text off the ID for +% technotes - about 0.55in (or 4\baselineskip). We'll use 2\baselineskip +% and call it even. +\def\@IEEEpubidpullup{2\baselineskip} +\fi + +% V1.7 compsoc does not use a pullup +\ifCLASSOPTIONcompsoc +\def\@IEEEpubidpullup{0pt} +\fi + +% holds the ID text +\def\@IEEEpubid{\relax} + +% flag so \maketitle can tell if \IEEEpubid was called +\newif\if@IEEEusingpubid +\global\@IEEEusingpubidfalse +% issue this command in the page to have the ID at the bottom +% V1.6 use before \maketitle +\def\IEEEpubid#1{\def\@IEEEpubid{#1}\global\@IEEEusingpubidtrue} + + +% command which will pull up (shorten) the column it is executed in +% to make room for the publisher ID. Place in the second column of +% the title page when using \IEEEpubid +% Is smart enough not to do anything when in single column text or +% if the user hasn't called \IEEEpubid +% currently needed in for the second column of a page with the +% publisher ID. If not needed in future releases, please provide this +% command and define it as \relax for backward compatibility +% v1.6b do not allow command to operate if the peer review option has been +% selected because \IEEEpubidadjcol will not be on the cover page. +% V1.7 do nothing if compsoc +\def\IEEEpubidadjcol{\ifCLASSOPTIONcompsoc\else\ifCLASSOPTIONpeerreview\else +\if@twocolumn\if@IEEEusingpubid\enlargethispage{-\@IEEEpubidpullup}\fi\fi\fi\fi} + +% Special thanks to Peter Wilson, Daniel Luecking, and the other +% gurus at comp.text.tex, for helping me to understand how best to +% implement the IEEEpubid command in LaTeX. + + + +%% Lockout some commands under various conditions + +% general purpose bit bucket +\newsavebox{\@IEEEtranrubishbin} + +% flags to prevent multiple warning messages +\newif\if@IEEEWARNthanks +\newif\if@IEEEWARNIEEEPARstart +\newif\if@IEEEWARNIEEEbiography +\newif\if@IEEEWARNIEEEbiographynophoto +\newif\if@IEEEWARNIEEEpubid +\newif\if@IEEEWARNIEEEpubidadjcol +\newif\if@IEEEWARNIEEEmembership +\newif\if@IEEEWARNIEEEaftertitletext +\@IEEEWARNthankstrue +\@IEEEWARNIEEEPARstarttrue +\@IEEEWARNIEEEbiographytrue +\@IEEEWARNIEEEbiographynophototrue +\@IEEEWARNIEEEpubidtrue +\@IEEEWARNIEEEpubidadjcoltrue +\@IEEEWARNIEEEmembershiptrue +\@IEEEWARNIEEEaftertitletexttrue + + +%% Lockout some commands when in various modes, but allow them to be restored if needed +%% +% save commands which might be locked out +% so that the user can later restore them if needed +\let\@IEEESAVECMDthanks\thanks +\let\@IEEESAVECMDIEEEPARstart\IEEEPARstart +\let\@IEEESAVECMDIEEEbiography\IEEEbiography +\let\@IEEESAVECMDendIEEEbiography\endIEEEbiography +\let\@IEEESAVECMDIEEEbiographynophoto\IEEEbiographynophoto +\let\@IEEESAVECMDendIEEEbiographynophoto\endIEEEbiographynophoto +\let\@IEEESAVECMDIEEEpubid\IEEEpubid +\let\@IEEESAVECMDIEEEpubidadjcol\IEEEpubidadjcol +\let\@IEEESAVECMDIEEEmembership\IEEEmembership +\let\@IEEESAVECMDIEEEaftertitletext\IEEEaftertitletext + + +% disable \IEEEPARstart when in draft mode +% This may have originally been done because the pre-V1.6 drop letter +% algorithm had problems with a non-unity baselinestretch +% At any rate, it seems too formal to have a drop letter in a draft +% paper. +\ifCLASSOPTIONdraftcls +\def\IEEEPARstart#1#2{#1#2\if@IEEEWARNIEEEPARstart\typeout{** ATTENTION: \noexpand\IEEEPARstart + is disabled in draft mode (line \the\inputlineno).}\fi\global\@IEEEWARNIEEEPARstartfalse} +\fi +% and for technotes +\ifCLASSOPTIONtechnote +\def\IEEEPARstart#1#2{#1#2\if@IEEEWARNIEEEPARstart\typeout{** WARNING: \noexpand\IEEEPARstart + is locked out for technotes (line \the\inputlineno).}\fi\global\@IEEEWARNIEEEPARstartfalse} +\fi + + +% lockout unneeded commands when in conference mode +\ifCLASSOPTIONconference +% when locked out, \thanks, \IEEEbiography, \IEEEbiographynophoto, \IEEEpubid, +% \IEEEmembership and \IEEEaftertitletext will all swallow their given text. +% \IEEEPARstart will output a normal character instead +% warn the user about these commands only once to prevent the console screen +% from filling up with redundant messages +\def\thanks#1{\if@IEEEWARNthanks\typeout{** WARNING: \noexpand\thanks + is locked out when in conference mode (line \the\inputlineno).}\fi\global\@IEEEWARNthanksfalse} +\def\IEEEPARstart#1#2{#1#2\if@IEEEWARNIEEEPARstart\typeout{** WARNING: \noexpand\IEEEPARstart + is locked out when in conference mode (line \the\inputlineno).}\fi\global\@IEEEWARNIEEEPARstartfalse} + + +% LaTeX treats environments and commands with optional arguments differently. +% the actual ("internal") command is stored as \\commandname +% (accessed via \csname\string\commandname\endcsname ) +% the "external" command \commandname is a macro with code to determine +% whether or not the optional argument is presented and to provide the +% default if it is absent. So, in order to save and restore such a command +% we would have to save and restore \\commandname as well. But, if LaTeX +% ever changes the way it names the internal names, the trick would break. +% Instead let us just define a new environment so that the internal +% name can be left undisturbed. +\newenvironment{@IEEEbogusbiography}[2][]{\if@IEEEWARNIEEEbiography\typeout{** WARNING: \noexpand\IEEEbiography + is locked out when in conference mode (line \the\inputlineno).}\fi\global\@IEEEWARNIEEEbiographyfalse% +\setbox\@IEEEtranrubishbin\vbox\bgroup}{\egroup\relax} +% and make biography point to our bogus biography +\let\IEEEbiography=\@IEEEbogusbiography +\let\endIEEEbiography=\end@IEEEbogusbiography + +\renewenvironment{IEEEbiographynophoto}[1]{\if@IEEEWARNIEEEbiographynophoto\typeout{** WARNING: \noexpand\IEEEbiographynophoto + is locked out when in conference mode (line \the\inputlineno).}\fi\global\@IEEEWARNIEEEbiographynophotofalse% +\setbox\@IEEEtranrubishbin\vbox\bgroup}{\egroup\relax} + +\def\IEEEpubid#1{\if@IEEEWARNIEEEpubid\typeout{** WARNING: \noexpand\IEEEpubid + is locked out when in conference mode (line \the\inputlineno).}\fi\global\@IEEEWARNIEEEpubidfalse} +\def\IEEEpubidadjcol{\if@IEEEWARNIEEEpubidadjcol\typeout{** WARNING: \noexpand\IEEEpubidadjcol + is locked out when in conference mode (line \the\inputlineno).}\fi\global\@IEEEWARNIEEEpubidadjcolfalse} +\def\IEEEmembership#1{\if@IEEEWARNIEEEmembership\typeout{** WARNING: \noexpand\IEEEmembership + is locked out when in conference mode (line \the\inputlineno).}\fi\global\@IEEEWARNIEEEmembershipfalse} +\def\IEEEaftertitletext#1{\if@IEEEWARNIEEEaftertitletext\typeout{** WARNING: \noexpand\IEEEaftertitletext + is locked out when in conference mode (line \the\inputlineno).}\fi\global\@IEEEWARNIEEEaftertitletextfalse} +\fi + + +% provide a way to restore the commands that are locked out +\def\IEEEoverridecommandlockouts{% +\typeout{** ATTENTION: Overriding command lockouts (line \the\inputlineno).}% +\let\thanks\@IEEESAVECMDthanks% +\let\IEEEPARstart\@IEEESAVECMDIEEEPARstart% +\let\IEEEbiography\@IEEESAVECMDIEEEbiography% +\let\endIEEEbiography\@IEEESAVECMDendIEEEbiography% +\let\IEEEbiographynophoto\@IEEESAVECMDIEEEbiographynophoto% +\let\endIEEEbiographynophoto\@IEEESAVECMDendIEEEbiographynophoto% +\let\IEEEpubid\@IEEESAVECMDIEEEpubid% +\let\IEEEpubidadjcol\@IEEESAVECMDIEEEpubidadjcol% +\let\IEEEmembership\@IEEESAVECMDIEEEmembership% +\let\IEEEaftertitletext\@IEEESAVECMDIEEEaftertitletext} + + + +% need a backslash character for typeout output +{\catcode`\|=0 \catcode`\\=12 +|xdef|@IEEEbackslash{\}} + + +% hook to allow easy disabling of all legacy warnings +\def\@IEEElegacywarn#1#2{\typeout{** ATTENTION: \@IEEEbackslash #1 is deprecated (line \the\inputlineno). +Use \@IEEEbackslash #2 instead.}} + + +% provide for legacy commands +\def\authorblockA{\@IEEElegacywarn{authorblockA}{IEEEauthorblockA}\IEEEauthorblockA} +\def\authorblockN{\@IEEElegacywarn{authorblockN}{IEEEauthorblockN}\IEEEauthorblockN} +\def\authorrefmark{\@IEEElegacywarn{authorrefmark}{IEEEauthorrefmark}\IEEEauthorrefmark} +\def\PARstart{\@IEEElegacywarn{PARstart}{IEEEPARstart}\IEEEPARstart} +\def\pubid{\@IEEElegacywarn{pubid}{IEEEpubid}\IEEEpubid} +\def\pubidadjcol{\@IEEElegacywarn{pubidadjcol}{IEEEpubidadjcol}\IEEEpubidadjcol} +\def\QED{\@IEEElegacywarn{QED}{IEEEQED}\IEEEQED} +\def\QEDclosed{\@IEEElegacywarn{QEDclosed}{IEEEQEDclosed}\IEEEQEDclosed} +\def\QEDopen{\@IEEElegacywarn{QEDopen}{IEEEQEDopen}\IEEEQEDopen} +\def\specialpapernotice{\@IEEElegacywarn{specialpapernotice}{IEEEspecialpapernotice}\IEEEspecialpapernotice} + + + +% provide for legacy environments +\def\biography{\@IEEElegacywarn{biography}{IEEEbiography}\IEEEbiography} +\def\biographynophoto{\@IEEElegacywarn{biographynophoto}{IEEEbiographynophoto}\IEEEbiographynophoto} +\def\keywords{\@IEEElegacywarn{keywords}{IEEEkeywords}\IEEEkeywords} +\def\endbiography{\endIEEEbiography} +\def\endbiographynophoto{\endIEEEbiographynophoto} +\def\endkeywords{\endIEEEkeywords} + + +% provide for legacy IED commands/lengths when possible +\let\labelindent\IEEElabelindent +\def\calcleftmargin{\@IEEElegacywarn{calcleftmargin}{IEEEcalcleftmargin}\IEEEcalcleftmargin} +\def\setlabelwidth{\@IEEElegacywarn{setlabelwidth}{IEEEsetlabelwidth}\IEEEsetlabelwidth} +\def\usemathlabelsep{\@IEEElegacywarn{usemathlabelsep}{IEEEusemathlabelsep}\IEEEusemathlabelsep} +\def\iedlabeljustifyc{\@IEEElegacywarn{iedlabeljustifyc}{IEEEiedlabeljustifyc}\IEEEiedlabeljustifyc} +\def\iedlabeljustifyl{\@IEEElegacywarn{iedlabeljustifyl}{IEEEiedlabeljustifyl}\IEEEiedlabeljustifyl} +\def\iedlabeljustifyr{\@IEEElegacywarn{iedlabeljustifyr}{IEEEiedlabeljustifyr}\IEEEiedlabeljustifyr} + + + +% let \proof use the IEEEtran version even after amsthm is loaded +% \proof is now deprecated in favor of \IEEEproof +\AtBeginDocument{\def\proof{\@IEEElegacywarn{proof}{IEEEproof}\IEEEproof}\def\endproof{\endIEEEproof}} + +% V1.7 \overrideIEEEmargins is no longer supported. +\def\overrideIEEEmargins{% +\typeout{** WARNING: \string\overrideIEEEmargins \space no longer supported (line \the\inputlineno).}% +\typeout{** Use the \string\CLASSINPUTinnersidemargin, \string\CLASSINPUToutersidemargin \space controls instead.}} + + +\endinput + +%%%%%%%%%%%%%%%%%%%%%%%%%%%%% End of IEEEtran.cls %%%%%%%%%%%%%%%%%%%%%%%%%%%% +% That's all folks! + diff --git a/IEEEtran/IEEEtranS.bst b/IEEEtran/IEEEtranS.bst new file mode 100644 index 0000000..29e5b8c --- /dev/null +++ b/IEEEtran/IEEEtranS.bst @@ -0,0 +1,2607 @@ +%% +%% IEEEtranS.bst +%% BibTeX Bibliography Style file +%% Sorting version of IEEEtran.bst +%% *** Not for normal IEEE work *** +%% Version 1.12 (2007/01/11) +%% +%% Copyright (c) 2003-2007 Michael Shell +%% +%% Original starting code base and algorithms obtained from the output of +%% Patrick W. Daly's makebst package as well as from prior versions of +%% IEEE BibTeX styles: +%% +%% 1. Howard Trickey and Oren Patashnik's ieeetr.bst (1985/1988) +%% 2. Silvano Balemi and Richard H. Roy's IEEEbib.bst (1993) +%% +%% Added sorting code is from plain.bst. +%% +%% Support sites: +%% http://www.michaelshell.org/tex/ieeetran/ +%% http://www.ctan.org/tex-archive/macros/latex/contrib/IEEEtran/ +%% and/or +%% http://www.ieee.org/ +%% +%% For use with BibTeX version 0.99a or later +%% +%% This is a numerical citation style. +%% +%%************************************************************************* +%% Legal Notice: +%% This code is offered as-is without any warranty either expressed or +%% implied; without even the implied warranty of MERCHANTABILITY or +%% FITNESS FOR A PARTICULAR PURPOSE! +%% User assumes all risk. +%% In no event shall IEEE or any contributor to this code be liable for +%% any damages or losses, including, but not limited to, incidental, +%% consequential, or any other damages, resulting from the use or misuse +%% of any information contained here. +%% +%% All comments are the opinions of their respective authors and are not +%% necessarily endorsed by the IEEE. +%% +%% This work is distributed under the LaTeX Project Public License (LPPL) +%% ( http://www.latex-project.org/ ) version 1.3, and may be freely used, +%% distributed and modified. A copy of the LPPL, version 1.3, is included +%% in the base LaTeX documentation of all distributions of LaTeX released +%% 2003/12/01 or later. +%% Retain all contribution notices and credits. +%% ** Modified files should be clearly indicated as such, including ** +%% ** renaming them and changing author support contact information. ** +%% +%% File list of work: IEEEabrv.bib, IEEEfull.bib, IEEEexample.bib, +%% IEEEtran.bst, IEEEtranS.bst, IEEEtranSA.bst, +%% IEEEtranN.bst, IEEEtranSN.bst, IEEEtran_bst_HOWTO.pdf +%%************************************************************************* +% +% +% Changelog: +% +% 1.10 (2002/09/27) Initial release +% +% 1.11 (2003/04/02) +% 1. Fixed bug with URLs containing underscores when using url.sty. Thanks +% to Ming Kin Lai for reporting this. +% +% 1.12 (2007/01/11) +% 1. Fixed bug with unwanted comma before "et al." when an entry contained +% more than two author names. Thanks to Pallav Gupta for reporting this. +% 2. Fixed bug with anomalous closing quote in tech reports that have a +% type, but without a number or address. Thanks to Mehrdad Mirreza for +% reporting this. +% 3. Use braces in \providecommand in begin.bib to better support +% latex2html. TeX style length assignments OK with recent versions +% of latex2html - 1.71 (2002/2/1) or later is strongly recommended. +% Use of the language field still causes trouble with latex2html. +% Thanks to Federico Beffa for reporting this. +% 4. Added IEEEtran.bst ID and version comment string to .bbl output. +% 5. Provide a \BIBdecl hook that allows the user to execute commands +% just prior to the first entry. +% 6. Use default urlstyle (is using url.sty) of "same" rather than rm to +% better work with a wider variety of bibliography styles. +% 7. Changed month abbreviations from Sept., July and June to Sep., Jul., +% and Jun., respectively, as IEEE now does. Thanks to Moritz Borgmann +% for reporting this. +% 8. Control entry types should not be considered when calculating longest +% label width. +% 9. Added alias www for electronic/online. +% 10. Added CTLname_url_prefix control entry type. + + +%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% +%% DEFAULTS FOR THE CONTROLS OF THE BST STYLE %% +%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% + +% These are the defaults for the user adjustable controls. The values used +% here can be overridden by the user via IEEEtranBSTCTL entry type. + +% NOTE: The recommended LaTeX command to invoke a control entry type is: +% +%\makeatletter +%\def\bstctlcite{\@ifnextchar[{\@bstctlcite}{\@bstctlcite[@auxout]}} +%\def\@bstctlcite[#1]#2{\@bsphack +% \@for\@citeb:=#2\do{% +% \edef\@citeb{\expandafter\@firstofone\@citeb}% +% \if@filesw\immediate\write\csname #1\endcsname{\string\citation{\@citeb}}\fi}% +% \@esphack} +%\makeatother +% +% It is called at the start of the document, before the first \cite, like: +% \bstctlcite{IEEEexample:BSTcontrol} +% +% IEEEtran.cls V1.6 and later does provide this command. + + + +% #0 turns off the display of the number for articles. +% #1 enables +FUNCTION {default.is.use.number.for.article} { #1 } + + +% #0 turns off the display of the paper and type fields in @inproceedings. +% #1 enables +FUNCTION {default.is.use.paper} { #1 } + + +% #0 turns off the forced use of "et al." +% #1 enables +FUNCTION {default.is.forced.et.al} { #0 } + +% The maximum number of names that can be present beyond which an "et al." +% usage is forced. Be sure that num.names.shown.with.forced.et.al (below) +% is not greater than this value! +% Note: There are many instances of references in IEEE journals which have +% a very large number of authors as well as instances in which "et al." is +% used profusely. +FUNCTION {default.max.num.names.before.forced.et.al} { #10 } + +% The number of names that will be shown with a forced "et al.". +% Must be less than or equal to max.num.names.before.forced.et.al +FUNCTION {default.num.names.shown.with.forced.et.al} { #1 } + + +% #0 turns off the alternate interword spacing for entries with URLs. +% #1 enables +FUNCTION {default.is.use.alt.interword.spacing} { #1 } + +% If alternate interword spacing for entries with URLs is enabled, this is +% the interword spacing stretch factor that will be used. For example, the +% default "4" here means that the interword spacing in entries with URLs can +% stretch to four times normal. Does not have to be an integer. Note that +% the value specified here can be overridden by the user in their LaTeX +% code via a command such as: +% "\providecommand\BIBentryALTinterwordstretchfactor{1.5}" in addition to +% that via the IEEEtranBSTCTL entry type. +FUNCTION {default.ALTinterwordstretchfactor} { "4" } + + +% #0 turns off the "dashification" of repeated (i.e., identical to those +% of the previous entry) names. IEEE normally does this. +% #1 enables +FUNCTION {default.is.dash.repeated.names} { #1 } + + +% The default name format control string. +FUNCTION {default.name.format.string}{ "{f.~}{vv~}{ll}{, jj}" } + + +% The default LaTeX font command for the names. +FUNCTION {default.name.latex.cmd}{ "" } + + +% The default URL prefix. +FUNCTION {default.name.url.prefix}{ "[Online]. Available:" } + + +% Other controls that cannot be accessed via IEEEtranBSTCTL entry type. + +% #0 turns off the terminal startup banner/completed message so as to +% operate more quietly. +% #1 enables +FUNCTION {is.print.banners.to.terminal} { #1 } + + + + +%%%%%%%%%%%%%%%%%%%%%%%%%%%%% +%% FILE VERSION AND BANNER %% +%%%%%%%%%%%%%%%%%%%%%%%%%%%%% + +FUNCTION{bst.file.version} { "1.12" } +FUNCTION{bst.file.date} { "2007/01/11" } +FUNCTION{bst.file.website} { "http://www.michaelshell.org/tex/ieeetran/bibtex/" } + +FUNCTION {banner.message} +{ is.print.banners.to.terminal + { "-- IEEEtranS.bst version" " " * bst.file.version * + " (" * bst.file.date * ") " * "by Michael Shell." * + top$ + "-- " bst.file.website * + top$ + "-- See the " quote$ * "IEEEtran_bst_HOWTO.pdf" * quote$ * " manual for usage information." * + top$ + "** Sorting version - not for normal IEEE work." + top$ + } + { skip$ } + if$ +} + +FUNCTION {completed.message} +{ is.print.banners.to.terminal + { "" + top$ + "Done." + top$ + } + { skip$ } + if$ +} + + + + +%%%%%%%%%%%%%%%%%%%%%% +%% STRING CONSTANTS %% +%%%%%%%%%%%%%%%%%%%%%% + +FUNCTION {bbl.and}{ "and" } +FUNCTION {bbl.etal}{ "et~al." } +FUNCTION {bbl.editors}{ "eds." } +FUNCTION {bbl.editor}{ "ed." } +FUNCTION {bbl.edition}{ "ed." } +FUNCTION {bbl.volume}{ "vol." } +FUNCTION {bbl.of}{ "of" } +FUNCTION {bbl.number}{ "no." } +FUNCTION {bbl.in}{ "in" } +FUNCTION {bbl.pages}{ "pp." } +FUNCTION {bbl.page}{ "p." } +FUNCTION {bbl.chapter}{ "ch." } +FUNCTION {bbl.paper}{ "paper" } +FUNCTION {bbl.part}{ "pt." } +FUNCTION {bbl.patent}{ "Patent" } +FUNCTION {bbl.patentUS}{ "U.S." } +FUNCTION {bbl.revision}{ "Rev." } +FUNCTION {bbl.series}{ "ser." } +FUNCTION {bbl.standard}{ "Std." } +FUNCTION {bbl.techrep}{ "Tech. Rep." } +FUNCTION {bbl.mthesis}{ "Master's thesis" } +FUNCTION {bbl.phdthesis}{ "Ph.D. dissertation" } +FUNCTION {bbl.st}{ "st" } +FUNCTION {bbl.nd}{ "nd" } +FUNCTION {bbl.rd}{ "rd" } +FUNCTION {bbl.th}{ "th" } + + +% This is the LaTeX spacer that is used when a larger than normal space +% is called for (such as just before the address:publisher). +FUNCTION {large.space} { "\hskip 1em plus 0.5em minus 0.4em\relax " } + +% The LaTeX code for dashes that are used to represent repeated names. +% Note: Some older IEEE journals used something like +% "\rule{0.275in}{0.5pt}\," which is fairly thick and runs right along +% the baseline. However, IEEE now uses a thinner, above baseline, +% six dash long sequence. +FUNCTION {repeated.name.dashes} { "------" } + + + +%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% +%% PREDEFINED STRING MACROS %% +%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% + +MACRO {jan} {"Jan."} +MACRO {feb} {"Feb."} +MACRO {mar} {"Mar."} +MACRO {apr} {"Apr."} +MACRO {may} {"May"} +MACRO {jun} {"Jun."} +MACRO {jul} {"Jul."} +MACRO {aug} {"Aug."} +MACRO {sep} {"Sep."} +MACRO {oct} {"Oct."} +MACRO {nov} {"Nov."} +MACRO {dec} {"Dec."} + + + +%%%%%%%%%%%%%%%%%% +%% ENTRY FIELDS %% +%%%%%%%%%%%%%%%%%% + +ENTRY + { address + assignee + author + booktitle + chapter + day + dayfiled + edition + editor + howpublished + institution + intype + journal + key + language + month + monthfiled + nationality + note + number + organization + pages + paper + publisher + school + series + revision + title + type + url + volume + year + yearfiled + CTLuse_article_number + CTLuse_paper + CTLuse_forced_etal + CTLmax_names_forced_etal + CTLnames_show_etal + CTLuse_alt_spacing + CTLalt_stretch_factor + CTLdash_repeated_names + CTLname_format_string + CTLname_latex_cmd + CTLname_url_prefix + } + {} + { label } + + + + +%%%%%%%%%%%%%%%%%%%%%%% +%% INTEGER VARIABLES %% +%%%%%%%%%%%%%%%%%%%%%%% + +INTEGERS { prev.status.punct this.status.punct punct.std + punct.no punct.comma punct.period + prev.status.space this.status.space space.std + space.no space.normal space.large + prev.status.quote this.status.quote quote.std + quote.no quote.close + prev.status.nline this.status.nline nline.std + nline.no nline.newblock + status.cap cap.std + cap.no cap.yes} + +INTEGERS { longest.label.width multiresult nameptr namesleft number.label numnames } + +INTEGERS { is.use.number.for.article + is.use.paper + is.forced.et.al + max.num.names.before.forced.et.al + num.names.shown.with.forced.et.al + is.use.alt.interword.spacing + is.dash.repeated.names} + + +%%%%%%%%%%%%%%%%%%%%%% +%% STRING VARIABLES %% +%%%%%%%%%%%%%%%%%%%%%% + +STRINGS { bibinfo + longest.label + oldname + s + t + ALTinterwordstretchfactor + name.format.string + name.latex.cmd + name.url.prefix} + + + + +%%%%%%%%%%%%%%%%%%%%%%%%% +%% LOW LEVEL FUNCTIONS %% +%%%%%%%%%%%%%%%%%%%%%%%%% + +FUNCTION {initialize.controls} +{ default.is.use.number.for.article 'is.use.number.for.article := + default.is.use.paper 'is.use.paper := + default.is.forced.et.al 'is.forced.et.al := + default.max.num.names.before.forced.et.al 'max.num.names.before.forced.et.al := + default.num.names.shown.with.forced.et.al 'num.names.shown.with.forced.et.al := + default.is.use.alt.interword.spacing 'is.use.alt.interword.spacing := + default.is.dash.repeated.names 'is.dash.repeated.names := + default.ALTinterwordstretchfactor 'ALTinterwordstretchfactor := + default.name.format.string 'name.format.string := + default.name.latex.cmd 'name.latex.cmd := + default.name.url.prefix 'name.url.prefix := +} + + +% This IEEEtran.bst features a very powerful and flexible mechanism for +% controlling the capitalization, punctuation, spacing, quotation, and +% newlines of the formatted entry fields. (Note: IEEEtran.bst does not need +% or use the newline/newblock feature, but it has been implemented for +% possible future use.) The output states of IEEEtran.bst consist of +% multiple independent attributes and, as such, can be thought of as being +% vectors, rather than the simple scalar values ("before.all", +% "mid.sentence", etc.) used in most other .bst files. +% +% The more flexible and complex design used here was motivated in part by +% IEEE's rather unusual bibliography style. For example, IEEE ends the +% previous field item with a period and large space prior to the publisher +% address; the @electronic entry types use periods as inter-item punctuation +% rather than the commas used by the other entry types; and URLs are never +% followed by periods even though they are the last item in the entry. +% Although it is possible to accommodate these features with the conventional +% output state system, the seemingly endless exceptions make for convoluted, +% unreliable and difficult to maintain code. +% +% IEEEtran.bst's output state system can be easily understood via a simple +% illustration of two most recently formatted entry fields (on the stack): +% +% CURRENT_ITEM +% "PREVIOUS_ITEM +% +% which, in this example, is to eventually appear in the bibliography as: +% +% "PREVIOUS_ITEM," CURRENT_ITEM +% +% It is the job of the output routine to take the previous item off of the +% stack (while leaving the current item at the top of the stack), apply its +% trailing punctuation (including closing quote marks) and spacing, and then +% to write the result to BibTeX's output buffer: +% +% "PREVIOUS_ITEM," +% +% Punctuation (and spacing) between items is often determined by both of the +% items rather than just the first one. The presence of quotation marks +% further complicates the situation because, in standard English, trailing +% punctuation marks are supposed to be contained within the quotes. +% +% IEEEtran.bst maintains two output state (aka "status") vectors which +% correspond to the previous and current (aka "this") items. Each vector +% consists of several independent attributes which track punctuation, +% spacing, quotation, and newlines. Capitalization status is handled by a +% separate scalar because the format routines, not the output routine, +% handle capitalization and, therefore, there is no need to maintain the +% capitalization attribute for both the "previous" and "this" items. +% +% When a format routine adds a new item, it copies the current output status +% vector to the previous output status vector and (usually) resets the +% current (this) output status vector to a "standard status" vector. Using a +% "standard status" vector in this way allows us to redefine what we mean by +% "standard status" at the start of each entry handler and reuse the same +% format routines under the various inter-item separation schemes. For +% example, the standard status vector for the @book entry type may use +% commas for item separators, while the @electronic type may use periods, +% yet both entry handlers exploit many of the exact same format routines. +% +% Because format routines have write access to the output status vector of +% the previous item, they can override the punctuation choices of the +% previous format routine! Therefore, it becomes trivial to implement rules +% such as "Always use a period and a large space before the publisher." By +% pushing the generation of the closing quote mark to the output routine, we +% avoid all the problems caused by having to close a quote before having all +% the information required to determine what the punctuation should be. +% +% The IEEEtran.bst output state system can easily be expanded if needed. +% For instance, it is easy to add a "space.tie" attribute value if the +% bibliography rules mandate that two items have to be joined with an +% unbreakable space. + +FUNCTION {initialize.status.constants} +{ #0 'punct.no := + #1 'punct.comma := + #2 'punct.period := + #0 'space.no := + #1 'space.normal := + #2 'space.large := + #0 'quote.no := + #1 'quote.close := + #0 'cap.no := + #1 'cap.yes := + #0 'nline.no := + #1 'nline.newblock := +} + +FUNCTION {std.status.using.comma} +{ punct.comma 'punct.std := + space.normal 'space.std := + quote.no 'quote.std := + nline.no 'nline.std := + cap.no 'cap.std := +} + +FUNCTION {std.status.using.period} +{ punct.period 'punct.std := + space.normal 'space.std := + quote.no 'quote.std := + nline.no 'nline.std := + cap.yes 'cap.std := +} + +FUNCTION {initialize.prev.this.status} +{ punct.no 'prev.status.punct := + space.no 'prev.status.space := + quote.no 'prev.status.quote := + nline.no 'prev.status.nline := + punct.no 'this.status.punct := + space.no 'this.status.space := + quote.no 'this.status.quote := + nline.no 'this.status.nline := + cap.yes 'status.cap := +} + +FUNCTION {this.status.std} +{ punct.std 'this.status.punct := + space.std 'this.status.space := + quote.std 'this.status.quote := + nline.std 'this.status.nline := +} + +FUNCTION {cap.status.std}{ cap.std 'status.cap := } + +FUNCTION {this.to.prev.status} +{ this.status.punct 'prev.status.punct := + this.status.space 'prev.status.space := + this.status.quote 'prev.status.quote := + this.status.nline 'prev.status.nline := +} + + +FUNCTION {not} +{ { #0 } + { #1 } + if$ +} + +FUNCTION {and} +{ { skip$ } + { pop$ #0 } + if$ +} + +FUNCTION {or} +{ { pop$ #1 } + { skip$ } + if$ +} + + +% convert the strings "yes" or "no" to #1 or #0 respectively +FUNCTION {yes.no.to.int} +{ "l" change.case$ duplicate$ + "yes" = + { pop$ #1 } + { duplicate$ "no" = + { pop$ #0 } + { "unknown boolean " quote$ * swap$ * quote$ * + " in " * cite$ * warning$ + #0 + } + if$ + } + if$ +} + + +% pushes true if the single char string on the stack is in the +% range of "0" to "9" +FUNCTION {is.num} +{ chr.to.int$ + duplicate$ "0" chr.to.int$ < not + swap$ "9" chr.to.int$ > not and +} + +% multiplies the integer on the stack by a factor of 10 +FUNCTION {bump.int.mag} +{ #0 'multiresult := + { duplicate$ #0 > } + { #1 - + multiresult #10 + + 'multiresult := + } + while$ +pop$ +multiresult +} + +% converts a single character string on the stack to an integer +FUNCTION {char.to.integer} +{ duplicate$ + is.num + { chr.to.int$ "0" chr.to.int$ - } + {"noninteger character " quote$ * swap$ * quote$ * + " in integer field of " * cite$ * warning$ + #0 + } + if$ +} + +% converts a string on the stack to an integer +FUNCTION {string.to.integer} +{ duplicate$ text.length$ 'namesleft := + #1 'nameptr := + #0 'numnames := + { nameptr namesleft > not } + { duplicate$ nameptr #1 substring$ + char.to.integer numnames bump.int.mag + + 'numnames := + nameptr #1 + + 'nameptr := + } + while$ +pop$ +numnames +} + + + + +% The output routines write out the *next* to the top (previous) item on the +% stack, adding punctuation and such as needed. Since IEEEtran.bst maintains +% the output status for the top two items on the stack, these output +% routines have to consider the previous output status (which corresponds to +% the item that is being output). Full independent control of punctuation, +% closing quote marks, spacing, and newblock is provided. +% +% "output.nonnull" does not check for the presence of a previous empty +% item. +% +% "output" does check for the presence of a previous empty item and will +% remove an empty item rather than outputing it. +% +% "output.warn" is like "output", but will issue a warning if it detects +% an empty item. + +FUNCTION {output.nonnull} +{ swap$ + prev.status.punct punct.comma = + { "," * } + { skip$ } + if$ + prev.status.punct punct.period = + { add.period$ } + { skip$ } + if$ + prev.status.quote quote.close = + { "''" * } + { skip$ } + if$ + prev.status.space space.normal = + { " " * } + { skip$ } + if$ + prev.status.space space.large = + { large.space * } + { skip$ } + if$ + write$ + prev.status.nline nline.newblock = + { newline$ "\newblock " write$ } + { skip$ } + if$ +} + +FUNCTION {output} +{ duplicate$ empty$ + 'pop$ + 'output.nonnull + if$ +} + +FUNCTION {output.warn} +{ 't := + duplicate$ empty$ + { pop$ "empty " t * " in " * cite$ * warning$ } + 'output.nonnull + if$ +} + +% "fin.entry" is the output routine that handles the last item of the entry +% (which will be on the top of the stack when "fin.entry" is called). + +FUNCTION {fin.entry} +{ this.status.punct punct.no = + { skip$ } + { add.period$ } + if$ + this.status.quote quote.close = + { "''" * } + { skip$ } + if$ +write$ +newline$ +} + + +FUNCTION {is.last.char.not.punct} +{ duplicate$ + "}" * add.period$ + #-1 #1 substring$ "." = +} + +FUNCTION {is.multiple.pages} +{ 't := + #0 'multiresult := + { multiresult not + t empty$ not + and + } + { t #1 #1 substring$ + duplicate$ "-" = + swap$ duplicate$ "," = + swap$ "+" = + or or + { #1 'multiresult := } + { t #2 global.max$ substring$ 't := } + if$ + } + while$ + multiresult +} + +FUNCTION {capitalize}{ "u" change.case$ "t" change.case$ } + +FUNCTION {emphasize} +{ duplicate$ empty$ + { pop$ "" } + { "\emph{" swap$ * "}" * } + if$ +} + +FUNCTION {do.name.latex.cmd} +{ name.latex.cmd + empty$ + { skip$ } + { name.latex.cmd "{" * swap$ * "}" * } + if$ +} + +% IEEEtran.bst uses its own \BIBforeignlanguage command which directly +% invokes the TeX hyphenation patterns without the need of the Babel +% package. Babel does a lot more than switch hyphenation patterns and +% its loading can cause unintended effects in many class files (such as +% IEEEtran.cls). +FUNCTION {select.language} +{ duplicate$ empty$ 'pop$ + { language empty$ 'skip$ + { "\BIBforeignlanguage{" language * "}{" * swap$ * "}" * } + if$ + } + if$ +} + +FUNCTION {tie.or.space.prefix} +{ duplicate$ text.length$ #3 < + { "~" } + { " " } + if$ + swap$ +} + +FUNCTION {get.bbl.editor} +{ editor num.names$ #1 > 'bbl.editors 'bbl.editor if$ } + +FUNCTION {space.word}{ " " swap$ * " " * } + + +% Field Conditioners, Converters, Checkers and External Interfaces + +FUNCTION {empty.field.to.null.string} +{ duplicate$ empty$ + { pop$ "" } + { skip$ } + if$ +} + +FUNCTION {either.or.check} +{ empty$ + { pop$ } + { "can't use both " swap$ * " fields in " * cite$ * warning$ } + if$ +} + +FUNCTION {empty.entry.warn} +{ author empty$ title empty$ howpublished empty$ + month empty$ year empty$ note empty$ url empty$ + and and and and and and + { "all relevant fields are empty in " cite$ * warning$ } + 'skip$ + if$ +} + + +% The bibinfo system provides a way for the electronic parsing/acquisition +% of a bibliography's contents as is done by ReVTeX. For example, a field +% could be entered into the bibliography as: +% \bibinfo{volume}{2} +% Only the "2" would show up in the document, but the LaTeX \bibinfo command +% could do additional things with the information. IEEEtran.bst does provide +% a \bibinfo command via "\providecommand{\bibinfo}[2]{#2}". However, it is +% currently not used as the bogus bibinfo functions defined here output the +% entry values directly without the \bibinfo wrapper. The bibinfo functions +% themselves (and the calls to them) are retained for possible future use. +% +% bibinfo.check avoids acting on missing fields while bibinfo.warn will +% issue a warning message if a missing field is detected. Prior to calling +% the bibinfo functions, the user should push the field value and then its +% name string, in that order. + +FUNCTION {bibinfo.check} +{ swap$ duplicate$ missing$ + { pop$ pop$ "" } + { duplicate$ empty$ + { swap$ pop$ } + { swap$ pop$ } + if$ + } + if$ +} + +FUNCTION {bibinfo.warn} +{ swap$ duplicate$ missing$ + { swap$ "missing " swap$ * " in " * cite$ * warning$ pop$ "" } + { duplicate$ empty$ + { swap$ "empty " swap$ * " in " * cite$ * warning$ } + { swap$ pop$ } + if$ + } + if$ +} + + +% IEEE separates large numbers with more than 4 digits into groups of +% three. IEEE uses a small space to separate these number groups. +% Typical applications include patent and page numbers. + +% number of consecutive digits required to trigger the group separation. +FUNCTION {large.number.trigger}{ #5 } + +% For numbers longer than the trigger, this is the blocksize of the groups. +% The blocksize must be less than the trigger threshold, and 2 * blocksize +% must be greater than the trigger threshold (can't do more than one +% separation on the initial trigger). +FUNCTION {large.number.blocksize}{ #3 } + +% What is actually inserted between the number groups. +FUNCTION {large.number.separator}{ "\," } + +% So as to save on integer variables by reusing existing ones, numnames +% holds the current number of consecutive digits read and nameptr holds +% the number that will trigger an inserted space. +FUNCTION {large.number.separate} +{ 't := + "" + #0 'numnames := + large.number.trigger 'nameptr := + { t empty$ not } + { t #-1 #1 substring$ is.num + { numnames #1 + 'numnames := } + { #0 'numnames := + large.number.trigger 'nameptr := + } + if$ + t #-1 #1 substring$ swap$ * + t #-2 global.max$ substring$ 't := + numnames nameptr = + { duplicate$ #1 nameptr large.number.blocksize - substring$ swap$ + nameptr large.number.blocksize - #1 + global.max$ substring$ + large.number.separator swap$ * * + nameptr large.number.blocksize - 'numnames := + large.number.blocksize #1 + 'nameptr := + } + { skip$ } + if$ + } + while$ +} + +% Converts all single dashes "-" to double dashes "--". +FUNCTION {n.dashify} +{ large.number.separate + 't := + "" + { t empty$ not } + { t #1 #1 substring$ "-" = + { t #1 #2 substring$ "--" = not + { "--" * + t #2 global.max$ substring$ 't := + } + { { t #1 #1 substring$ "-" = } + { "-" * + t #2 global.max$ substring$ 't := + } + while$ + } + if$ + } + { t #1 #1 substring$ * + t #2 global.max$ substring$ 't := + } + if$ + } + while$ +} + + +% This function detects entries with names that are identical to that of +% the previous entry and replaces the repeated names with dashes (if the +% "is.dash.repeated.names" user control is nonzero). +FUNCTION {name.or.dash} +{ 's := + oldname empty$ + { s 'oldname := s } + { s oldname = + { is.dash.repeated.names + { repeated.name.dashes } + { s 'oldname := s } + if$ + } + { s 'oldname := s } + if$ + } + if$ +} + +% Converts the number string on the top of the stack to +% "numerical ordinal form" (e.g., "7" to "7th"). There is +% no artificial limit to the upper bound of the numbers as the +% least significant digit always determines the ordinal form. +FUNCTION {num.to.ordinal} +{ duplicate$ #-1 #1 substring$ "1" = + { bbl.st * } + { duplicate$ #-1 #1 substring$ "2" = + { bbl.nd * } + { duplicate$ #-1 #1 substring$ "3" = + { bbl.rd * } + { bbl.th * } + if$ + } + if$ + } + if$ +} + +% If the string on the top of the stack begins with a number, +% (e.g., 11th) then replace the string with the leading number +% it contains. Otherwise retain the string as-is. s holds the +% extracted number, t holds the part of the string that remains +% to be scanned. +FUNCTION {extract.num} +{ duplicate$ 't := + "" 's := + { t empty$ not } + { t #1 #1 substring$ + t #2 global.max$ substring$ 't := + duplicate$ is.num + { s swap$ * 's := } + { pop$ "" 't := } + if$ + } + while$ + s empty$ + 'skip$ + { pop$ s } + if$ +} + +% Converts the word number string on the top of the stack to +% Arabic string form. Will be successful up to "tenth". +FUNCTION {word.to.num} +{ duplicate$ "l" change.case$ 's := + s "first" = + { pop$ "1" } + { skip$ } + if$ + s "second" = + { pop$ "2" } + { skip$ } + if$ + s "third" = + { pop$ "3" } + { skip$ } + if$ + s "fourth" = + { pop$ "4" } + { skip$ } + if$ + s "fifth" = + { pop$ "5" } + { skip$ } + if$ + s "sixth" = + { pop$ "6" } + { skip$ } + if$ + s "seventh" = + { pop$ "7" } + { skip$ } + if$ + s "eighth" = + { pop$ "8" } + { skip$ } + if$ + s "ninth" = + { pop$ "9" } + { skip$ } + if$ + s "tenth" = + { pop$ "10" } + { skip$ } + if$ +} + + +% Converts the string on the top of the stack to numerical +% ordinal (e.g., "11th") form. +FUNCTION {convert.edition} +{ duplicate$ empty$ 'skip$ + { duplicate$ #1 #1 substring$ is.num + { extract.num + num.to.ordinal + } + { word.to.num + duplicate$ #1 #1 substring$ is.num + { num.to.ordinal } + { "edition ordinal word " quote$ * edition * quote$ * + " may be too high (or improper) for conversion" * " in " * cite$ * warning$ + } + if$ + } + if$ + } + if$ +} + + + + +%%%%%%%%%%%%%%%%%%%%%%%%%%%%% +%% LATEX BIBLIOGRAPHY CODE %% +%%%%%%%%%%%%%%%%%%%%%%%%%%%%% + +FUNCTION {start.entry} +{ newline$ + "\bibitem{" write$ + cite$ write$ + "}" write$ + newline$ + "" + initialize.prev.this.status +} + +% Here we write out all the LaTeX code that we will need. The most involved +% code sequences are those that control the alternate interword spacing and +% foreign language hyphenation patterns. The heavy use of \providecommand +% gives users a way to override the defaults. Special thanks to Javier Bezos, +% Johannes Braams, Robin Fairbairns, Heiko Oberdiek, Donald Arseneau and all +% the other gurus on comp.text.tex for their help and advice on the topic of +% \selectlanguage, Babel and BibTeX. +FUNCTION {begin.bib} +{ "% Generated by IEEEtranS.bst, version: " bst.file.version * " (" * bst.file.date * ")" * + write$ newline$ + preamble$ empty$ 'skip$ + { preamble$ write$ newline$ } + if$ + "\begin{thebibliography}{" longest.label * "}" * + write$ newline$ + "\providecommand{\url}[1]{#1}" + write$ newline$ + "\csname url@samestyle\endcsname" + write$ newline$ + "\providecommand{\newblock}{\relax}" + write$ newline$ + "\providecommand{\bibinfo}[2]{#2}" + write$ newline$ + "\providecommand{\BIBentrySTDinterwordspacing}{\spaceskip=0pt\relax}" + write$ newline$ + "\providecommand{\BIBentryALTinterwordstretchfactor}{" + ALTinterwordstretchfactor * "}" * + write$ newline$ + "\providecommand{\BIBentryALTinterwordspacing}{\spaceskip=\fontdimen2\font plus " + write$ newline$ + "\BIBentryALTinterwordstretchfactor\fontdimen3\font minus \fontdimen4\font\relax}" + write$ newline$ + "\providecommand{\BIBforeignlanguage}[2]{{%" + write$ newline$ + "\expandafter\ifx\csname l@#1\endcsname\relax" + write$ newline$ + "\typeout{** WARNING: IEEEtranS.bst: No hyphenation pattern has been}%" + write$ newline$ + "\typeout{** loaded for the language `#1'. Using the pattern for}%" + write$ newline$ + "\typeout{** the default language instead.}%" + write$ newline$ + "\else" + write$ newline$ + "\language=\csname l@#1\endcsname" + write$ newline$ + "\fi" + write$ newline$ + "#2}}" + write$ newline$ + "\providecommand{\BIBdecl}{\relax}" + write$ newline$ + "\BIBdecl" + write$ newline$ +} + +FUNCTION {end.bib} +{ newline$ "\end{thebibliography}" write$ newline$ } + +FUNCTION {if.url.alt.interword.spacing} +{ is.use.alt.interword.spacing + {url empty$ 'skip$ {"\BIBentryALTinterwordspacing" write$ newline$} if$} + { skip$ } + if$ +} + +FUNCTION {if.url.std.interword.spacing} +{ is.use.alt.interword.spacing + {url empty$ 'skip$ {"\BIBentrySTDinterwordspacing" write$ newline$} if$} + { skip$ } + if$ +} + + + + +%%%%%%%%%%%%%%%%%%%%%%%% +%% LONGEST LABEL PASS %% +%%%%%%%%%%%%%%%%%%%%%%%% + +FUNCTION {initialize.longest.label} +{ "" 'longest.label := + #1 'number.label := + #0 'longest.label.width := +} + +FUNCTION {longest.label.pass} +{ type$ "ieeetranbstctl" = + { skip$ } + { number.label int.to.str$ 'label := + number.label #1 + 'number.label := + label width$ longest.label.width > + { label 'longest.label := + label width$ 'longest.label.width := + } + { skip$ } + if$ + } + if$ +} + + + + +%%%%%%%%%%%%%%%%%%%%% +%% FORMAT HANDLERS %% +%%%%%%%%%%%%%%%%%%%%% + +%% Lower Level Formats (used by higher level formats) + +FUNCTION {format.address.org.or.pub.date} +{ 't := + "" + year empty$ + { "empty year in " cite$ * warning$ } + { skip$ } + if$ + address empty$ t empty$ and + year empty$ and month empty$ and + { skip$ } + { this.to.prev.status + this.status.std + cap.status.std + address "address" bibinfo.check * + t empty$ + { skip$ } + { punct.period 'prev.status.punct := + space.large 'prev.status.space := + address empty$ + { skip$ } + { ": " * } + if$ + t * + } + if$ + year empty$ month empty$ and + { skip$ } + { t empty$ address empty$ and + { skip$ } + { ", " * } + if$ + month empty$ + { year empty$ + { skip$ } + { year "year" bibinfo.check * } + if$ + } + { month "month" bibinfo.check * + year empty$ + { skip$ } + { " " * year "year" bibinfo.check * } + if$ + } + if$ + } + if$ + } + if$ +} + + +FUNCTION {format.names} +{ 'bibinfo := + duplicate$ empty$ 'skip$ { + this.to.prev.status + this.status.std + 's := + "" 't := + #1 'nameptr := + s num.names$ 'numnames := + numnames 'namesleft := + { namesleft #0 > } + { s nameptr + name.format.string + format.name$ + bibinfo bibinfo.check + 't := + nameptr #1 > + { nameptr num.names.shown.with.forced.et.al #1 + = + numnames max.num.names.before.forced.et.al > + is.forced.et.al and and + { "others" 't := + #1 'namesleft := + } + { skip$ } + if$ + namesleft #1 > + { ", " * t do.name.latex.cmd * } + { s nameptr "{ll}" format.name$ duplicate$ "others" = + { 't := } + { pop$ } + if$ + t "others" = + { " " * bbl.etal emphasize * } + { numnames #2 > + { "," * } + { skip$ } + if$ + bbl.and + space.word * t do.name.latex.cmd * + } + if$ + } + if$ + } + { t do.name.latex.cmd } + if$ + nameptr #1 + 'nameptr := + namesleft #1 - 'namesleft := + } + while$ + cap.status.std + } if$ +} + + + + +%% Higher Level Formats + +%% addresses/locations + +FUNCTION {format.address} +{ address duplicate$ empty$ 'skip$ + { this.to.prev.status + this.status.std + cap.status.std + } + if$ +} + + + +%% author/editor names + +FUNCTION {format.authors}{ author "author" format.names } + +FUNCTION {format.editors} +{ editor "editor" format.names duplicate$ empty$ 'skip$ + { ", " * + get.bbl.editor + capitalize + * + } + if$ +} + + + +%% date + +FUNCTION {format.date} +{ + month "month" bibinfo.check duplicate$ empty$ + year "year" bibinfo.check duplicate$ empty$ + { swap$ 'skip$ + { this.to.prev.status + this.status.std + cap.status.std + "there's a month but no year in " cite$ * warning$ } + if$ + * + } + { this.to.prev.status + this.status.std + cap.status.std + swap$ 'skip$ + { + swap$ + " " * swap$ + } + if$ + * + } + if$ +} + +FUNCTION {format.date.electronic} +{ month "month" bibinfo.check duplicate$ empty$ + year "year" bibinfo.check duplicate$ empty$ + { swap$ + { pop$ } + { "there's a month but no year in " cite$ * warning$ + pop$ ")" * "(" swap$ * + this.to.prev.status + punct.no 'this.status.punct := + space.normal 'this.status.space := + quote.no 'this.status.quote := + cap.yes 'status.cap := + } + if$ + } + { swap$ + { swap$ pop$ ")" * "(" swap$ * } + { "(" swap$ * ", " * swap$ * ")" * } + if$ + this.to.prev.status + punct.no 'this.status.punct := + space.normal 'this.status.space := + quote.no 'this.status.quote := + cap.yes 'status.cap := + } + if$ +} + + + +%% edition/title + +% Note: IEEE considers the edition to be closely associated with +% the title of a book. So, in IEEEtran.bst the edition is normally handled +% within the formatting of the title. The format.edition function is +% retained here for possible future use. +FUNCTION {format.edition} +{ edition duplicate$ empty$ 'skip$ + { this.to.prev.status + this.status.std + convert.edition + status.cap + { "t" } + { "l" } + if$ change.case$ + "edition" bibinfo.check + "~" * bbl.edition * + cap.status.std + } + if$ +} + +% This is used to format the booktitle of a conference proceedings. +% Here we use the "intype" field to provide the user a way to +% override the word "in" (e.g., with things like "presented at") +% Use of intype stops the emphasis of the booktitle to indicate that +% we no longer mean the written conference proceedings, but the +% conference itself. +FUNCTION {format.in.booktitle} +{ booktitle "booktitle" bibinfo.check duplicate$ empty$ 'skip$ + { this.to.prev.status + this.status.std + select.language + intype missing$ + { emphasize + bbl.in " " * + } + { intype " " * } + if$ + swap$ * + cap.status.std + } + if$ +} + +% This is used to format the booktitle of collection. +% Here the "intype" field is not supported, but "edition" is. +FUNCTION {format.in.booktitle.edition} +{ booktitle "booktitle" bibinfo.check duplicate$ empty$ 'skip$ + { this.to.prev.status + this.status.std + select.language + emphasize + edition empty$ 'skip$ + { ", " * + edition + convert.edition + "l" change.case$ + * "~" * bbl.edition * + } + if$ + bbl.in " " * swap$ * + cap.status.std + } + if$ +} + +FUNCTION {format.article.title} +{ title duplicate$ empty$ 'skip$ + { this.to.prev.status + this.status.std + "t" change.case$ + } + if$ + "title" bibinfo.check + duplicate$ empty$ 'skip$ + { quote.close 'this.status.quote := + is.last.char.not.punct + { punct.std 'this.status.punct := } + { punct.no 'this.status.punct := } + if$ + select.language + "``" swap$ * + cap.status.std + } + if$ +} + +FUNCTION {format.article.title.electronic} +{ title duplicate$ empty$ 'skip$ + { this.to.prev.status + this.status.std + cap.status.std + "t" change.case$ + } + if$ + "title" bibinfo.check + duplicate$ empty$ + { skip$ } + { select.language } + if$ +} + +FUNCTION {format.book.title.edition} +{ title "title" bibinfo.check + duplicate$ empty$ + { "empty title in " cite$ * warning$ } + { this.to.prev.status + this.status.std + select.language + emphasize + edition empty$ 'skip$ + { ", " * + edition + convert.edition + status.cap + { "t" } + { "l" } + if$ + change.case$ + * "~" * bbl.edition * + } + if$ + cap.status.std + } + if$ +} + +FUNCTION {format.book.title} +{ title "title" bibinfo.check + duplicate$ empty$ 'skip$ + { this.to.prev.status + this.status.std + cap.status.std + select.language + emphasize + } + if$ +} + + + +%% journal + +FUNCTION {format.journal} +{ journal duplicate$ empty$ 'skip$ + { this.to.prev.status + this.status.std + cap.status.std + select.language + emphasize + } + if$ +} + + + +%% how published + +FUNCTION {format.howpublished} +{ howpublished duplicate$ empty$ 'skip$ + { this.to.prev.status + this.status.std + cap.status.std + } + if$ +} + + + +%% institutions/organization/publishers/school + +FUNCTION {format.institution} +{ institution duplicate$ empty$ 'skip$ + { this.to.prev.status + this.status.std + cap.status.std + } + if$ +} + +FUNCTION {format.organization} +{ organization duplicate$ empty$ 'skip$ + { this.to.prev.status + this.status.std + cap.status.std + } + if$ +} + +FUNCTION {format.address.publisher.date} +{ publisher "publisher" bibinfo.warn format.address.org.or.pub.date } + +FUNCTION {format.address.publisher.date.nowarn} +{ publisher "publisher" bibinfo.check format.address.org.or.pub.date } + +FUNCTION {format.address.organization.date} +{ organization "organization" bibinfo.check format.address.org.or.pub.date } + +FUNCTION {format.school} +{ school duplicate$ empty$ 'skip$ + { this.to.prev.status + this.status.std + cap.status.std + } + if$ +} + + + +%% volume/number/series/chapter/pages + +FUNCTION {format.volume} +{ volume empty.field.to.null.string + duplicate$ empty$ 'skip$ + { this.to.prev.status + this.status.std + bbl.volume + status.cap + { capitalize } + { skip$ } + if$ + swap$ tie.or.space.prefix + "volume" bibinfo.check + * * + cap.status.std + } + if$ +} + +FUNCTION {format.number} +{ number empty.field.to.null.string + duplicate$ empty$ 'skip$ + { this.to.prev.status + this.status.std + status.cap + { bbl.number capitalize } + { bbl.number } + if$ + swap$ tie.or.space.prefix + "number" bibinfo.check + * * + cap.status.std + } + if$ +} + +FUNCTION {format.number.if.use.for.article} +{ is.use.number.for.article + { format.number } + { "" } + if$ +} + +% IEEE does not seem to tie the series so closely with the volume +% and number as is done in other bibliography styles. Instead the +% series is treated somewhat like an extension of the title. +FUNCTION {format.series} +{ series empty$ + { "" } + { this.to.prev.status + this.status.std + bbl.series " " * + series "series" bibinfo.check * + cap.status.std + } + if$ +} + + +FUNCTION {format.chapter} +{ chapter empty$ + { "" } + { this.to.prev.status + this.status.std + type empty$ + { bbl.chapter } + { type "l" change.case$ + "type" bibinfo.check + } + if$ + chapter tie.or.space.prefix + "chapter" bibinfo.check + * * + cap.status.std + } + if$ +} + + +% The intended use of format.paper is for paper numbers of inproceedings. +% The paper type can be overridden via the type field. +% We allow the type to be displayed even if the paper number is absent +% for things like "postdeadline paper" +FUNCTION {format.paper} +{ is.use.paper + { paper empty$ + { type empty$ + { "" } + { this.to.prev.status + this.status.std + type "type" bibinfo.check + cap.status.std + } + if$ + } + { this.to.prev.status + this.status.std + type empty$ + { bbl.paper } + { type "type" bibinfo.check } + if$ + " " * paper + "paper" bibinfo.check + * + cap.status.std + } + if$ + } + { "" } + if$ +} + + +FUNCTION {format.pages} +{ pages duplicate$ empty$ 'skip$ + { this.to.prev.status + this.status.std + duplicate$ is.multiple.pages + { + bbl.pages swap$ + n.dashify + } + { + bbl.page swap$ + } + if$ + tie.or.space.prefix + "pages" bibinfo.check + * * + cap.status.std + } + if$ +} + + + +%% technical report number + +FUNCTION {format.tech.report.number} +{ number "number" bibinfo.check + this.to.prev.status + this.status.std + cap.status.std + type duplicate$ empty$ + { pop$ + bbl.techrep + } + { skip$ } + if$ + "type" bibinfo.check + swap$ duplicate$ empty$ + { pop$ } + { tie.or.space.prefix * * } + if$ +} + + + +%% note + +FUNCTION {format.note} +{ note empty$ + { "" } + { this.to.prev.status + this.status.std + punct.period 'this.status.punct := + note #1 #1 substring$ + duplicate$ "{" = + { skip$ } + { status.cap + { "u" } + { "l" } + if$ + change.case$ + } + if$ + note #2 global.max$ substring$ * "note" bibinfo.check + cap.yes 'status.cap := + } + if$ +} + + + +%% patent + +FUNCTION {format.patent.date} +{ this.to.prev.status + this.status.std + year empty$ + { monthfiled duplicate$ empty$ + { "monthfiled" bibinfo.check pop$ "" } + { "monthfiled" bibinfo.check } + if$ + dayfiled duplicate$ empty$ + { "dayfiled" bibinfo.check pop$ "" * } + { "dayfiled" bibinfo.check + monthfiled empty$ + { "dayfiled without a monthfiled in " cite$ * warning$ + * + } + { " " swap$ * * } + if$ + } + if$ + yearfiled empty$ + { "no year or yearfiled in " cite$ * warning$ } + { yearfiled "yearfiled" bibinfo.check + swap$ + duplicate$ empty$ + { pop$ } + { ", " * swap$ * } + if$ + } + if$ + } + { month duplicate$ empty$ + { "month" bibinfo.check pop$ "" } + { "month" bibinfo.check } + if$ + day duplicate$ empty$ + { "day" bibinfo.check pop$ "" * } + { "day" bibinfo.check + month empty$ + { "day without a month in " cite$ * warning$ + * + } + { " " swap$ * * } + if$ + } + if$ + year "year" bibinfo.check + swap$ + duplicate$ empty$ + { pop$ } + { ", " * swap$ * } + if$ + } + if$ + cap.status.std +} + +FUNCTION {format.patent.nationality.type.number} +{ this.to.prev.status + this.status.std + nationality duplicate$ empty$ + { "nationality" bibinfo.warn pop$ "" } + { "nationality" bibinfo.check + duplicate$ "l" change.case$ "united states" = + { pop$ bbl.patentUS } + { skip$ } + if$ + " " * + } + if$ + type empty$ + { bbl.patent "type" bibinfo.check } + { type "type" bibinfo.check } + if$ + * + number duplicate$ empty$ + { "number" bibinfo.warn pop$ } + { "number" bibinfo.check + large.number.separate + swap$ " " * swap$ * + } + if$ + cap.status.std +} + + + +%% standard + +FUNCTION {format.organization.institution.standard.type.number} +{ this.to.prev.status + this.status.std + organization duplicate$ empty$ + { pop$ + institution duplicate$ empty$ + { "institution" bibinfo.warn } + { "institution" bibinfo.warn " " * } + if$ + } + { "organization" bibinfo.warn " " * } + if$ + type empty$ + { bbl.standard "type" bibinfo.check } + { type "type" bibinfo.check } + if$ + * + number duplicate$ empty$ + { "number" bibinfo.check pop$ } + { "number" bibinfo.check + large.number.separate + swap$ " " * swap$ * + } + if$ + cap.status.std +} + +FUNCTION {format.revision} +{ revision empty$ + { "" } + { this.to.prev.status + this.status.std + bbl.revision + revision tie.or.space.prefix + "revision" bibinfo.check + * * + cap.status.std + } + if$ +} + + +%% thesis + +FUNCTION {format.master.thesis.type} +{ this.to.prev.status + this.status.std + type empty$ + { + bbl.mthesis + } + { + type "type" bibinfo.check + } + if$ +cap.status.std +} + +FUNCTION {format.phd.thesis.type} +{ this.to.prev.status + this.status.std + type empty$ + { + bbl.phdthesis + } + { + type "type" bibinfo.check + } + if$ +cap.status.std +} + + + +%% URL + +FUNCTION {format.url} +{ url empty$ + { "" } + { this.to.prev.status + this.status.std + cap.yes 'status.cap := + name.url.prefix " " * + "\url{" * url * "}" * + punct.no 'this.status.punct := + punct.period 'prev.status.punct := + space.normal 'this.status.space := + space.normal 'prev.status.space := + quote.no 'this.status.quote := + } + if$ +} + + + + +%%%%%%%%%%%%%%%%%%%% +%% ENTRY HANDLERS %% +%%%%%%%%%%%%%%%%%%%% + + +% Note: In many journals, IEEE (or the authors) tend not to show the number +% for articles, so the display of the number is controlled here by the +% switch "is.use.number.for.article" +FUNCTION {article} +{ std.status.using.comma + start.entry + if.url.alt.interword.spacing + format.authors "author" output.warn + name.or.dash + format.article.title "title" output.warn + format.journal "journal" bibinfo.check "journal" output.warn + format.volume output + format.number.if.use.for.article output + format.pages output + format.date "year" output.warn + format.note output + format.url output + fin.entry + if.url.std.interword.spacing +} + +FUNCTION {book} +{ std.status.using.comma + start.entry + if.url.alt.interword.spacing + author empty$ + { format.editors "author and editor" output.warn } + { format.authors output.nonnull } + if$ + name.or.dash + format.book.title.edition output + format.series output + author empty$ + { skip$ } + { format.editors output } + if$ + format.address.publisher.date output + format.volume output + format.number output + format.note output + format.url output + fin.entry + if.url.std.interword.spacing +} + +FUNCTION {booklet} +{ std.status.using.comma + start.entry + if.url.alt.interword.spacing + format.authors output + name.or.dash + format.article.title "title" output.warn + format.howpublished "howpublished" bibinfo.check output + format.organization "organization" bibinfo.check output + format.address "address" bibinfo.check output + format.date output + format.note output + format.url output + fin.entry + if.url.std.interword.spacing +} + +FUNCTION {electronic} +{ std.status.using.period + start.entry + if.url.alt.interword.spacing + format.authors output + name.or.dash + format.date.electronic output + format.article.title.electronic output + format.howpublished "howpublished" bibinfo.check output + format.organization "organization" bibinfo.check output + format.address "address" bibinfo.check output + format.note output + format.url output + fin.entry + empty.entry.warn + if.url.std.interword.spacing +} + +FUNCTION {inbook} +{ std.status.using.comma + start.entry + if.url.alt.interword.spacing + author empty$ + { format.editors "author and editor" output.warn } + { format.authors output.nonnull } + if$ + name.or.dash + format.book.title.edition output + format.series output + format.address.publisher.date output + format.volume output + format.number output + format.chapter output + format.pages output + format.note output + format.url output + fin.entry + if.url.std.interword.spacing +} + +FUNCTION {incollection} +{ std.status.using.comma + start.entry + if.url.alt.interword.spacing + format.authors "author" output.warn + name.or.dash + format.article.title "title" output.warn + format.in.booktitle.edition "booktitle" output.warn + format.series output + format.editors output + format.address.publisher.date.nowarn output + format.volume output + format.number output + format.chapter output + format.pages output + format.note output + format.url output + fin.entry + if.url.std.interword.spacing +} + +FUNCTION {inproceedings} +{ std.status.using.comma + start.entry + if.url.alt.interword.spacing + format.authors "author" output.warn + name.or.dash + format.article.title "title" output.warn + format.in.booktitle "booktitle" output.warn + format.series output + format.editors output + format.volume output + format.number output + publisher empty$ + { format.address.organization.date output } + { format.organization "organization" bibinfo.check output + format.address.publisher.date output + } + if$ + format.paper output + format.pages output + format.note output + format.url output + fin.entry + if.url.std.interword.spacing +} + +FUNCTION {manual} +{ std.status.using.comma + start.entry + if.url.alt.interword.spacing + format.authors output + name.or.dash + format.book.title.edition "title" output.warn + format.howpublished "howpublished" bibinfo.check output + format.organization "organization" bibinfo.check output + format.address "address" bibinfo.check output + format.date output + format.note output + format.url output + fin.entry + if.url.std.interword.spacing +} + +FUNCTION {mastersthesis} +{ std.status.using.comma + start.entry + if.url.alt.interword.spacing + format.authors "author" output.warn + name.or.dash + format.article.title "title" output.warn + format.master.thesis.type output.nonnull + format.school "school" bibinfo.warn output + format.address "address" bibinfo.check output + format.date "year" output.warn + format.note output + format.url output + fin.entry + if.url.std.interword.spacing +} + +FUNCTION {misc} +{ std.status.using.comma + start.entry + if.url.alt.interword.spacing + format.authors output + name.or.dash + format.article.title output + format.howpublished "howpublished" bibinfo.check output + format.organization "organization" bibinfo.check output + format.address "address" bibinfo.check output + format.pages output + format.date output + format.note output + format.url output + fin.entry + empty.entry.warn + if.url.std.interword.spacing +} + +FUNCTION {patent} +{ std.status.using.comma + start.entry + if.url.alt.interword.spacing + format.authors output + name.or.dash + format.article.title output + format.patent.nationality.type.number output + format.patent.date output + format.note output + format.url output + fin.entry + empty.entry.warn + if.url.std.interword.spacing +} + +FUNCTION {periodical} +{ std.status.using.comma + start.entry + if.url.alt.interword.spacing + format.editors output + name.or.dash + format.book.title "title" output.warn + format.series output + format.volume output + format.number output + format.organization "organization" bibinfo.check output + format.date "year" output.warn + format.note output + format.url output + fin.entry + if.url.std.interword.spacing +} + +FUNCTION {phdthesis} +{ std.status.using.comma + start.entry + if.url.alt.interword.spacing + format.authors "author" output.warn + name.or.dash + format.article.title "title" output.warn + format.phd.thesis.type output.nonnull + format.school "school" bibinfo.warn output + format.address "address" bibinfo.check output + format.date "year" output.warn + format.note output + format.url output + fin.entry + if.url.std.interword.spacing +} + +FUNCTION {proceedings} +{ std.status.using.comma + start.entry + if.url.alt.interword.spacing + format.editors output + name.or.dash + format.book.title "title" output.warn + format.series output + format.volume output + format.number output + publisher empty$ + { format.address.organization.date output } + { format.organization "organization" bibinfo.check output + format.address.publisher.date output + } + if$ + format.note output + format.url output + fin.entry + if.url.std.interword.spacing +} + +FUNCTION {standard} +{ std.status.using.comma + start.entry + if.url.alt.interword.spacing + format.authors output + name.or.dash + format.book.title "title" output.warn + format.howpublished "howpublished" bibinfo.check output + format.organization.institution.standard.type.number output + format.revision output + format.date output + format.note output + format.url output + fin.entry + if.url.std.interword.spacing +} + +FUNCTION {techreport} +{ std.status.using.comma + start.entry + if.url.alt.interword.spacing + format.authors "author" output.warn + name.or.dash + format.article.title "title" output.warn + format.howpublished "howpublished" bibinfo.check output + format.institution "institution" bibinfo.warn output + format.address "address" bibinfo.check output + format.tech.report.number output.nonnull + format.date "year" output.warn + format.note output + format.url output + fin.entry + if.url.std.interword.spacing +} + +FUNCTION {unpublished} +{ std.status.using.comma + start.entry + if.url.alt.interword.spacing + format.authors "author" output.warn + name.or.dash + format.article.title "title" output.warn + format.date output + format.note "note" output.warn + format.url output + fin.entry + if.url.std.interword.spacing +} + + +% The special entry type which provides the user interface to the +% BST controls +FUNCTION {IEEEtranBSTCTL} +{ is.print.banners.to.terminal + { "** IEEEtran BST control entry " quote$ * cite$ * quote$ * " detected." * + top$ + } + { skip$ } + if$ + CTLuse_article_number + empty$ + { skip$ } + { CTLuse_article_number + yes.no.to.int + 'is.use.number.for.article := + } + if$ + CTLuse_paper + empty$ + { skip$ } + { CTLuse_paper + yes.no.to.int + 'is.use.paper := + } + if$ + CTLuse_forced_etal + empty$ + { skip$ } + { CTLuse_forced_etal + yes.no.to.int + 'is.forced.et.al := + } + if$ + CTLmax_names_forced_etal + empty$ + { skip$ } + { CTLmax_names_forced_etal + string.to.integer + 'max.num.names.before.forced.et.al := + } + if$ + CTLnames_show_etal + empty$ + { skip$ } + { CTLnames_show_etal + string.to.integer + 'num.names.shown.with.forced.et.al := + } + if$ + CTLuse_alt_spacing + empty$ + { skip$ } + { CTLuse_alt_spacing + yes.no.to.int + 'is.use.alt.interword.spacing := + } + if$ + CTLalt_stretch_factor + empty$ + { skip$ } + { CTLalt_stretch_factor + 'ALTinterwordstretchfactor := + "\renewcommand{\BIBentryALTinterwordstretchfactor}{" + ALTinterwordstretchfactor * "}" * + write$ newline$ + } + if$ + CTLdash_repeated_names + empty$ + { skip$ } + { CTLdash_repeated_names + yes.no.to.int + 'is.dash.repeated.names := + } + if$ + CTLname_format_string + empty$ + { skip$ } + { CTLname_format_string + 'name.format.string := + } + if$ + CTLname_latex_cmd + empty$ + { skip$ } + { CTLname_latex_cmd + 'name.latex.cmd := + } + if$ + CTLname_url_prefix + missing$ + { skip$ } + { CTLname_url_prefix + 'name.url.prefix := + } + if$ + + + num.names.shown.with.forced.et.al max.num.names.before.forced.et.al > + { "CTLnames_show_etal cannot be greater than CTLmax_names_forced_etal in " cite$ * warning$ + max.num.names.before.forced.et.al 'num.names.shown.with.forced.et.al := + } + { skip$ } + if$ +} + + +%%%%%%%%%%%%%%%%%%% +%% ENTRY ALIASES %% +%%%%%%%%%%%%%%%%%%% +FUNCTION {conference}{inproceedings} +FUNCTION {online}{electronic} +FUNCTION {internet}{electronic} +FUNCTION {webpage}{electronic} +FUNCTION {www}{electronic} +FUNCTION {default.type}{misc} + + + +%%%%%%%%%%%%%%%%%% +%% MAIN PROGRAM %% +%%%%%%%%%%%%%%%%%% + +READ + +EXECUTE {initialize.controls} +EXECUTE {initialize.status.constants} +EXECUTE {banner.message} + + + +% BEGIN sort code based on that of plain.bst + +FUNCTION {sortify} +{ purify$ + "l" change.case$ +} + +INTEGERS { len } + +FUNCTION {chop.word} +{ 's := + 'len := + s #1 len substring$ = + { s len #1 + global.max$ substring$ } + { s } + if$ +} + +FUNCTION {sort.format.names} +{ 's := + #1 'nameptr := + "" + s num.names$ 'numnames := + numnames 'namesleft := + { namesleft #0 > } + { nameptr #1 > + { " " * } + { skip$ } + if$ + s nameptr "{vv{ } }{ll{ }}{ ff{ }}{ jj{ }}" format.name$ 't := + nameptr numnames = t "others" = and + { "et al" * } + { t sortify * } + if$ + nameptr #1 + 'nameptr := + namesleft #1 - 'namesleft := + } + while$ +} + +FUNCTION {sort.format.title} +{ 't := + "A " #2 + "An " #3 + "The " #4 t chop.word + chop.word + chop.word + sortify + #1 global.max$ substring$ +} + +FUNCTION {author.sort} +{ author empty$ + { key empty$ + { "to sort, need author or key in " cite$ * warning$ "" } + { key sortify } + if$ + } + { author sort.format.names } + if$ +} + +FUNCTION {author.editor.sort} +{ author empty$ + { editor empty$ + { key empty$ + { "to sort, need author, editor, or key in " cite$ * warning$ "" } + { key sortify } + if$ + } + { editor sort.format.names } + if$ + } + { author sort.format.names } + if$ +} + +FUNCTION {author.organization.sort} +{ author empty$ + { organization empty$ + { key empty$ + { "to sort, need author, organization, or key in " cite$ * warning$ "" } + { key sortify } + if$ + } + { "The " #4 organization chop.word sortify } + if$ + } + { author sort.format.names } + if$ +} + +FUNCTION {editor.organization.sort} +{ editor empty$ + { organization empty$ + { key empty$ + { "to sort, need editor, organization, or key in " cite$ * warning$ "" } + { key sortify } + if$ + } + { "The " #4 organization chop.word sortify } + if$ + } + { editor sort.format.names } + if$ +} + +FUNCTION {author.organization.institution.sort} +{ author empty$ + { organization empty$ + { institution empty$ + { key empty$ + { "to sort, need author, organization, institution or key in " cite$ * warning$ "" } + { key sortify } + if$ + } + { "The " #4 institution chop.word sortify } + if$ + } + { "The " #4 organization chop.word sortify } + if$ + } + { author sort.format.names } + if$ +} + + +FUNCTION {presort} +{ type$ "ieeetranbstctl" = + { key empty$ + { "_" } + { key sortify } + if$ + } + { type$ "book" = + type$ "inbook" = + or + { author.editor.sort } + { type$ "proceedings" = + type$ "periodical" = + or + { editor.organization.sort } + { type$ "manual" = + type$ "electronic" = + type$ "misc" = + or or + { author.organization.sort } + { type$ "standard" = + { author.organization.institution.sort } + { author.sort } + if$ + } + if$ + } + if$ + } + if$ + " " + * + type$ "patent" = + { year empty$ + { yearfiled } + { year } + if$ + } + { year } + if$ + empty.field.to.null.string sortify + * + " " + * + title empty.field.to.null.string + sort.format.title + * + } + if$ + #1 entry.max$ substring$ + 'sort.key$ := +} + +ITERATE {presort} + +SORT + +% END sort code based on that of plain.bst + + + +EXECUTE {initialize.longest.label} +ITERATE {longest.label.pass} + +EXECUTE {begin.bib} +ITERATE {call.type$} +EXECUTE {end.bib} + +EXECUTE{completed.message} + + +%% That's all folks, mds. diff --git a/IEEEtran/IEEEtran_HOWTO.pdf b/IEEEtran/IEEEtran_HOWTO.pdf new file mode 100644 index 0000000000000000000000000000000000000000..f196c7f8d9064c1ec82c8c569d609dda106ee8f7 GIT binary patch literal 705216 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%0DGqC>f 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� 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

w3bj|SBUT*eXx$o0 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%0AJqz1gH)Dm1h25sV!6CJ*1v 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

@7#lEmvtQ(Kqt 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 c?Xv~~6o7zxFOAB1R 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

vHgm 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 }dYX1Kzd-uPMB}@+ZZk3Dy@os$ zj`+E_wu(uI95Gz_1vQj60Uh*Oi(F#=ixp;+*l2_{P6U>09zuVl97#BBE~*G$n`&Xn zFU$c?yP)WMK0izj9HT{AiG6j@rc(J(M9wSvB}-H9@I?m6W)`DNJq>w+LjPu&CD@OGULTkz4eBWy9@oz%=i*{PI{lE@Um8-Rk{SWkqLio=mB_6)9z&JsL5ud^e_JtaSMv-=@cB=1Z5*cod zgXQM)r?Q~YKIHGG)fmz=K+|9j>&4H{)~3_E8X#8NTc^XSv`Ybf zUF-O`teMa*?)FKF#WDdu^U)z&p4|Q=kDdqVmHm6Mu=K;qw{=7BK0djz!PqGD-t!r8 zz#tSwnNi6|^*zCbsXTaBiRs#$xG3CqUp(emn+BUrZncU25zj3q%C-`H!IJ={)-1!7HAi3g~E3rW;fakr%ca( z_UQ1(Z0)~zbhwLX{^`--x90?DLjzM?L2DOs^*dM&b|82AdqY(eW(5;ROFi=MIs5|Bz=8LR-gl=j=HjMpRz41 z-0ree<@js|dcrLFuhC)OIyf%AG$RzBiamJ#W_QFEo#WY7UNqS*YY;~Gsz@|`V{hM> zDyFc^*kqAr2?&SBQlu-;O#MaCz*JF|f$GF|iB0gaXKv6{qCV=4+haj7+t;m>)bzC> zDhZ0(LdC>wJW0sV%y?H7hh=C~d#|Ss`U)NP6z0CH zQ5kvUYp$V3I|{Y$%eF9oMEQoEsIQ*TFVCmL!n=Wyp48~v($vi!_k0J)1#DxvB3L9O zMjyja3=f7&t}C?{x{0r&ml!$UFlg#ilQ3kPN@QNH^oYjme~#|>w5jL--B+cx=G(+R zewR;`PjZFdvDus)R!a{Hwbzm05G%v;lQ}5W;W2*E5q^!w4TBdH8{=utm{+8k=nrZS z;(ZcEY4o#8`tC=F^;64~qTs`cEXw$=E1bqks&>AHNQD}^1+*hN?7XYWDz_%I7$=QV zDMBpaox^9uVt8tf%YG7?c8jKs+RPu(HBOGDzP^s=(SBx3=z>%tK0iZZAQyn>EZ%Er?1)B#I-a${TP=wl89dUYz*!u% z@=1ZCKQxF zAlP2RWRhP-(2Y~Ok`o>bM7&xXiX^G|R6Ugcd?WRF%S?gDx7hVdw|Qua&Wz#9`Opo^ z8cd&*M@Pc-wuF+5>mD15Im8`00oG4jbf5}aw*8`BW|M6RAnZ;(Qq`Xd1Kg zSr47FL-r7z9bEH?J$1B*2Hp%D+n=T*8)Tb7To_g>Um56P8tKW|mThcsxh;wkg@ zX`9ml(0rl1LziS%m*p9+&@wYE@o(ASn6D4I@UqBFUVf}Jye0(7LaVXbSlNlc8RcPq zMeuT5ys#|~XC-igc_c-nlgtAhYoDt~j!c(Or1UZC$|zjAM`@#4NmUf}iD zOc{7t(rb`pzUcde065;jQWjP{sN{cDhg} zgP)Bc{a0E?PYOITp*r)M`?)0!6uKn%QszA=%S-Aum_F+Pk8*@w`hD6WM|en>JDsSQ zU^bxz-}|Tv1#U%Ac(wj558hWR?7SvTi*WWKG^+i`V+I-Q#Zzn~Edl2S9rrgcix;C&sWxgY@LjA8nGMSi~;^{wQ#c{JDB;VSLhdE=X}S9AhSUajKBwkRzj zk%x+_2wH@vOH(6Jwm4v$QFNilbRnsfUV^?`9aK2aUdzT^r&?}@#q4LKWX}%UKa$_p z<195dB_B24b%@y`AXE4tu_+7{tS9skWeub_Fvr0B0VGU8jK8F5RwMUiBY<6DQgIp_ z{Z?$08M8TIX6b^eDh_Vx3vYVI#W(Z-K5PTyl*|(SzAyGTH>L!HFQIcX2nbo0Ur56H zohiHN(-ur*yQQKd=OwJ0nTrIMbEdKoYJ}1h?UmXAL$2yw449fHEIP_)g^P2A&0pSPaKD}qiFnqHCfz@d?j!q% zRot6;NBgN62nMeO&T%dO)(we>1XUpR1{3#FmT3m+#5IRuLG+R)|LCgxIUB)NU0=Zq zxf$EfA766hiRpe?shu276c{x7Oy@TgL_6=v%epoQHwBxr2;#xU6|geMpWx5-gYX}l zCx-2^KzTdX8u(+_Vp1dy_?=F;;~Sz=VXGq3eB|rQVpCR1434`eVIU>H;d;MUQ{Rrq zLQ0q%Ug#BCxB5qu`3Hm{lA(6am`OI6%aX5N5QPnK&S@;b6|;@`#Bznh)fe_^tjI#S>^Qf_&f1gp^Cs``%SQ-!1b>@K&hx!CRb@GnnYnk;y0s! zs%k>w#2X|>iou+B0)NvDFx~3B_jnsq=gSSY^1~+z2H706`|XvY#^Y4X(*-VIS&G$DGWA5gI%)H+h&ewQ(?lFM-!1F^xhZka2mX)ChD5TwzkRa zIV>Y6HjPHO$0}wg%3wWl&3ZtRP=gH8n6~eDIxH`5@=PO__cN{8`}K_dX$;Gy9YYJ zJNV1xyI%V1nL3w)fxt$Lr+BXfK;Nia0$Iuht^{#=I?$ovUx3&xh{aPc5hYn)Y_W?{JWjl#NqEP&tU!b;d;8bI1nSIUrQ)Z1MSCV%h^DN|^9< zNn~VDKPM?`0Rj3{zY+09edkum$cPo0S5I$SE}y%`!KyS&Ei8if!XD!Z-ATe;k5D(p zaxB3s?_4=STw>DB+yougui4Nza8^O|6gaT&D>k8VNXbA-j#RKl8YUb%7FpKAU4Eio z+J+x}*Ll3#LdjI@21wF)p#9&calXlp9M;}Zh5H2R5+S4{zvT=QGa`c4&Kj^)g@18< zpU?!Rf5^7y!|jnlQ;<9d<_MEaThw%_f!y_Yofx{2HpuMr@avY0RFgmfk{Rf6+X0K( ztmpP}3tk<0Hj*w&(yovN%ix40V(8~yBzd6Z8>DynHY!|QOLDoUM;+}{dK_pgHf9He z?0hbtSNwX4tPBpqPs{C zd@cyI@s+s6Tmjr3s&Sa=coPBK`<{VAus39R9T^9%3}u!05DVA~gQpEM9ScvI)p)uG_Qk!%P%jb4;hbtzdG1m-@W@GN5)0>wVO6Dhk2`*yUE7Fz>e3?*XapFpp)J z^+ElBttj^5<`gega?RJwWsEJn!J#W;`IeH*9QrW_WyRY)QxpnV0vHL~7&j~0H~Pz@ zECUQ>6ffUt&p^$SDc1C=&wEuCOqQn~X&0fm^%FbH;K+ux61wdmPZuY&b7NUy=HL_< zJz7ZId@gscNZNB!zzJ(ANpiJWNU(*6as4vXiX)#Hx85|>C`!yYjt_A^3Mzu@4G$KM zj7U715{~ssrto=d7%{RordycK z8fPDx(JGtw*dCoHekFgkmjpWF8|s~686#s!kwv#Dpr^u+QpSw*fR95;Z9aZ~R^)%c zHarxqB+-5_9a~?5zk=mswRmIW=Mcv8_1FtHa9a$UmyaKg;CX3R#l2$iSr$8N?+_3a@tvaDbo6~^`Sz&PiDRK0AfGhP?TIU zlK*1%%t}GC7!kd*la3WNc5~1I-zXn^|Ji2V6Haxk`swEmT{})1EGd?~7bFVj8EppE zA#WZcJ3qO_EK`al&17$jq7x8FFuT6Ge=Gf_BcnJN*U z3RGoA(mC^LsjSAboiM%gnIqE{gE~iQ zy+Wie+;?teBm0K6w+!`Wr$d%n#cT98mx05+R#?bgHu@Q#QIWqDoa-6D`=nf$LV_7O z#d=Z1q6{ZE14@wFH6`bKM-KW}oxZj7^@%Acmc^LTg8i1IhsAT1%dNR7`9{h%sQTbJ)+5C*a2PN!hNUI+9X68o;x!Gis@Q!LS1Ny(Nuo?jUJ5pm-;mo$uPoaM z2ra)tOS4{%Hoy_Ce?dBgDiU12(sJg6Y7^pXo@X*~=bQ9zGOj4wMr+!rRIqHxj4?lW zpfim-pd-72tV8GbjUgUsWxPRg1~PRowru&jhU+DKRtQ>lnia1$6R;)5ULq+u$$IP4 zh%?4W77^zaXbTVHVy_1Dh<9~6#rRSqP7Vr|S^{a{ocSzJpG@huJ2O?~4WO9xU56nl zKxqyVcy6fUg|uAzl6j~b9~Zq*lcB-Q+M-R^s$(e%!OI)cVz61io%iLL);`stLm5w= zx|GlG5ae5Ny;q-kh0FM`X`A}tgK?lpyP&O!f%r+E5AKt?(hEAsWJiO>r#BG_!u~^) zmSC&gmsq|cJ667zjc)AuTus=-7ImvWL|(+@`S)3uTQFq&_aiTpb-N58%NsBIUhco} zt_4bMA7;{z#B5uv=A=*Q@`Q_3gun3C;tsY1_IWNKvbNKmYWe}*yuQ1jO`xUv!D6Fn z7Rc5r{cSEgV$|e&Ua5A98)|K0$}ASCD?;Q9wY7oA#t}?XFzOfc!<+qk4GNvi#m_tC zd}>DzzMi@veu9hq(x6eYRW!~~^Gr^2`^BU#KilI zAtw!e2XH&Ai2@ioPP7xcssz*ehYy@d#@&u3P4@^duC@&kw6g9*X~)I(s& z-JvO_QPF#C*LLu%7I&g}Kl>waG86i5!o^tDf*(42yjqR+PX|;c22h!Y`$+GbT|G&- z6Yxy;`6Gw~vRvb7&gooL(s(hD$0S9ADbbB}EFR$kQhq1b~OSCjBaW0qdRoRY{s zS(#jCdEEZw9Ua{Qsgsu9fR^=?Fg#+xK%f6CA0fIKY8binr0|)okh-qvl$16U6h&Y5 z<964c&GeXZ*U_$AB4r-akRHd5G~`tB(|fpRlV@2TPkld<&?`<138_6g)U-hz)B3p7 z=^^}Jq@UT?>NE-2r47;8*0~hfr*^5yFG3KVG@m@`gFm_Pw^R4IX)G#h9FgP5v{E6wlu=&6M9p$6Vn!Ozhh+pVIpt3QSmK~dsAk! zzC?Yvrvt)WrMx$IjhwoJQA#W1-F+*F=v0U>o^qvdX5N>w-T!cdd)&bYp3_qxWw)3)D{V3%leQ zRo-aZ8S1>QFMc`X%s2nQ!1=Tk?0W4!#;Y_DgT5d(+x4NLI9E$FP-Rtc0$zFz_A;$# z;KSb34zlHNjh{6vnc4dRd4d`J{S}&?5o%klkLUTdZPOO|8(SAhnp7Vjt@!ddNF%dv z%wm-YiO)-^6nDQ6V1Z6-Rl8@NgBcY}bIG?oi8XIC-EgD1TzCRxbfewoVlC|z>WyL0TTw@^K*C~Kt0|2pq+YS z?Ov!j_r{T!9$fYYT(>wc{Byu)WCui&bH9ayFx3Zcyjr@KUAuHXyC{=N|E;-{h%HDu zsS&2m#>GQA@=HtCw&qALUEkP*QSh;0Q~LH-Q}UPdToUaFABOh_R7q4P(K2>RX6{dY zzEzr@Z+caso9;4(n1UT-?NBE*Q#U5&LP5M^Um387egcD~|UK$GXzx=ys~ zVf3bjO!W!j>sjZU`th=L#zOAlm})2QR)RUb`bF5OP~Up+tvYXvHa9x3F5nbMN!P=kWKoclu{4BU zMldg=513PQ^@2(Sc|iEO7hy-Rr{kx(U~#a9>RMt1}sva_ANXFU_hlD;iPS zivVH2US=|FXHd6f{KO8Qa24}Wibs&z4QHBf#sE7)YeeJ{2V|e0sorlfP6xJ?w4HlL z(gcF!HFT&Y$>(_g;iDtiBO0c>AnP}Sw8aUm+h(v7Dl*Ei13Yd_4a)e@)7U?Tx(;&K zy(#z@Sr?~PG}DF#D??U+c<2i+H6O9*7%@*R&1dqhX&vFSr$x{XBL zqj*A5?^n-QA4+lP+i;G;t+uV$(m#kRzWySKugLB+^zo#zd%~9H@t8BN+Y@~Cm&>3S z8zhH3BD2lCcb)WN$v}(2ohpoy1;izHArCtq#KkI}cIoRD3|J%+R}dF!RFfxz{3@lD)1{3-3D) z$if2laiQELvs*Le&J_40CX~#n)d5jFdW@t-sjJN&M;yTH5FWfF%06>TDjf>Spk&jw z-qxh3_?R2fn7L78(qChCI&5%4sk|n5TJ&W8{8@Lq7L&L+CN@dNiavtz$hA$Mdd-Yz zPuTJsFw5Iv5K}!F3yyCSSRZu~6-m6KP1YnF+H=uhT6?jVfogeQ!=_F?;6yZbbT6rH zuFHo~oW~}yRh+;WJt2aw8C?vTAj|@4PIDGVMPZudHEl$kHO>?bYpkj}&-Y2% z;uf(znIZPBxihb$BuF{*mQ%9k9#<~muz0Lth+h)FXrOvk#=EJqmpIRpaY4fxvhFDY zjncI1u9CmE)roQ0Yo6=8AV~LI&kdEqwC>c+E9o>Db&=(Gy|kv^>@%@DDcj2RFm*s> z)rVGRVx`V5jWSeObQhxf?dlKhEnDg`hwKL;=DS+yrHAQb`wCriX_fYpq{`5{#}mX7 z497+<3xi%$fO!(9*Zi)TV}zS^^+Lg`4KY}fYd3O0kh3jJ-(?#W`wR#$Yh z&vpbvs<{}18*11rb^uafWKm?pOhx#h|LI_h@iTbPdc@j3P zD}<`cAa!oyl>Q4P_<~c`|#por= z32!bSsdRuKcwAjh1oAc%wH!^N%Ye|hDqL^w0IOC^$pzSz>2%C_-8uY{n^)vUQpT+Z z19MLsR$@@UHJ25|gjOSBdmjhU&Q7|$*CYT6tA{;szL}K=d6eCdW)&oY#vTq9+V!f5V=l_81e3j@ zN|bH$z|eVubPg)N+)=(gSlb;~8#uMC@T&v65#{k5K{$nUQB3)@>TdE=#Ft~ifdYvS z@F66s;3)#QZawTn{5jgs=wuY02JI#qHjx*=o#?Y=dyq?o+r8Zvla<|W>bMI>YM3a= zt*E8wb06x3iLO{WV{%l+Z_pKuMr^^ zs`X|YzYH>2fvL|#LS?#COA#ebfbiS!P)xK<#!JkhyjbVK5oCh2 zypMP5S)yd9eHBsYT&(muvPkEME0+0jGIH3)bmR?OVwPc9eN-NHDI)s0;`3E^;zh%{ zLrviaz9d9e>2>8q5@Q+6DUOKr(X}iyNVq}qUwi8xJ=nB0lr_I%EI#5;RAvd&+Vs86 zx;ZyOljH}BeL1jJD`X28sHbcAENDaEhBXDGCVMA5N{LdqV2v!$fUc z>y|~?Z#b|#8;EBW(!?awwOB>TPK9p`vu?lieUdvjMx5Kfd36t|q34^6Ptd_=P`fUH z;P7s@+tuXb8!z8XI`W_7LIEi{zvssMJQwPF`pm!QLIL&2zfyqxTN2ej5l(+Az-Ip5 zNZy`YogBjU{Tt*E_J066LVylHcfgL2?@2~?pWjQifzN;BC_&hN`##5S-~Zl~3HTnz zKWbMY-}@}x{r%hbf!f{gzxNx^B+y~$x4-{^j|t)Y?e~A{4+P=5%gvG}*F^b4k@)vD z{idTOO`;$WFcUjal?)X40+sCm_9ujslZgw=!u1a_x!CUL|KAg3YG`Qqov1%A^+$++ z?*fFvENE?KU}*O}4G*Nr{ES(gSqS*!kNXed1S+UOK!P0vz%J$D1j@EqKwu^i7$~>C zTRj-W0r^{NwKUZ?(KWQNH!-xZ_$MQn?+EzmUjL|Kzf8bC1qjRqAlHI{W?EoQHUI$^ zkawUgp9!eK=luU+{dY?8H)Z8t>*oNVhS`BSaR?g=6Du2#dk5y^U;=Tnv;VF2|5O3= zO!X{Gt(k$3KWc!1wf+yne`g*3CP83!Rwi~pi^;)kTufldA0-OR&UJ?_%<{jc$idP0 z=PGS#W%Mt49CR%W9ZU@M40Y`tejw=1%>7M*{>33S2!Ip;0tf>`m_V#|*a7SSD)irA z(0@(NckBK)$pLc!jp**qjXShuPOjhe9n1=l1qO5cuetM=2KSfc?caI_{>>8v5H%(? zb}lw@FoctdgAI^7FbmMJkCp9zFK+(_1pQxFG{AmwvIC$K5D|s?V89}Cae@Ed z=>e!blde9KqdBv_u_>dTsny-tXryZkF>$c8__MzJTRX=8B}4AE9dZZw4cITvJ0Oue ziw5Aku#f{L`mO=v-x4rmLu-9g2UA0PCVgv5W^+?BYikGy1o~m&|CQz90`{4UlN>Np z9PFS!s0Ifo6DKF+?^$9?T?Z2;M+aRKCPM>9ZcY#y+QIOytG z7&6^);!kJ$cmM2fYWhD77XW6@1_7|=?-;|%4*pIb7nuET9_;@WIp5vP|B@WQOmVOR ziT8j{%)|*K`?CQb?BM^`exjAG!yUW+#Gdc&^53KffZ1n)umFxc0AK?s4A5DW4a^1T zH{b(sK<=7_g8m+detPu()c3VCwg2Jh2bS@-PfAwcMB#z}>u0~ybXGuv*Z^k$1i(0P zfB^3d0DAgcs{iW*nE>|!J3B+8AK3I?IB5T36VMofiHie3!~z(@#K8≨G36Nu|? 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

9BOM0 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

USbz4&Z~WBa(pX`la~wR$aM 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 literal 0 HcmV?d00001 diff --git a/IEEEtran/README b/IEEEtran/README new file mode 100644 index 0000000..3d3d61c --- /dev/null +++ b/IEEEtran/README @@ -0,0 +1,144 @@ + +January 11, 2007 + + +IEEEtran.bst is the official BibTeX style for authors of the Institute of +Electrical and Electronics Engineers (IEEE) Transactions journals and +conferences. + +It also may have applications for other academic work such as theses and +technical reports. The alphanumeric and natbib variants extend the +applicability of the IEEEtran bibstyle family to the natural sciences +and beyond. + +The IEEEtran bibstyle is a very comprehensive BibTeX style which provides +many features beyond the standard BibTeX styles, including full support +for references of online documents, patents, periodicals and standards. +See the provided user manual for detailed usage information. + +The latest version of the IEEEtran BibTeX style can be found at CTAN: + +http://www.ctan.org/tex-archive/macros/latex/contrib/IEEEtran/bibtex/ + +as well as within IEEE's site: + +http://www.ieee.org/ + +Note that the packages at IEEE's site do not contain the natbib and +alphanumeric variants (e.g., IEEEtranN.bst, etc.) as these are not used +for IEEE related work. These files can be obtained on CTAN. + +For helpful tips, answers to frequently asked questions and other support, +visit the IEEEtran home page at my website: + +http://www.michaelshell.org/tex/ieeetran/ + + +Enjoy! + +Michael Shell +http://www.michaelshell.org/ + +******* +Version 1.12 (2007/01/11) changes: + + 1. Fixed bug with unwanted comma before "et al." when an entry contained + more than two author names. Thanks to Pallav Gupta for reporting this. + + 2. Fixed bug with anomalous closing quote in tech reports that have a + type, but without a number or address. Thanks to Mehrdad Mirreza for + reporting this. + + 3. Use braces in \providecommand in begin.bib to better support + latex2html. TeX style length assignments OK with recent versions + of latex2html - 1.71 (2002/2/1) or later is strongly recommended. + Use of the language field still causes trouble with latex2html. + Thanks to Federico Beffa for reporting this. + + 4. Added IEEEtran.bst ID and version comment string to .bbl output. + + 5. Provide a \BIBdecl hook that allows the user to execute commands + just prior to the first entry. + + 6. Use default urlstyle (is using url.sty) of "same" rather than rm to + better work with a wider variety of bibliography styles. + + 7. Changed month abbreviations from Sept., July and June to Sep., Jul., + and Jun., respectively, as IEEE now does. Thanks to Moritz Borgmann + for reporting this. + + 8. Control entry types should not be considered when calculating longest + label width. + + 9. Added alias www for electronic/online. + +10. Updated full and abbreviated journal name string definitions in + IEEEfull.bib and IEEEabrv.bib. + +11. New IEEEtranSA.bst, IEEEtranN.bst, and IEEEtranSN.bst variants for + alphanumeric citation tags and natbib compatibility. + + +********************************** Files ********************************** + +README - This file. + +IEEEtran_bst_HOWTO.pdf - The user manual. + +IEEEtran.bst - The standard IEEEtran BibTeX style file. For use + with IEEE work. + +IEEEtranS.bst - A version of IEEEtran.bst that sorts the entries. + Some IEEE conferences/publications may use/allow + sorted bibliographies. + +IEEEexample.bib - An example BibTeX database that contains the + references shown in the user manual. + +IEEEabrv.bib - String definitions for the abbreviated names of + IEEE journals. (For use with IEEE work.) + +IEEEfull.bib - String definitions for the full names of IEEE + journals. (Do not use for IEEE work.) + + +Carried on CTAN only, for non-IEEE related work: + +IEEEtranSA.bst - Like IEEEtranS.bst, but with alphanumeric citation + tags like alpha.bst. Not for normal IEEE use. + +EEEtranN.bst - Like IEEEtran.bst, but based on plainnat.bst and + is compatible with Patrick W. Daly's natbib + package. Not for normal IEEE use. + +IEEEtranSN.bst - Sorting version of IEEEtranN.bst. Not for normal + IEEE use + +*************************************************************************** +Legal Notice: +This code is offered as-is without any warranty either expressed or +implied; without even the implied warranty of MERCHANTABILITY or +FITNESS FOR A PARTICULAR PURPOSE! +User assumes all risk. +In no event shall IEEE or any contributor to this code be liable for +any damages or losses, including, but not limited to, incidental, +consequential, or any other damages, resulting from the use or misuse +of any information contained here. + +All comments are the opinions of their respective authors and are not +necessarily endorsed by the IEEE. + +This work is distributed under the LaTeX Project Public License (LPPL) +( http://www.latex-project.org/ ) version 1.3, and may be freely used, +distributed and modified. A copy of the LPPL, version 1.3, is included +in the base LaTeX documentation of all distributions of LaTeX released +2003/12/01 or later. +Retain all contribution notices and credits. +** Modified files should be clearly indicated as such, including ** +** renaming them and changing author support contact information. ** + +File list of work: IEEEtran_bst_HOWTO.pdf, IEEEtran.bst, IEEEtranS.bst, + IEEEtranSA.bst, IEEEtranN.bst, IEEEtranSN.bst, + IEEEexample.bib, IEEEabrv.bib, IEEEfull.bib + +*************************************************************************** diff --git a/IEEEtran/bare_adv.tex b/IEEEtran/bare_adv.tex new file mode 100644 index 0000000..0007bec --- /dev/null +++ b/IEEEtran/bare_adv.tex @@ -0,0 +1,1100 @@ + +%% bare_adv.tex +%% V1.3 +%% 2007/01/11 +%% by Michael Shell +%% See: +%% http://www.michaelshell.org/ +%% for current contact information. +%% +%% This is a skeleton file demonstrating the advanced use of IEEEtran.cls +%% (requires IEEEtran.cls version 1.7 or later) with an IEEE Computer +%% Society journal paper. +%% +%% Support sites: +%% http://www.michaelshell.org/tex/ieeetran/ +%% http://www.ctan.org/tex-archive/macros/latex/contrib/IEEEtran/ +%% and +%% http://www.ieee.org/ + +%%************************************************************************* +%% Legal Notice: +%% This code is offered as-is without any warranty either expressed or +%% implied; without even the implied warranty of MERCHANTABILITY or +%% FITNESS FOR A PARTICULAR PURPOSE! +%% User assumes all risk. +%% In no event shall IEEE or any contributor to this code be liable for +%% any damages or losses, including, but not limited to, incidental, +%% consequential, or any other damages, resulting from the use or misuse +%% of any information contained here. +%% +%% All comments are the opinions of their respective authors and are not +%% necessarily endorsed by the IEEE. +%% +%% This work is distributed under the LaTeX Project Public License (LPPL) +%% ( http://www.latex-project.org/ ) version 1.3, and may be freely used, +%% distributed and modified. A copy of the LPPL, version 1.3, is included +%% in the base LaTeX documentation of all distributions of LaTeX released +%% 2003/12/01 or later. +%% Retain all contribution notices and credits. +%% ** Modified files should be clearly indicated as such, including ** +%% ** renaming them and changing author support contact information. ** +%% +%% File list of work: IEEEtran.cls, IEEEtran_HOWTO.pdf, bare_adv.tex, +%% bare_conf.tex, bare_jrnl.tex, bare_jrnl_compsoc.tex +%%************************************************************************* + +% *** Authors should verify (and, if needed, correct) their LaTeX system *** +% *** with the testflow diagnostic prior to trusting their LaTeX platform *** +% *** with production work. IEEE's font choices can trigger bugs that do *** +% *** not appear when using other class files. *** +% The testflow support page is at: +% http://www.michaelshell.org/tex/testflow/ + + + +% IEEEtran V1.7 and later provides for these CLASSINPUT macros to allow the +% user to reprogram some IEEEtran.cls defaults if needed. These settings +% override the internal defaults of IEEEtran.cls regardless of which class +% options are used. Do not use these unless you have good reason to do so as +% they can result in nonIEEE compliant documents. User beware. ;) +% +%\newcommand{\CLASSINPUTbaselinestretch}{1.0} % baselinestretch +%\newcommand{\CLASSINPUTinnersidemargin}{1in} % inner side margin +%\newcommand{\CLASSINPUToutersidemargin}{1in} % outer side margin +%\newcommand{\CLASSINPUTtoptextmargin}{1in} % top text margin +%\newcommand{\CLASSINPUTbottomtextmargin}{1in}% bottom text margin + + + +% Note that the a4paper option is mainly intended so that authors in +% countries using A4 can easily print to A4 and see how their papers will +% look in print - the typesetting of the document will not typically be +% affected with changes in paper size (but the bottom and side margins will). +% Use the testflow package mentioned above to verify correct handling of +% both paper sizes by the user's LaTeX system. +% +% Also note that the "draftcls" or "draftclsnofoot", not "draft", option +% should be used if it is desired that the figures are to be displayed in +% draft mode. +% +\documentclass[12pt,journal,compsoc]{IEEEtran} +% The Computer Society requires 12pt. +% If IEEEtran.cls has not been installed into the LaTeX system files, +% manually specify the path to it like: +% \documentclass[10pt,journal,compsoc]{../sty/IEEEtran} + + +% For Computer Society journals, IEEEtran defaults to the use of +% Palatino/Palladio as is done in IEEE Computer Society journals. +% To go back to Times Roman, you can use this code: +%\renewcommand{\rmdefault}{ptm}\selectfont + + + + + +% Some very useful LaTeX packages include: +% (uncomment the ones you want to load) + + + +% *** MISC UTILITY PACKAGES *** +% +%\usepackage{ifpdf} +% Heiko Oberdiek's ifpdf.sty is very useful if you need conditional +% compilation based on whether the output is pdf or dvi. +% usage: +% \ifpdf +% % pdf code +% \else +% % dvi code +% \fi +% The latest version of ifpdf.sty can be obtained from: +% http://www.ctan.org/tex-archive/macros/latex/contrib/oberdiek/ +% Also, note that IEEEtran.cls V1.7 and later provides a builtin +% \ifCLASSINFOpdf conditional that works the same way. +% When switching from latex to pdflatex and vice-versa, the compiler may +% have to be run twice to clear warning/error messages. + + + + + + +% *** CITATION PACKAGES *** +% +\ifCLASSOPTIONcompsoc + % IEEE Computer Society needs nocompress option + % requires cite.sty v4.0 or later (November 2003) + % \usepackage[nocompress]{cite} +\else + % normal IEEE + % \usepackage{cite} +\fi +% cite.sty was written by Donald Arseneau +% V1.6 and later of IEEEtran pre-defines the format of the cite.sty package +% \cite{} output to follow that of IEEE. Loading the cite package will +% result in citation numbers being automatically sorted and properly +% "compressed/ranged". e.g., [1], [9], [2], [7], [5], [6] without using +% cite.sty will become [1], [2], [5]--[7], [9] using cite.sty. cite.sty's +% \cite will automatically add leading space, if needed. Use cite.sty's +% noadjust option (cite.sty V3.8 and later) if you want to turn this off. +% cite.sty is already installed on most LaTeX systems. Be sure and use +% version 4.0 (2003-05-27) and later if using hyperref.sty. cite.sty does +% not currently provide for hyperlinked citations. +% The latest version can be obtained at: +% http://www.ctan.org/tex-archive/macros/latex/contrib/cite/ +% The documentation is contained in the cite.sty file itself. +% +% Note that some packages require special options to format as the Computer +% Society requires. In particular, Computer Society papers do not use +% compressed citation ranges as is done in typical IEEE papers +% (e.g., [1]-[4]). Instead, they list every citation separately in order +% (e.g., [1], [2], [3], [4]). To get the latter we need to load the cite +% package with the nocompress option which is supported by cite.sty v4.0 +% and later. Note also the use of a CLASSOPTION conditional provided by +% IEEEtran.cls V1.7 and later. + + + + + +% *** GRAPHICS RELATED PACKAGES *** +% +\ifCLASSINFOpdf + % \usepackage[pdftex]{graphicx} + % declare the path(s) where your graphic files are + % \graphicspath{{../pdf/}{../jpeg/}} + % and their extensions so you won't have to specify these with + % every instance of \includegraphics + % \DeclareGraphicsExtensions{.pdf,.jpeg,.png} +\else + % or other class option (dvipsone, dvipdf, if not using dvips). graphicx + % will default to the driver specified in the system graphics.cfg if no + % driver is specified. + % \usepackage[dvips]{graphicx} + % declare the path(s) where your graphic files are + % \graphicspath{{../eps/}} + % and their extensions so you won't have to specify these with + % every instance of \includegraphics + % \DeclareGraphicsExtensions{.eps} +\fi +% graphicx was written by David Carlisle and Sebastian Rahtz. It is +% required if you want graphics, photos, etc. graphicx.sty is already +% installed on most LaTeX systems. The latest version and documentation can +% be obtained at: +% http://www.ctan.org/tex-archive/macros/latex/required/graphics/ +% Another good source of documentation is "Using Imported Graphics in +% LaTeX2e" by Keith Reckdahl which can be found as epslatex.ps or +% epslatex.pdf at: http://www.ctan.org/tex-archive/info/ +% +% latex, and pdflatex in dvi mode, support graphics in encapsulated +% postscript (.eps) format. pdflatex in pdf mode supports graphics +% in .pdf, .jpeg, .png and .mps (metapost) formats. Users should ensure +% that all non-photo figures use a vector format (.eps, .pdf, .mps) and +% not a bitmapped formats (.jpeg, .png). IEEE frowns on bitmapped formats +% which can result in "jaggedy"/blurry rendering of lines and letters as +% well as large increases in file sizes. +% +% You can find documentation about the pdfTeX application at: +% http://www.tug.org/applications/pdftex + + + +%\usepackage{ps4pdf} +% dvi->ps workflow is required to use such packages as psfrag.sty and +% pstricks.sty. However, Rolf Niepraschk's ps4pdf.sty provides a way to +% apply psfrag/pstricks effects to .eps figures and then get the resultant +% figures in .pdf form. Thus, providing an easier way for migrating from +% .eps to .pdf figures. After ps4pdf.sty loads, if: +% 1. producing .dvi output: the output file will consist ONLY of the +% figures (or other constructs encased within \PSforPDF commands) +% 2. producing .pdf output: pdflatex will look in the filename-pics.pdf +% file, where filename is the basename of the tex document, for the +% graphics (or other constructs encased within \PSforPDF commands). +% NOTE: If you ever change your figures, you must remember to remake +% the filename-pics.pdf file. +% +% This way you can do a: +% +% latex filename +% dvips -Ppdf -o filename-pics.ps filename.dvi +% ps2pdf filename-pics.ps filename-pics.pdf +% +% to produce a filename-pics.pdf graphics container that contains +% .pdf versions of the graphics with psfrag, pstricks, etc. features. +% Note that you will not typically be able to view the figures in +% filename-pics.ps because of an offset. However, you will be able to +% view them in filename-pics.pdf. Also, note that when ps4pdf is in effect +% with .dvi output, you may get harmless over/under full box warnings - +% ignore them. +% Then, run pdflatex: +% +% pdflatex filename +% +% to use pdflatex to make PDF output, automatically using the figures in +% filename-pics.pdf. Alternatively, you could use dvips -i option to +% obtain separate .pdf files for each figure: +% +% dvips -Ppdf -i -E -o fig filename +% +% then convert each figure to pdf via a command such as epstopdf and then +% use pdflatex with these pdf figures and then to dispense with ps4pdf. +% +% Remember to rerun through latex/dvips/ps2pdf if you ever change your +% figures so that filename-pics.pdf gets updated. +% ps4pdf requires David Kastrup's preview-latex and a recent LaTeX system +% (circa 2001 or later). The ps4pdf package and documentation can be +% obtained at: http://www.ctan.org/tex-archive/macros/latex/contrib/ps4pdf/ +% The preview-latex package and documentation can be obtained at: +% http://www.ctan.org/tex-archive/macros/latex/contrib/preview/ +% +% provide a bogus \PSforPDF, even when not loading pd4pdf. This way we can +% stop loading ps4pdf.sty if we choose to make separate .pdf versions of +% each of our figures. +\providecommand{\PSforPDF}[1]{#1} +% Note that in order for ps4pdf to work, all commands related to psfrag, +% pstricks, etc. must be called within the PSforPDF command. This applies +% even when *loading* via \usepackage psfrag.sty, etc. + + +%\PSforPDF{\usepackage{psfrag}} +% psfrag.sty was written by Craig Barratt, Michael C. Grant, and +% David Carlisle. It allows you to substitute LaTeX commands for text in +% imported EPS graphic files. In this way, LaTeX symbols can be placed into +% graphics that have been generated by other applications. You must use +% latex->dvips->ps2pdf workflow (not direct pdf output from pdflatex) if +% you wish to use this capability because it works via some PostScript +% tricks. Alternatively, the graphics could be processed as separate files +% via psfrag and dvips, then converted to PDF for inclusion in the main file +% which uses pdflatex. ps4pdf.sty (above) provides a way of doing this all +% at once within the main file. +% Docs are in "The PSfrag System" by Michael C. Grant and David Carlisle. +% There is also some information about using psfrag in "Using Imported +% Graphics in LaTeX2e" by Keith Reckdahl which documents the graphicx +% package (see above). The psfrag package and documentation can be obtained +% at: http://www.ctan.org/tex-archive/macros/latex/contrib/psfrag/ +% +% Note that the current version of psfrag does not "turn itself off" when +% running under pdf output. This will result in a harmless warning +% about a non-PDF \special. However, to silence this, a bogus psfrag +% command can be provided instead of loading psfrag.sty when PDF output +% is being used. Thus, a more complex alternative conditional loading scheme +% can be employed instead of the straightforword way above: +% +%\ifCLASSINFOpdf +% if outputting PDF, do not use or load psfrag.sty as current versions +% output a non-PDF special that generates a harmless, but annoying warning. +% Instead, we provide a bogus \psfrag command that does nothing with +% its arguments. This is a tad tricky because \psfrag can have up to six +% arguments four of which are optional: \psfrag{}[][][][]{} +% Code based on that in psfrag.sty +%\makeatletter +%\def\psfrag{\@ifstar{\@BOGUSpsfraga}{\@BOGUSpsfraga}} +%\def\@BOGUSpsfraga{\begingroup +% \@makeother\"\@makeother\*\@makeother\!\@makeother\~% +% \@makeother\:\@makeother\\\@makeother\%\@makeother\#% +% \@makeother\ \@BOGUSpsfragb} +%\def\@BOGUSpsfragb#1{\endgroup +% \@ifnextchar [{\@BOGUSpsfragc}% +% {\@BOGUSpsfrag}} +%\def\@BOGUSpsfragc[#1]{\@ifnextchar [{\@BOGUSpsfragd}% +% {\@BOGUSpsfrag}} +%\def\@BOGUSpsfragd[#1]{\@ifnextchar [{\@BOGUSpsfrage}% +% {\@BOGUSpsfrag}} +%\def\@BOGUSpsfrage[#1]{\@ifnextchar [{\@BOGUSpsfragf}% +% {\@BOGUSpsfrag}} +%\def\@BOGUSpsfragf[#1]{\@BOGUSpsfrag} +%\def\@BOGUSpsfrag#1{\ignorespaces} +%\makeatother +%\else +% using dvi output, load psfrag, but funnel it through PSforPDF +% as required by ps4pdf.sty +%\PSforPDF{\usepackage{psfrag}} +%\fi + + + + + +% *** MATH PACKAGES *** +% +%\usepackage[cmex10]{amsmath} +% A popular package from the American Mathematical Society that provides +% many useful and powerful commands for dealing with mathematics. If using +% it, be sure to load this package with the cmex10 option to ensure that +% only type 1 fonts will utilized at all point sizes. Without this option, +% it is possible that some math symbols, particularly those within +% footnotes, will be rendered in bitmap form which will result in a +% document that can not be IEEE Xplore compliant! +% +% Also, note that the amsmath package sets \interdisplaylinepenalty to 10000 +% thus preventing page breaks from occurring within multiline equations. Use: +%\interdisplaylinepenalty=2500 +% after loading amsmath to restore such page breaks as IEEEtran.cls normally +% does. amsmath.sty is already installed on most LaTeX systems. The latest +% version and documentation can be obtained at: +% http://www.ctan.org/tex-archive/macros/latex/required/amslatex/math/ + + + + + +% *** SPECIALIZED LIST PACKAGES *** +%\usepackage{acronym} +% acronym.sty was written by Tobias Oetiker. This package provides tools for +% managing documents with large numbers of acronyms. (You don't *have* to +% use this package - unless you have a lot of acronyms, you may feel that +% such package management of them is bit of an overkill.) +% Do note that the acronym environment (which lists acronyms) will have a +% problem when used under IEEEtran.cls because acronym.sty relies on the +% description list environment - which IEEEtran.cls has customized for +% producing IEEE style lists. A workaround is to declared the longest +% label width via the IEEEtran.cls \IEEEiedlistdecl global control: +% +% \renewcommand{\IEEEiedlistdecl}{\IEEEsetlabelwidth{SONET}} +% \begin{acronym} +% +% \end{acronym} +% \renewcommand{\IEEEiedlistdecl}{\relax}% remember to reset \IEEEiedlistdecl +% +% instead of using the acronym environment's optional argument. +% The latest version and documentation can be obtained at: +% http://www.ctan.org/tex-archive/macros/latex/contrib/acronym/ + + +%\usepackage{algorithmic} +% algorithmic.sty was written by Peter Williams and Rogerio Brito. +% This package provides an algorithmic environment fo describing algorithms. +% You can use the algorithmic environment in-text or within a figure +% environment to provide for a floating algorithm. Do NOT use the algorithm +% floating environment provided by algorithm.sty (by the same authors) or +% algorithm2e.sty (by Christophe Fiorio) as IEEE does not use dedicated +% algorithm float types and packages that provide these will not provide +% correct IEEE style captions. The latest version and documentation of +% algorithmic.sty can be obtained at: +% http://www.ctan.org/tex-archive/macros/latex/contrib/algorithms/ +% There is also a support site at: +% http://algorithms.berlios.de/index.html +% Also of interest may be the (relatively newer and more customizable) +% algorithmicx.sty package by Szasz Janos: +% http://www.ctan.org/tex-archive/macros/latex/contrib/algorithmicx/ + + + + +% *** ALIGNMENT PACKAGES *** +% +%\usepackage{array} +% Frank Mittelbach's and David Carlisle's array.sty patches and improves +% the standard LaTeX2e array and tabular environments to provide better +% appearance and additional user controls. As the default LaTeX2e table +% generation code is lacking to the point of almost being broken with +% respect to the quality of the end results, all users are strongly +% advised to use an enhanced (at the very least that provided by array.sty) +% set of table tools. array.sty is already installed on most systems. The +% latest version and documentation can be obtained at: +% http://www.ctan.org/tex-archive/macros/latex/required/tools/ + + +%\usepackage{mdwmath} +%\usepackage{mdwtab} +% Also highly recommended is Mark Wooding's extremely powerful MDW tools, +% especially mdwmath.sty and mdwtab.sty which are used to format equations +% and tables, respectively. The MDWtools set is already installed on most +% LaTeX systems. The lastest version and documentation is available at: +% http://www.ctan.org/tex-archive/macros/latex/contrib/mdwtools/ + + +% IEEEtran contains the IEEEeqnarray family of commands that can be used to +% generate multiline equations as well as matrices, tables, etc., of high +% quality. + + +%\usepackage{eqparbox} +% Also of notable interest is Scott Pakin's eqparbox package for creating +% (automatically sized) equal width boxes - aka "natural width parboxes". +% Available at: +% http://www.ctan.org/tex-archive/macros/latex/contrib/eqparbox/ + + + + + +% *** SUBFIGURE PACKAGES *** +%\ifCLASSOPTIONcompsoc +%\usepackage[tight,normalsize,sf,SF]{subfigure} +%\else +%\usepackage[tight,footnotesize]{subfigure} +%\fi +% subfigure.sty was written by Steven Douglas Cochran. This package makes it +% easy to put subfigures in your figures. e.g., "Figure 1a and 1b". For IEEE +% work, it is a good idea to load it with the tight package option to reduce +% the amount of white space around the subfigures. Computer Society papers +% use a larger font and \sffamily font for their captions, hence the +% additional options needed under compsoc mode. subfigure.sty is already +% installed on most LaTeX systems. The latest version and documentation can +% be obtained at: +% http://www.ctan.org/tex-archive/obsolete/macros/latex/contrib/subfigure/ +% subfigure.sty has been superceeded by subfig.sty. + + +%\ifCLASSOPTIONcompsoc +% \usepackage[caption=false]{caption} +% \usepackage[font=normalsize,labelfont=sf,textfont=sf]{subfig} +%\else +% \usepackage[caption=false]{caption} +% \usepackage[font=footnotesize]{subfig} +%\fi +% subfig.sty, also written by Steven Douglas Cochran, is the modern +% replacement for subfigure.sty. However, subfig.sty requires and +% automatically loads Axel Sommerfeldt's caption.sty which will override +% IEEEtran.cls handling of captions and this will result in nonIEEE style +% figure/table captions. To prevent this problem, be sure and preload +% caption.sty with its "caption=false" package option. This is will preserve +% IEEEtran.cls handing of captions. Version 1.3 (2005/06/28) and later +% (recommended due to many improvements over 1.2) of subfig.sty supports +% the caption=false option directly: +%\ifCLASSOPTIONcompsoc +% \usepackage[caption=false,font=normalsize,labelfont=sf,textfont=sf]{subfig} +%\else +% \usepackage[caption=false,font=footnotesize]{subfig} +%\fi +% +% The latest version and documentation can be obtained at: +% http://www.ctan.org/tex-archive/macros/latex/contrib/subfig/ +% The latest version and documentation of caption.sty can be obtained at: +% http://www.ctan.org/tex-archive/macros/latex/contrib/caption/ + + + + +% *** FLOAT PACKAGES *** +% +%\usepackage{fixltx2e} +% fixltx2e, the successor to the earlier fix2col.sty, was written by +% Frank Mittelbach and David Carlisle. This package corrects a few problems +% in the LaTeX2e kernel, the most notable of which is that in current +% LaTeX2e releases, the ordering of single and double column floats is not +% guaranteed to be preserved. Thus, an unpatched LaTeX2e can allow a +% single column figure to be placed prior to an earlier double column +% figure. The latest version and documentation can be found at: +% http://www.ctan.org/tex-archive/macros/latex/base/ + + +%\usepackage{stfloats} +% stfloats.sty was written by Sigitas Tolusis. This package gives LaTeX2e +% the ability to do double column floats at the bottom of the page as well +% as the top. (e.g., "\begin{figure*}[!b]" is not normally possible in +% LaTeX2e). It also provides a command: +%\fnbelowfloat +% to enable the placement of footnotes below bottom floats (the standard +% LaTeX2e kernel puts them above bottom floats). This is an invasive package +% which rewrites many portions of the LaTeX2e float routines. It may not work +% with other packages that modify the LaTeX2e float routines. The latest +% version and documentation can be obtained at: +% http://www.ctan.org/tex-archive/macros/latex/contrib/sttools/ +% Documentation is contained in the stfloats.sty comments as well as in the +% presfull.pdf file. Do not use the stfloats baselinefloat ability as IEEE +% does not allow \baselineskip to stretch. Authors submitting work to the +% IEEE should note that IEEE rarely uses double column equations and +% that authors should try to avoid such use. Do not be tempted to use the +% cuted.sty or midfloat.sty packages (also by Sigitas Tolusis) as IEEE does +% not format its papers in such ways. + + +%\ifCLASSOPTIONcaptionsoff +% \usepackage[nomarkers]{endfloat} +% \let\MYoriglatexcaption\caption +% \renewcommand{\caption}[2][\relax]{\MYoriglatexcaption[#2]{#2}} +%\fi +% endfloat.sty was written by James Darrell McCauley and Jeff Goldberg. +% This package may be useful when used in conjunction with IEEEtran.cls' +% captionsoff option. Some IEEE journals/societies require that submissions +% have lists of figures/tables at the end of the paper and that +% figures/tables without any captions are placed on a page by themselves at +% the end of the document. If needed, the draftcls IEEEtran class option or +% \CLASSINPUTbaselinestretch interface can be used to increase the line +% spacing as well. Be sure and use the nomarkers option of endfloat to +% prevent endfloat from "marking" where the figures would have been placed +% in the text. The two hack lines of code above are a slight modification of +% that suggested by in the endfloat docs (section 8.3.1) to ensure that +% the full captions always appear in the list of figures/tables - even if +% the user used the short optional argument of \caption[]{}. +% IEEE papers do not typically make use of \caption[]'s optional argument, +% so this should not be an issue. A similar trick can be used to disable +% captions of packages such as subfig.sty that lack options to turn off +% the subcaptions: +% For subfig.sty: +% \let\MYorigsubfloat\subfloat +% \renewcommand{\subfloat}[2][\relax]{\MYorigsubfloat[]{#2}} +% For subfigure.sty: +% \let\MYorigsubfigure\subfigure +% \renewcommand{\subfigure}[2][\relax]{\MYorigsubfigure[]{#2}} +% However, the above trick will not work if both optional arguments of +% the \subfloat/subfig command are used. Furthermore, there needs to be a +% description of each subfigure *somewhere* and endfloat does not add +% subfigure captions to its list of figures. Thus, the best approach is to +% avoid the use of subfigure captions (many IEEE journals avoid them anyway) +% and instead reference/explain all the subfigures within the main caption. +% The latest version of endfloat.sty and its documentation can obtained at: +% http://www.ctan.org/tex-archive/macros/latex/contrib/endfloat/ +% +% The IEEEtran \ifCLASSOPTIONcaptionsoff conditional can also be used +% later in the document, say, to conditionally put the References on a +% page by themselves. + + + + + +% *** PDF, URL AND HYPERLINK PACKAGES *** +% +%\usepackage{url} +% url.sty was written by Donald Arseneau. It provides better support for +% handling and breaking URLs. url.sty is already installed on most LaTeX +% systems. The latest version can be obtained at: +% http://www.ctan.org/tex-archive/macros/latex/contrib/misc/ +% Read the url.sty source comments for usage information. Basically, +% \url{my_url_here}. + + +% NOTE: PDF thumbnail features are not required in IEEE papers +% and their use requires extra complexity and work. +%\ifCLASSINFOpdf +% \usepackage[pdftex]{thumbpdf} +%\else +% \usepackage[dvips]{thumbpdf} +%\fi +% thumbpdf.sty and its companion Perl utility were written by Heiko Oberdiek. +% It allows the user a way to produce PDF documents that contain fancy +% thumbnail images of each of the pages (which tools like acrobat reader can +% utilize). This is possible even when using dvi->ps->pdf workflow if the +% correct thumbpdf driver options are used. thumbpdf.sty incorporates the +% file containing the PDF thumbnail information (filename.tpm is used with +% dvips, filename.tpt is used with pdftex, where filename is the base name of +% your tex document) into the final ps or pdf output document. An external +% utility, the thumbpdf *Perl script* is needed to make these .tpm or .tpt +% thumbnail files from a .ps or .pdf version of the document (which obviously +% does not yet contain pdf thumbnails). Thus, one does a: +% +% thumbpdf filename.pdf +% +% to make a filename.tpt, and: +% +% thumbpdf --mode dvips filename.ps +% +% to make a filename.tpm which will then be loaded into the document by +% thumbpdf.sty the NEXT time the document is compiled (by pdflatex or +% latex->dvips->ps2pdf). Users must be careful to regenerate the .tpt and/or +% .tpm files if the main document changes and then to recompile the +% document to incorporate the revised thumbnails to ensure that thumbnails +% match the actual pages. It is easy to forget to do this! +% +% Unix systems come with a Perl interpreter. However, MS Windows users +% will usually have to install a Perl interpreter so that the thumbpdf +% script can be run. The Ghostscript PS/PDF interpreter is also required. +% See the thumbpdf docs for details. The latest version and documentation +% can be obtained at. +% http://www.ctan.org/tex-archive/support/thumbpdf/ +% Be sure and use only version 3.8 (2005/07/06) or later of thumbpdf as +% earlier versions will not work properly with recent versions of pdfTeX +% (1.20a and later). + + +% NOTE: PDF hyperlink and bookmark features are not required in IEEE +% papers and their use requires extra complexity and work. +% *** IF USING HYPERREF BE SURE AND CHANGE THE EXAMPLE PDF *** +% *** TITLE/SUBJECT/AUTHOR/KEYWORDS INFO BELOW!! *** +\newcommand\MYhyperrefoptions{bookmarks=true,bookmarksnumbered=true, +pdfpagemode={UseOutlines},plainpages=false,pdfpagelabels=true, +colorlinks=true,linkcolor={black},citecolor={black},pagecolor={black}, +urlcolor={black}, +pdftitle={Bare Demo of IEEEtran.cls for Computer Society Journals},%.dvi->.ps->.pdf workflow if the respective packages/scripts are +% loaded/invoked with the correct driver options (dvips, etc.). +% As most IEEE papers use URLs sparingly (mainly in the references), this +% may not be as big an issue as with other publications. +% +% That said, recently Vilar Camara Neto introduced his breakurl.sty +% package which permits hyperref to easily break URLs even in dvi +% mode. Note that breakurl, unlike most other packages, must be loaded +% AFTER hyperref. The latest version of breakurl and its documentation can +% be obtained at: +% http://www.ctan.org/tex-archive/macros/latex/contrib/breakurl/ +% breakurl.sty is not for use under pdflatex pdf mode. Versions 1.10 +% (September 23, 2005) and later are recommened to avoid bugs in earlier +% releases. +% +% The advanced features offer by hyperref.sty are not required for IEEE +% submission, so users should weigh these features against the added +% complexity of use. Users who wish to use hyperref *must* ensure that +% their hyperref version is 6.72u or later *and* IEEEtran.cls is version +% 1.6b or later. +% The package options above demonstrate how to enable PDF bookmarks +% (a type of table of contents viewable in Acrobat Reader) as well as +% PDF document information (title, subject, author and keywords) that is +% viewable in Acrobat reader's Document_Properties menu. PDF document +% information is also used extensively to automate the cataloging of PDF +% documents. The above set of options ensures that hyperlinks will not be +% colored in the text and thus will not be visible in the printed page, +% but will be active on "mouse over". USING COLORS OR OTHER HIGHLIGHTING +% OF HYPERLINKS CAN RESULT IN DOCUMENT REJECTION BY THE IEEE, especially if +% these appear on the "printed" page. IF IN DOUBT, ASK THE RELEVANT +% SUBMISSION EDITOR. You may need to add the option hypertexnames=false if +% you used duplicate equation numbers, etc., but this should not be needed +% in normal IEEE work. +% The latest version of hyperref and its documentation can be obtained at: +% http://www.ctan.org/tex-archive/macros/latex/contrib/hyperref/ + + + + + +% *** Do not adjust lengths that control margins, column widths, etc. *** +% *** Do not use packages that alter fonts (such as pslatex). *** +% There should be no need to do such things with IEEEtran.cls V1.6 and later. +% (Unless specifically asked to do so by the journal or conference you plan +% to submit to, of course. ) + + +% correct bad hyphenation here +\hyphenation{op-tical net-works semi-conduc-tor} + + +\begin{document} +% +% paper title +% can use linebreaks \\ within to get better formatting as desired +\title{Bare Advanced Demo of IEEEtran.cls\\ for Computer Society Journals} +% +% +% author names and IEEE memberships +% note positions of commas and nonbreaking spaces ( ~ ) LaTeX will not break +% a structure at a ~ so this keeps an author's name from being broken across +% two lines. +% use \thanks{} to gain access to the first footnote area +% a separate \thanks must be used for each paragraph as LaTeX2e's \thanks +% was not built to handle multiple paragraphs +% +% +%\IEEEcompsocitemizethanks is a special \thanks that produces the bulleted +% lists the Computer Society journals use for "first footnote" author +% affiliations. Use \IEEEcompsocthanksitem which works much like \item +% for each affiliation group. When not in compsoc mode, +% \IEEEcompsocitemizethanks becomes like \thanks and +% \IEEEcompsocthanksitem becomes a line break with idention. This +% facilitates dual compilation, although admittedly the differences in the +% desired content of \author between the different types of papers makes a +% one-size-fits-all approach a daunting prospect. For instance, compsoc +% journal papers have the author affiliations above the "Manuscript +% received ..." text while in non-compsoc journals this is reversed. Sigh. + +\author{Michael~Shell,~\IEEEmembership{Member,~IEEE,} + John~Doe,~\IEEEmembership{Fellow,~OSA,} + and~Jane~Doe,~\IEEEmembership{Life~Fellow,~IEEE}% <-this % stops a space +\IEEEcompsocitemizethanks{\IEEEcompsocthanksitem M. Shell is with the Department +of Electrical and Computer Engineering, Georgia Institute of Technology, Atlanta, +GA, 30332.\protect\\ +% note need leading \protect in front of \\ to get a newline within \thanks as +% \\ is fragile and will error, could use \hfil\break instead. +E-mail: see http://www.michaelshell.org/contact.html +\IEEEcompsocthanksitem J. Doe and J. Doe are with Anonymous University.}% <-this % stops a space +\thanks{Manuscript received April 19, 2005; revised January 11, 2007.}} + +% note the % following the last \IEEEmembership and also \thanks - +% these prevent an unwanted space from occurring between the last author name +% and the end of the author line. i.e., if you had this: +% +% \author{....lastname \thanks{...} \thanks{...} } +% ^------------^------------^----Do not want these spaces! +% +% a space would be appended to the last name and could cause every name on that +% line to be shifted left slightly. This is one of those "LaTeX things". For +% instance, "\textbf{A} \textbf{B}" will typeset as "A B" not "AB". To get +% "AB" then you have to do: "\textbf{A}\textbf{B}" +% \thanks is no different in this regard, so shield the last } of each \thanks +% that ends a line with a % and do not let a space in before the next \thanks. +% Spaces after \IEEEmembership other than the last one are OK (and needed) as +% you are supposed to have spaces between the names. For what it is worth, +% this is a minor point as most people would not even notice if the said evil +% space somehow managed to creep in. + + + +% The paper headers +\markboth{Journal of \LaTeX\ Class Files,~Vol.~6, No.~1, January~2007}% +{Shell \MakeLowercase{\textit{et al.}}: Bare Advanced Demo of IEEEtran.cls for Journals} +% The only time the second header will appear is for the odd numbered pages +% after the title page when using the twoside option. +% +% *** Note that you probably will NOT want to include the author's *** +% *** name in the headers of peer review papers. *** +% You can use \ifCLASSOPTIONpeerreview for conditional compilation here if +% you desire. + + + +% The publisher's ID mark at the bottom of the page is less important with +% Computer Society journal papers as those publications place the marks +% outside of the main text columns and, therefore, unlike regular IEEE +% journals, the available text space is not reduced by their presence. +% If you want to put a publisher's ID mark on the page you can do it like +% this: +%\IEEEpubid{0000--0000/00\$00.00~\copyright~2007 IEEE} +% or like this to get the Computer Society new two part style. +%\IEEEpubid{\makebox[\columnwidth]{\hfill 0000--0000/00/\$00.00~\copyright~2007 IEEE}% +%\hspace{\columnsep}\makebox[\columnwidth]{Published by the IEEE Computer Society\hfill}} +% Remember, if you use this you must call \IEEEpubidadjcol in the second +% column for its text to clear the IEEEpubid mark (Computer Society jorunal +% papers don't need this extra clearance.) + + + +% use for special paper notices +%\IEEEspecialpapernotice{(Invited Paper)} + + + +% for Computer Society papers, we must declare the abstract and index terms +% PRIOR to the title within the \IEEEcompsoctitleabstractindextext IEEEtran +% command as these need to go into the title area created by \maketitle. +\IEEEcompsoctitleabstractindextext{% +\begin{abstract} +%\boldmath +The abstract goes here. +\end{abstract} +% IEEEtran.cls defaults to using nonbold math in the Abstract. +% This preserves the distinction between vectors and scalars. However, +% if the journal you are submitting to favors bold math in the abstract, +% then you can use LaTeX's standard command \boldmath at the very start +% of the abstract to achieve this. Many IEEE journals frown on math +% in the abstract anyway. In particular, the Computer Society does +% not want either math or citations to appear in the abstract. + +% Note that keywords are not normally used for peerreview papers. +\begin{IEEEkeywords} +Computer Society, IEEEtran, journal, \LaTeX, paper, template. +\end{IEEEkeywords}} + + +% make the title area +\maketitle + + +% To allow for easy dual compilation without having to reenter the +% abstract/keywords data, the \IEEEcompsoctitleabstractindextext text will +% not be used in maketitle, but will appear (i.e., to be "transported") +% here as \IEEEdisplaynotcompsoctitleabstractindextext when compsoc mode +% is not selected if conference mode is selected - because compsoc +% conference papers position the abstract like regular (non-compsoc) +% papers do! +\IEEEdisplaynotcompsoctitleabstractindextext +% \IEEEdisplaynotcompsoctitleabstractindextext has no effect when using +% compsoc under a non-conference mode. + + +% For peer review papers, you can put extra information on the cover +% page as needed: +% \ifCLASSOPTIONpeerreview +% \begin{center} \bfseries EDICS Category: 3-BBND \end{center} +% \fi +% +% For peerreview papers, this IEEEtran command inserts a page break and +% creates the second title. It will be ignored for other modes. +\IEEEpeerreviewmaketitle + + + +\section{Introduction} +% Computer Society journal papers do something a tad strange with the very +% first section heading (almost always called "Introduction"). They place it +% ABOVE the main text! IEEEtran.cls currently does not do this for you. +% However, You can achieve this effect by making LaTeX jump through some +% hoops via something like: +% +%\ifCLASSOPTIONcompsoc +% \noindent\raisebox{2\baselineskip}[0pt][0pt]% +% {\parbox{\columnwidth}{\section{Introduction}\label{sec:introduction}% +% \global\everypar=\everypar}}% +% \vspace{-1\baselineskip}\vspace{-\parskip}\par +%\else +% \section{Introduction}\label{sec:introduction}\par +%\fi +% +% Admittedly, this is a hack and may well be fragile, but seems to do the +% trick for me. Note the need to keep any \label that may be used right +% after \section in the above as the hack puts \section within a raised box. + + + +% The very first letter is a 2 line initial drop letter followed +% by the rest of the first word in caps (small caps for compsoc). +% +% form to use if the first word consists of a single letter: +% \IEEEPARstart{A}{demo} file is .... +% +% form to use if you need the single drop letter followed by +% normal text (unknown if ever used by IEEE): +% \IEEEPARstart{A}{}demo file is .... +% +% Some journals put the first two words in caps: +% \IEEEPARstart{T}{his demo} file is .... +% +% Here we have the typical use of a "T" for an initial drop letter +% and "HIS" in caps to complete the first word. +\IEEEPARstart{T}{his} demo file is intended to serve as a ``starter file'' +for IEEE Computer Society journal papers produced under \LaTeX\ using +IEEEtran.cls version 1.7 and later. +% You must have at least 2 lines in the paragraph with the drop letter +% (should never be an issue) +I wish you the best of success. + +\hfill mds + +\hfill January 11, 2007 + +\subsection{Subsection Heading Here} +Subsection text here. + +% needed in second column of first page if using \IEEEpubid +%\IEEEpubidadjcol + +\subsubsection{Subsubsection Heading Here} +Subsubsection text here. + + +% An example of a floating figure using the graphicx package. +% Note that \label must occur AFTER (or within) \caption. +% For figures, \caption should occur after the \includegraphics. +% Note that IEEEtran v1.7 and later has special internal code that +% is designed to preserve the operation of \label within \caption +% even when the captionsoff option is in effect. However, because +% of issues like this, it may be the safest practice to put all your +% \label just after \caption rather than within \caption{}. +% +% Reminder: the "draftcls" or "draftclsnofoot", not "draft", class +% option should be used if it is desired that the figures are to be +% displayed while in draft mode. +% +%\begin{figure}[!t] +%\centering +%\includegraphics[width=2.5in]{myfigure} +% where an .eps filename suffix will be assumed under latex, +% and a .pdf suffix will be assumed for pdflatex; or what has been declared +% via \DeclareGraphicsExtensions. +%\caption{Simulation Results} +%\label{fig_sim} +%\end{figure} + +% Note that IEEE typically puts floats only at the top, even when this +% results in a large percentage of a column being occupied by floats. +% However, the Computer Society has been known to put floats at the bottom. + + +% An example of a double column floating figure using two subfigures. +% (The subfig.sty package must be loaded for this to work.) +% The subfigure \label commands are set within each subfloat command, the +% \label for the overall figure must come after \caption. +% \hfil must be used as a separator to get equal spacing. +% The subfigure.sty package works much the same way, except \subfigure is +% used instead of \subfloat. +% +%\begin{figure*}[!t] +%\centerline{\subfloat[Case I]\includegraphics[width=2.5in]{subfigcase1}% +%\label{fig_first_case}} +%\hfil +%\subfloat[Case II]{\includegraphics[width=2.5in]{subfigcase2}% +%\label{fig_second_case}}} +%\caption{Simulation results} +%\label{fig_sim} +%\end{figure*} +% +% Note that often IEEE papers with subfigures do not employ subfigure +% captions (using the optional argument to \subfloat), but instead will +% reference/describe all of them (a), (b), etc., within the main caption. + + +% An example of a floating table. Note that, for IEEE style tables, the +% \caption command should come BEFORE the table. Table text will default to +% \footnotesize as IEEE normally uses this smaller font for tables. +% The \label must come after \caption as always. +% +%\begin{table}[!t] +%% increase table row spacing, adjust to taste +%\renewcommand{\arraystretch}{1.3} +% if using array.sty, it might be a good idea to tweak the value of +% \extrarowheight as needed to properly center the text within the cells +%\caption{An Example of a Table} +%\label{table_example} +%\centering +%% Some packages, such as MDW tools, offer better commands for making tables +%% than the plain LaTeX2e tabular which is used here. +%\begin{tabular}{|c||c|} +%\hline +%One & Two\\ +%\hline +%Three & Four\\ +%\hline +%\end{tabular} +%\end{table} + + +% Note that IEEE does not put floats in the very first column - or typically +% anywhere on the first page for that matter. Also, in-text middle ("here") +% positioning is not used. Most IEEE journals use top floats exclusively. +% However, Computer Society journals sometimes do use bottom floats - bear +% this in mind when choosing appropriate optional arguments for the +% figure/table environments. +% Note that, LaTeX2e, unlike IEEE journals, places footnotes above bottom +% floats. This can be corrected via the \fnbelowfloat command of the +% stfloats package. + + + +\section{Conclusion} +The conclusion goes here. + + + + + +% if have a single appendix: +%\appendix[Proof of the Zonklar Equations] +% or +%\appendix % for no appendix heading +% do not use \section anymore after \appendix, only \section* +% is possibly needed + +% use appendices with more than one appendix +% then use \section to start each appendix +% you must declare a \section before using any +% \subsection or using \label (\appendices by itself +% starts a section numbered zero.) +% + + +\appendices +\section{Proof of the First Zonklar Equation} +Appendix one text goes here. + +% you can choose not to have a title for an appendix +% if you want by leaving the argument blank +\section{} +Appendix two text goes here. + + +% use section* for acknowledgement +\ifCLASSOPTIONcompsoc + % The Computer Society usually uses the plural form + \section*{Acknowledgments} +\else + % regular IEEE prefers the singular form + \section*{Acknowledgment} +\fi + + +The authors would like to thank... + + +% Can use something like this to put references on a page +% by themselves when using endfloat and the captionsoff option. +\ifCLASSOPTIONcaptionsoff + \newpage +\fi + + + +% trigger a \newpage just before the given reference +% number - used to balance the columns on the last page +% adjust value as needed - may need to be readjusted if +% the document is modified later +%\IEEEtriggeratref{8} +% The "triggered" command can be changed if desired: +%\IEEEtriggercmd{\enlargethispage{-5in}} + +% references section + +% can use a bibliography generated by BibTeX as a .bbl file +% BibTeX documentation can be easily obtained at: +% http://www.ctan.org/tex-archive/biblio/bibtex/contrib/doc/ +% The IEEEtran BibTeX style support page is at: +% http://www.michaelshell.org/tex/ieeetran/bibtex/ +%\bibliographystyle{IEEEtran} +% argument is your BibTeX string definitions and bibliography database(s) +%\bibliography{IEEEabrv,../bib/paper} +% +% manually copy in the resultant .bbl file +% set second argument of \begin to the number of references +% (used to reserve space for the reference number labels box) +\begin{thebibliography}{1} + +\bibitem{IEEEhowto:kopka} +H.~Kopka and P.~W. Daly, \emph{A Guide to {\LaTeX}}, 3rd~ed.\hskip 1em plus + 0.5em minus 0.4em\relax Harlow, England: Addison-Wesley, 1999. + +\end{thebibliography} + +% biography section +% +% If you have an EPS/PDF photo (graphicx package needed) extra braces are +% needed around the contents of the optional argument to biography to prevent +% the LaTeX parser from getting confused when it sees the complicated +% \includegraphics command within an optional argument. (You could create +% your own custom macro containing the \includegraphics command to make things +% simpler here.) +%\begin{biography}[{\includegraphics[width=1in,height=1.25in,clip,keepaspectratio]{mshell}}]{Michael Shell} +% or if you just want to reserve a space for a photo: + +\begin{IEEEbiography}{Michael Shell} +Biography text here. +\end{IEEEbiography} + +% if you will not have a photo at all: +\begin{IEEEbiographynophoto}{John Doe} +Biography text here. +\end{IEEEbiographynophoto} + +% insert where needed to balance the two columns on the last page with +% biographies +%\newpage + +\begin{IEEEbiographynophoto}{Jane Doe} +Biography text here. +\end{IEEEbiographynophoto} + +% You can push biographies down or up by placing +% a \vfill before or after them. The appropriate +% use of \vfill depends on what kind of text is +% on the last page and whether or not the columns +% are being equalized. + +%\vfill + +% Can be used to pull up biographies so that the bottom of the last one +% is flush with the other column. +%\enlargethispage{-5in} + + + +% that's all folks +\end{document} + + diff --git a/IEEEtran/bare_conf.tex b/IEEEtran/bare_conf.tex new file mode 100644 index 0000000..16a4c0c --- /dev/null +++ b/IEEEtran/bare_conf.tex @@ -0,0 +1,601 @@ + +%% bare_conf.tex +%% V1.3 +%% 2007/01/11 +%% by Michael Shell +%% See: +%% http://www.michaelshell.org/ +%% for current contact information. +%% +%% This is a skeleton file demonstrating the use of IEEEtran.cls +%% (requires IEEEtran.cls version 1.7 or later) with an IEEE conference paper. +%% +%% Support sites: +%% http://www.michaelshell.org/tex/ieeetran/ +%% http://www.ctan.org/tex-archive/macros/latex/contrib/IEEEtran/ +%% and +%% http://www.ieee.org/ + +%%************************************************************************* +%% Legal Notice: +%% This code is offered as-is without any warranty either expressed or +%% implied; without even the implied warranty of MERCHANTABILITY or +%% FITNESS FOR A PARTICULAR PURPOSE! +%% User assumes all risk. +%% In no event shall IEEE or any contributor to this code be liable for +%% any damages or losses, including, but not limited to, incidental, +%% consequential, or any other damages, resulting from the use or misuse +%% of any information contained here. +%% +%% All comments are the opinions of their respective authors and are not +%% necessarily endorsed by the IEEE. +%% +%% This work is distributed under the LaTeX Project Public License (LPPL) +%% ( http://www.latex-project.org/ ) version 1.3, and may be freely used, +%% distributed and modified. A copy of the LPPL, version 1.3, is included +%% in the base LaTeX documentation of all distributions of LaTeX released +%% 2003/12/01 or later. +%% Retain all contribution notices and credits. +%% ** Modified files should be clearly indicated as such, including ** +%% ** renaming them and changing author support contact information. ** +%% +%% File list of work: IEEEtran.cls, IEEEtran_HOWTO.pdf, bare_adv.tex, +%% bare_conf.tex, bare_jrnl.tex, bare_jrnl_compsoc.tex +%%************************************************************************* + +% *** Authors should verify (and, if needed, correct) their LaTeX system *** +% *** with the testflow diagnostic prior to trusting their LaTeX platform *** +% *** with production work. IEEE's font choices can trigger bugs that do *** +% *** not appear when using other class files. *** +% The testflow support page is at: +% http://www.michaelshell.org/tex/testflow/ + + + +% Note that the a4paper option is mainly intended so that authors in +% countries using A4 can easily print to A4 and see how their papers will +% look in print - the typesetting of the document will not typically be +% affected with changes in paper size (but the bottom and side margins will). +% Use the testflow package mentioned above to verify correct handling of +% both paper sizes by the user's LaTeX system. +% +% Also note that the "draftcls" or "draftclsnofoot", not "draft", option +% should be used if it is desired that the figures are to be displayed in +% draft mode. +% +\documentclass[conference]{IEEEtran} +% Add the compsoc option for Computer Society conferences. +% +% If IEEEtran.cls has not been installed into the LaTeX system files, +% manually specify the path to it like: +% \documentclass[conference]{../sty/IEEEtran} + + + + + +% Some very useful LaTeX packages include: +% (uncomment the ones you want to load) + + +% *** MISC UTILITY PACKAGES *** +% +%\usepackage{ifpdf} +% Heiko Oberdiek's ifpdf.sty is very useful if you need conditional +% compilation based on whether the output is pdf or dvi. +% usage: +% \ifpdf +% % pdf code +% \else +% % dvi code +% \fi +% The latest version of ifpdf.sty can be obtained from: +% http://www.ctan.org/tex-archive/macros/latex/contrib/oberdiek/ +% Also, note that IEEEtran.cls V1.7 and later provides a builtin +% \ifCLASSINFOpdf conditional that works the same way. +% When switching from latex to pdflatex and vice-versa, the compiler may +% have to be run twice to clear warning/error messages. + + + + + + +% *** CITATION PACKAGES *** +% +%\usepackage{cite} +% cite.sty was written by Donald Arseneau +% V1.6 and later of IEEEtran pre-defines the format of the cite.sty package +% \cite{} output to follow that of IEEE. Loading the cite package will +% result in citation numbers being automatically sorted and properly +% "compressed/ranged". e.g., [1], [9], [2], [7], [5], [6] without using +% cite.sty will become [1], [2], [5]--[7], [9] using cite.sty. cite.sty's +% \cite will automatically add leading space, if needed. Use cite.sty's +% noadjust option (cite.sty V3.8 and later) if you want to turn this off. +% cite.sty is already installed on most LaTeX systems. Be sure and use +% version 4.0 (2003-05-27) and later if using hyperref.sty. cite.sty does +% not currently provide for hyperlinked citations. +% The latest version can be obtained at: +% http://www.ctan.org/tex-archive/macros/latex/contrib/cite/ +% The documentation is contained in the cite.sty file itself. + + + + + + +% *** GRAPHICS RELATED PACKAGES *** +% +\ifCLASSINFOpdf + % \usepackage[pdftex]{graphicx} + % declare the path(s) where your graphic files are + % \graphicspath{{../pdf/}{../jpeg/}} + % and their extensions so you won't have to specify these with + % every instance of \includegraphics + % \DeclareGraphicsExtensions{.pdf,.jpeg,.png} +\else + % or other class option (dvipsone, dvipdf, if not using dvips). graphicx + % will default to the driver specified in the system graphics.cfg if no + % driver is specified. + % \usepackage[dvips]{graphicx} + % declare the path(s) where your graphic files are + % \graphicspath{{../eps/}} + % and their extensions so you won't have to specify these with + % every instance of \includegraphics + % \DeclareGraphicsExtensions{.eps} +\fi +% graphicx was written by David Carlisle and Sebastian Rahtz. It is +% required if you want graphics, photos, etc. graphicx.sty is already +% installed on most LaTeX systems. The latest version and documentation can +% be obtained at: +% http://www.ctan.org/tex-archive/macros/latex/required/graphics/ +% Another good source of documentation is "Using Imported Graphics in +% LaTeX2e" by Keith Reckdahl which can be found as epslatex.ps or +% epslatex.pdf at: http://www.ctan.org/tex-archive/info/ +% +% latex, and pdflatex in dvi mode, support graphics in encapsulated +% postscript (.eps) format. pdflatex in pdf mode supports graphics +% in .pdf, .jpeg, .png and .mps (metapost) formats. Users should ensure +% that all non-photo figures use a vector format (.eps, .pdf, .mps) and +% not a bitmapped formats (.jpeg, .png). IEEE frowns on bitmapped formats +% which can result in "jaggedy"/blurry rendering of lines and letters as +% well as large increases in file sizes. +% +% You can find documentation about the pdfTeX application at: +% http://www.tug.org/applications/pdftex + + + + + +% *** MATH PACKAGES *** +% +%\usepackage[cmex10]{amsmath} +% A popular package from the American Mathematical Society that provides +% many useful and powerful commands for dealing with mathematics. If using +% it, be sure to load this package with the cmex10 option to ensure that +% only type 1 fonts will utilized at all point sizes. Without this option, +% it is possible that some math symbols, particularly those within +% footnotes, will be rendered in bitmap form which will result in a +% document that can not be IEEE Xplore compliant! +% +% Also, note that the amsmath package sets \interdisplaylinepenalty to 10000 +% thus preventing page breaks from occurring within multiline equations. Use: +%\interdisplaylinepenalty=2500 +% after loading amsmath to restore such page breaks as IEEEtran.cls normally +% does. amsmath.sty is already installed on most LaTeX systems. The latest +% version and documentation can be obtained at: +% http://www.ctan.org/tex-archive/macros/latex/required/amslatex/math/ + + + + + +% *** SPECIALIZED LIST PACKAGES *** +% +%\usepackage{algorithmic} +% algorithmic.sty was written by Peter Williams and Rogerio Brito. +% This package provides an algorithmic environment fo describing algorithms. +% You can use the algorithmic environment in-text or within a figure +% environment to provide for a floating algorithm. Do NOT use the algorithm +% floating environment provided by algorithm.sty (by the same authors) or +% algorithm2e.sty (by Christophe Fiorio) as IEEE does not use dedicated +% algorithm float types and packages that provide these will not provide +% correct IEEE style captions. The latest version and documentation of +% algorithmic.sty can be obtained at: +% http://www.ctan.org/tex-archive/macros/latex/contrib/algorithms/ +% There is also a support site at: +% http://algorithms.berlios.de/index.html +% Also of interest may be the (relatively newer and more customizable) +% algorithmicx.sty package by Szasz Janos: +% http://www.ctan.org/tex-archive/macros/latex/contrib/algorithmicx/ + + + + +% *** ALIGNMENT PACKAGES *** +% +%\usepackage{array} +% Frank Mittelbach's and David Carlisle's array.sty patches and improves +% the standard LaTeX2e array and tabular environments to provide better +% appearance and additional user controls. As the default LaTeX2e table +% generation code is lacking to the point of almost being broken with +% respect to the quality of the end results, all users are strongly +% advised to use an enhanced (at the very least that provided by array.sty) +% set of table tools. array.sty is already installed on most systems. The +% latest version and documentation can be obtained at: +% http://www.ctan.org/tex-archive/macros/latex/required/tools/ + + +%\usepackage{mdwmath} +%\usepackage{mdwtab} +% Also highly recommended is Mark Wooding's extremely powerful MDW tools, +% especially mdwmath.sty and mdwtab.sty which are used to format equations +% and tables, respectively. The MDWtools set is already installed on most +% LaTeX systems. The lastest version and documentation is available at: +% http://www.ctan.org/tex-archive/macros/latex/contrib/mdwtools/ + + +% IEEEtran contains the IEEEeqnarray family of commands that can be used to +% generate multiline equations as well as matrices, tables, etc., of high +% quality. + + +%\usepackage{eqparbox} +% Also of notable interest is Scott Pakin's eqparbox package for creating +% (automatically sized) equal width boxes - aka "natural width parboxes". +% Available at: +% http://www.ctan.org/tex-archive/macros/latex/contrib/eqparbox/ + + + + + +% *** SUBFIGURE PACKAGES *** +%\usepackage[tight,footnotesize]{subfigure} +% subfigure.sty was written by Steven Douglas Cochran. This package makes it +% easy to put subfigures in your figures. e.g., "Figure 1a and 1b". For IEEE +% work, it is a good idea to load it with the tight package option to reduce +% the amount of white space around the subfigures. subfigure.sty is already +% installed on most LaTeX systems. The latest version and documentation can +% be obtained at: +% http://www.ctan.org/tex-archive/obsolete/macros/latex/contrib/subfigure/ +% subfigure.sty has been superceeded by subfig.sty. + + + +%\usepackage[caption=false]{caption} +%\usepackage[font=footnotesize]{subfig} +% subfig.sty, also written by Steven Douglas Cochran, is the modern +% replacement for subfigure.sty. However, subfig.sty requires and +% automatically loads Axel Sommerfeldt's caption.sty which will override +% IEEEtran.cls handling of captions and this will result in nonIEEE style +% figure/table captions. To prevent this problem, be sure and preload +% caption.sty with its "caption=false" package option. This is will preserve +% IEEEtran.cls handing of captions. Version 1.3 (2005/06/28) and later +% (recommended due to many improvements over 1.2) of subfig.sty supports +% the caption=false option directly: +%\usepackage[caption=false,font=footnotesize]{subfig} +% +% The latest version and documentation can be obtained at: +% http://www.ctan.org/tex-archive/macros/latex/contrib/subfig/ +% The latest version and documentation of caption.sty can be obtained at: +% http://www.ctan.org/tex-archive/macros/latex/contrib/caption/ + + + + +% *** FLOAT PACKAGES *** +% +%\usepackage{fixltx2e} +% fixltx2e, the successor to the earlier fix2col.sty, was written by +% Frank Mittelbach and David Carlisle. This package corrects a few problems +% in the LaTeX2e kernel, the most notable of which is that in current +% LaTeX2e releases, the ordering of single and double column floats is not +% guaranteed to be preserved. Thus, an unpatched LaTeX2e can allow a +% single column figure to be placed prior to an earlier double column +% figure. The latest version and documentation can be found at: +% http://www.ctan.org/tex-archive/macros/latex/base/ + + + +%\usepackage{stfloats} +% stfloats.sty was written by Sigitas Tolusis. This package gives LaTeX2e +% the ability to do double column floats at the bottom of the page as well +% as the top. (e.g., "\begin{figure*}[!b]" is not normally possible in +% LaTeX2e). It also provides a command: +%\fnbelowfloat +% to enable the placement of footnotes below bottom floats (the standard +% LaTeX2e kernel puts them above bottom floats). This is an invasive package +% which rewrites many portions of the LaTeX2e float routines. It may not work +% with other packages that modify the LaTeX2e float routines. The latest +% version and documentation can be obtained at: +% http://www.ctan.org/tex-archive/macros/latex/contrib/sttools/ +% Documentation is contained in the stfloats.sty comments as well as in the +% presfull.pdf file. Do not use the stfloats baselinefloat ability as IEEE +% does not allow \baselineskip to stretch. Authors submitting work to the +% IEEE should note that IEEE rarely uses double column equations and +% that authors should try to avoid such use. Do not be tempted to use the +% cuted.sty or midfloat.sty packages (also by Sigitas Tolusis) as IEEE does +% not format its papers in such ways. + + + + + +% *** PDF, URL AND HYPERLINK PACKAGES *** +% +%\usepackage{url} +% url.sty was written by Donald Arseneau. It provides better support for +% handling and breaking URLs. url.sty is already installed on most LaTeX +% systems. The latest version can be obtained at: +% http://www.ctan.org/tex-archive/macros/latex/contrib/misc/ +% Read the url.sty source comments for usage information. Basically, +% \url{my_url_here}. + + + + + +% *** Do not adjust lengths that control margins, column widths, etc. *** +% *** Do not use packages that alter fonts (such as pslatex). *** +% There should be no need to do such things with IEEEtran.cls V1.6 and later. +% (Unless specifically asked to do so by the journal or conference you plan +% to submit to, of course. ) + + +% correct bad hyphenation here +\hyphenation{op-tical net-works semi-conduc-tor} + + +\begin{document} +% +% paper title +% can use linebreaks \\ within to get better formatting as desired +\title{Bare Demo of IEEEtran.cls for Conferences} + + +% author names and affiliations +% use a multiple column layout for up to three different +% affiliations +\author{\IEEEauthorblockN{Michael Shell} +\IEEEauthorblockA{School of Electrical and\\Computer Engineering\\ +Georgia Institute of Technology\\ +Atlanta, Georgia 30332--0250\\ +Email: http://www.michaelshell.org/contact.html} +\and +\IEEEauthorblockN{Homer Simpson} +\IEEEauthorblockA{Twentieth Century Fox\\ +Springfield, USA\\ +Email: homer@thesimpsons.com} +\and +\IEEEauthorblockN{James Kirk\\ and Montgomery Scott} +\IEEEauthorblockA{Starfleet Academy\\ +San Francisco, California 96678-2391\\ +Telephone: (800) 555--1212\\ +Fax: (888) 555--1212}} + +% conference papers do not typically use \thanks and this command +% is locked out in conference mode. If really needed, such as for +% the acknowledgment of grants, issue a \IEEEoverridecommandlockouts +% after \documentclass + +% for over three affiliations, or if they all won't fit within the width +% of the page, use this alternative format: +% +%\author{\IEEEauthorblockN{Michael Shell\IEEEauthorrefmark{1}, +%Homer Simpson\IEEEauthorrefmark{2}, +%James Kirk\IEEEauthorrefmark{3}, +%Montgomery Scott\IEEEauthorrefmark{3} and +%Eldon Tyrell\IEEEauthorrefmark{4}} +%\IEEEauthorblockA{\IEEEauthorrefmark{1}School of Electrical and Computer Engineering\\ +%Georgia Institute of Technology, +%Atlanta, Georgia 30332--0250\\ Email: see http://www.michaelshell.org/contact.html} +%\IEEEauthorblockA{\IEEEauthorrefmark{2}Twentieth Century Fox, Springfield, USA\\ +%Email: homer@thesimpsons.com} +%\IEEEauthorblockA{\IEEEauthorrefmark{3}Starfleet Academy, San Francisco, California 96678-2391\\ +%Telephone: (800) 555--1212, Fax: (888) 555--1212} +%\IEEEauthorblockA{\IEEEauthorrefmark{4}Tyrell Inc., 123 Replicant Street, Los Angeles, California 90210--4321}} + + + + +% use for special paper notices +%\IEEEspecialpapernotice{(Invited Paper)} + + + + +% make the title area +\maketitle + + +\begin{abstract} +%\boldmath +The abstract goes here. +\end{abstract} +% IEEEtran.cls defaults to using nonbold math in the Abstract. +% This preserves the distinction between vectors and scalars. However, +% if the conference you are submitting to favors bold math in the abstract, +% then you can use LaTeX's standard command \boldmath at the very start +% of the abstract to achieve this. Many IEEE journals/conferences frown on +% math in the abstract anyway. + +% no keywords + + + + +% For peer review papers, you can put extra information on the cover +% page as needed: +% \ifCLASSOPTIONpeerreview +% \begin{center} \bfseries EDICS Category: 3-BBND \end{center} +% \fi +% +% For peerreview papers, this IEEEtran command inserts a page break and +% creates the second title. It will be ignored for other modes. +\IEEEpeerreviewmaketitle + + + +\section{Introduction} +% no \IEEEPARstart +This demo file is intended to serve as a ``starter file'' +for IEEE conference papers produced under \LaTeX\ using +IEEEtran.cls version 1.7 and later. +% You must have at least 2 lines in the paragraph with the drop letter +% (should never be an issue) +I wish you the best of success. + +\hfill mds + +\hfill January 11, 2007 + +\subsection{Subsection Heading Here} +Subsection text here. + + +\subsubsection{Subsubsection Heading Here} +Subsubsection text here. + + +% An example of a floating figure using the graphicx package. +% Note that \label must occur AFTER (or within) \caption. +% For figures, \caption should occur after the \includegraphics. +% Note that IEEEtran v1.7 and later has special internal code that +% is designed to preserve the operation of \label within \caption +% even when the captionsoff option is in effect. However, because +% of issues like this, it may be the safest practice to put all your +% \label just after \caption rather than within \caption{}. +% +% Reminder: the "draftcls" or "draftclsnofoot", not "draft", class +% option should be used if it is desired that the figures are to be +% displayed while in draft mode. +% +%\begin{figure}[!t] +%\centering +%\includegraphics[width=2.5in]{myfigure} +% where an .eps filename suffix will be assumed under latex, +% and a .pdf suffix will be assumed for pdflatex; or what has been declared +% via \DeclareGraphicsExtensions. +%\caption{Simulation Results} +%\label{fig_sim} +%\end{figure} + +% Note that IEEE typically puts floats only at the top, even when this +% results in a large percentage of a column being occupied by floats. + + +% An example of a double column floating figure using two subfigures. +% (The subfig.sty package must be loaded for this to work.) +% The subfigure \label commands are set within each subfloat command, the +% \label for the overall figure must come after \caption. +% \hfil must be used as a separator to get equal spacing. +% The subfigure.sty package works much the same way, except \subfigure is +% used instead of \subfloat. +% +%\begin{figure*}[!t] +%\centerline{\subfloat[Case I]\includegraphics[width=2.5in]{subfigcase1}% +%\label{fig_first_case}} +%\hfil +%\subfloat[Case II]{\includegraphics[width=2.5in]{subfigcase2}% +%\label{fig_second_case}}} +%\caption{Simulation results} +%\label{fig_sim} +%\end{figure*} +% +% Note that often IEEE papers with subfigures do not employ subfigure +% captions (using the optional argument to \subfloat), but instead will +% reference/describe all of them (a), (b), etc., within the main caption. + + +% An example of a floating table. Note that, for IEEE style tables, the +% \caption command should come BEFORE the table. Table text will default to +% \footnotesize as IEEE normally uses this smaller font for tables. +% The \label must come after \caption as always. +% +%\begin{table}[!t] +%% increase table row spacing, adjust to taste +%\renewcommand{\arraystretch}{1.3} +% if using array.sty, it might be a good idea to tweak the value of +% \extrarowheight as needed to properly center the text within the cells +%\caption{An Example of a Table} +%\label{table_example} +%\centering +%% Some packages, such as MDW tools, offer better commands for making tables +%% than the plain LaTeX2e tabular which is used here. +%\begin{tabular}{|c||c|} +%\hline +%One & Two\\ +%\hline +%Three & Four\\ +%\hline +%\end{tabular} +%\end{table} + + +% Note that IEEE does not put floats in the very first column - or typically +% anywhere on the first page for that matter. Also, in-text middle ("here") +% positioning is not used. Most IEEE journals/conferences use top floats +% exclusively. Note that, LaTeX2e, unlike IEEE journals/conferences, places +% footnotes above bottom floats. This can be corrected via the \fnbelowfloat +% command of the stfloats package. + + + +\section{Conclusion} +The conclusion goes here. + + + + +% conference papers do not normally have an appendix + + +% use section* for acknowledgement +\section*{Acknowledgment} + + +The authors would like to thank... + + + + + +% trigger a \newpage just before the given reference +% number - used to balance the columns on the last page +% adjust value as needed - may need to be readjusted if +% the document is modified later +%\IEEEtriggeratref{8} +% The "triggered" command can be changed if desired: +%\IEEEtriggercmd{\enlargethispage{-5in}} + +% references section + +% can use a bibliography generated by BibTeX as a .bbl file +% BibTeX documentation can be easily obtained at: +% http://www.ctan.org/tex-archive/biblio/bibtex/contrib/doc/ +% The IEEEtran BibTeX style support page is at: +% http://www.michaelshell.org/tex/ieeetran/bibtex/ +%\bibliographystyle{IEEEtran} +% argument is your BibTeX string definitions and bibliography database(s) +%\bibliography{IEEEabrv,../bib/paper} +% +% manually copy in the resultant .bbl file +% set second argument of \begin to the number of references +% (used to reserve space for the reference number labels box) +\begin{thebibliography}{1} + +\bibitem{IEEEhowto:kopka} +H.~Kopka and P.~W. Daly, \emph{A Guide to \LaTeX}, 3rd~ed.\hskip 1em plus + 0.5em minus 0.4em\relax Harlow, England: Addison-Wesley, 1999. + +\end{thebibliography} + + + + +% that's all folks +\end{document} + + diff --git a/IEEEtran/bare_jrnl.tex b/IEEEtran/bare_jrnl.tex new file mode 100644 index 0000000..6f9f67c --- /dev/null +++ b/IEEEtran/bare_jrnl.tex @@ -0,0 +1,745 @@ + +%% bare_jrnl.tex +%% V1.3 +%% 2007/01/11 +%% by Michael Shell +%% see http://www.michaelshell.org/ +%% for current contact information. +%% +%% This is a skeleton file demonstrating the use of IEEEtran.cls +%% (requires IEEEtran.cls version 1.7 or later) with an IEEE journal paper. +%% +%% Support sites: +%% http://www.michaelshell.org/tex/ieeetran/ +%% http://www.ctan.org/tex-archive/macros/latex/contrib/IEEEtran/ +%% and +%% http://www.ieee.org/ + + + +% *** Authors should verify (and, if needed, correct) their LaTeX system *** +% *** with the testflow diagnostic prior to trusting their LaTeX platform *** +% *** with production work. IEEE's font choices can trigger bugs that do *** +% *** not appear when using other class files. *** +% The testflow support page is at: +% http://www.michaelshell.org/tex/testflow/ + + +%%************************************************************************* +%% Legal Notice: +%% This code is offered as-is without any warranty either expressed or +%% implied; without even the implied warranty of MERCHANTABILITY or +%% FITNESS FOR A PARTICULAR PURPOSE! +%% User assumes all risk. +%% In no event shall IEEE or any contributor to this code be liable for +%% any damages or losses, including, but not limited to, incidental, +%% consequential, or any other damages, resulting from the use or misuse +%% of any information contained here. +%% +%% All comments are the opinions of their respective authors and are not +%% necessarily endorsed by the IEEE. +%% +%% This work is distributed under the LaTeX Project Public License (LPPL) +%% ( http://www.latex-project.org/ ) version 1.3, and may be freely used, +%% distributed and modified. A copy of the LPPL, version 1.3, is included +%% in the base LaTeX documentation of all distributions of LaTeX released +%% 2003/12/01 or later. +%% Retain all contribution notices and credits. +%% ** Modified files should be clearly indicated as such, including ** +%% ** renaming them and changing author support contact information. ** +%% +%% File list of work: IEEEtran.cls, IEEEtran_HOWTO.pdf, bare_adv.tex, +%% bare_conf.tex, bare_jrnl.tex, bare_jrnl_compsoc.tex +%%************************************************************************* + +% Note that the a4paper option is mainly intended so that authors in +% countries using A4 can easily print to A4 and see how their papers will +% look in print - the typesetting of the document will not typically be +% affected with changes in paper size (but the bottom and side margins will). +% Use the testflow package mentioned above to verify correct handling of +% both paper sizes by the user's LaTeX system. +% +% Also note that the "draftcls" or "draftclsnofoot", not "draft", option +% should be used if it is desired that the figures are to be displayed in +% draft mode. +% +\documentclass[journal]{IEEEtran} +% +% If IEEEtran.cls has not been installed into the LaTeX system files, +% manually specify the path to it like: +% \documentclass[journal]{../sty/IEEEtran} + + + + + +% Some very useful LaTeX packages include: +% (uncomment the ones you want to load) + + +% *** MISC UTILITY PACKAGES *** +% +%\usepackage{ifpdf} +% Heiko Oberdiek's ifpdf.sty is very useful if you need conditional +% compilation based on whether the output is pdf or dvi. +% usage: +% \ifpdf +% % pdf code +% \else +% % dvi code +% \fi +% The latest version of ifpdf.sty can be obtained from: +% http://www.ctan.org/tex-archive/macros/latex/contrib/oberdiek/ +% Also, note that IEEEtran.cls V1.7 and later provides a builtin +% \ifCLASSINFOpdf conditional that works the same way. +% When switching from latex to pdflatex and vice-versa, the compiler may +% have to be run twice to clear warning/error messages. + + + + + + +% *** CITATION PACKAGES *** +% +%\usepackage{cite} +% cite.sty was written by Donald Arseneau +% V1.6 and later of IEEEtran pre-defines the format of the cite.sty package +% \cite{} output to follow that of IEEE. Loading the cite package will +% result in citation numbers being automatically sorted and properly +% "compressed/ranged". e.g., [1], [9], [2], [7], [5], [6] without using +% cite.sty will become [1], [2], [5]--[7], [9] using cite.sty. cite.sty's +% \cite will automatically add leading space, if needed. Use cite.sty's +% noadjust option (cite.sty V3.8 and later) if you want to turn this off. +% cite.sty is already installed on most LaTeX systems. Be sure and use +% version 4.0 (2003-05-27) and later if using hyperref.sty. cite.sty does +% not currently provide for hyperlinked citations. +% The latest version can be obtained at: +% http://www.ctan.org/tex-archive/macros/latex/contrib/cite/ +% The documentation is contained in the cite.sty file itself. + + + + + + +% *** GRAPHICS RELATED PACKAGES *** +% +\ifCLASSINFOpdf + % \usepackage[pdftex]{graphicx} + % declare the path(s) where your graphic files are + % \graphicspath{{../pdf/}{../jpeg/}} + % and their extensions so you won't have to specify these with + % every instance of \includegraphics + % \DeclareGraphicsExtensions{.pdf,.jpeg,.png} +\else + % or other class option (dvipsone, dvipdf, if not using dvips). graphicx + % will default to the driver specified in the system graphics.cfg if no + % driver is specified. + % \usepackage[dvips]{graphicx} + % declare the path(s) where your graphic files are + % \graphicspath{{../eps/}} + % and their extensions so you won't have to specify these with + % every instance of \includegraphics + % \DeclareGraphicsExtensions{.eps} +\fi +% graphicx was written by David Carlisle and Sebastian Rahtz. It is +% required if you want graphics, photos, etc. graphicx.sty is already +% installed on most LaTeX systems. The latest version and documentation can +% be obtained at: +% http://www.ctan.org/tex-archive/macros/latex/required/graphics/ +% Another good source of documentation is "Using Imported Graphics in +% LaTeX2e" by Keith Reckdahl which can be found as epslatex.ps or +% epslatex.pdf at: http://www.ctan.org/tex-archive/info/ +% +% latex, and pdflatex in dvi mode, support graphics in encapsulated +% postscript (.eps) format. pdflatex in pdf mode supports graphics +% in .pdf, .jpeg, .png and .mps (metapost) formats. Users should ensure +% that all non-photo figures use a vector format (.eps, .pdf, .mps) and +% not a bitmapped formats (.jpeg, .png). IEEE frowns on bitmapped formats +% which can result in "jaggedy"/blurry rendering of lines and letters as +% well as large increases in file sizes. +% +% You can find documentation about the pdfTeX application at: +% http://www.tug.org/applications/pdftex + + + + + +% *** MATH PACKAGES *** +% +%\usepackage[cmex10]{amsmath} +% A popular package from the American Mathematical Society that provides +% many useful and powerful commands for dealing with mathematics. If using +% it, be sure to load this package with the cmex10 option to ensure that +% only type 1 fonts will utilized at all point sizes. Without this option, +% it is possible that some math symbols, particularly those within +% footnotes, will be rendered in bitmap form which will result in a +% document that can not be IEEE Xplore compliant! +% +% Also, note that the amsmath package sets \interdisplaylinepenalty to 10000 +% thus preventing page breaks from occurring within multiline equations. Use: +%\interdisplaylinepenalty=2500 +% after loading amsmath to restore such page breaks as IEEEtran.cls normally +% does. amsmath.sty is already installed on most LaTeX systems. The latest +% version and documentation can be obtained at: +% http://www.ctan.org/tex-archive/macros/latex/required/amslatex/math/ + + + + + +% *** SPECIALIZED LIST PACKAGES *** +% +%\usepackage{algorithmic} +% algorithmic.sty was written by Peter Williams and Rogerio Brito. +% This package provides an algorithmic environment fo describing algorithms. +% You can use the algorithmic environment in-text or within a figure +% environment to provide for a floating algorithm. Do NOT use the algorithm +% floating environment provided by algorithm.sty (by the same authors) or +% algorithm2e.sty (by Christophe Fiorio) as IEEE does not use dedicated +% algorithm float types and packages that provide these will not provide +% correct IEEE style captions. The latest version and documentation of +% algorithmic.sty can be obtained at: +% http://www.ctan.org/tex-archive/macros/latex/contrib/algorithms/ +% There is also a support site at: +% http://algorithms.berlios.de/index.html +% Also of interest may be the (relatively newer and more customizable) +% algorithmicx.sty package by Szasz Janos: +% http://www.ctan.org/tex-archive/macros/latex/contrib/algorithmicx/ + + + + +% *** ALIGNMENT PACKAGES *** +% +%\usepackage{array} +% Frank Mittelbach's and David Carlisle's array.sty patches and improves +% the standard LaTeX2e array and tabular environments to provide better +% appearance and additional user controls. As the default LaTeX2e table +% generation code is lacking to the point of almost being broken with +% respect to the quality of the end results, all users are strongly +% advised to use an enhanced (at the very least that provided by array.sty) +% set of table tools. array.sty is already installed on most systems. The +% latest version and documentation can be obtained at: +% http://www.ctan.org/tex-archive/macros/latex/required/tools/ + + +%\usepackage{mdwmath} +%\usepackage{mdwtab} +% Also highly recommended is Mark Wooding's extremely powerful MDW tools, +% especially mdwmath.sty and mdwtab.sty which are used to format equations +% and tables, respectively. The MDWtools set is already installed on most +% LaTeX systems. The lastest version and documentation is available at: +% http://www.ctan.org/tex-archive/macros/latex/contrib/mdwtools/ + + +% IEEEtran contains the IEEEeqnarray family of commands that can be used to +% generate multiline equations as well as matrices, tables, etc., of high +% quality. + + +%\usepackage{eqparbox} +% Also of notable interest is Scott Pakin's eqparbox package for creating +% (automatically sized) equal width boxes - aka "natural width parboxes". +% Available at: +% http://www.ctan.org/tex-archive/macros/latex/contrib/eqparbox/ + + + + + +% *** SUBFIGURE PACKAGES *** +%\usepackage[tight,footnotesize]{subfigure} +% subfigure.sty was written by Steven Douglas Cochran. This package makes it +% easy to put subfigures in your figures. e.g., "Figure 1a and 1b". For IEEE +% work, it is a good idea to load it with the tight package option to reduce +% the amount of white space around the subfigures. subfigure.sty is already +% installed on most LaTeX systems. The latest version and documentation can +% be obtained at: +% http://www.ctan.org/tex-archive/obsolete/macros/latex/contrib/subfigure/ +% subfigure.sty has been superceeded by subfig.sty. + + + +%\usepackage[caption=false]{caption} +%\usepackage[font=footnotesize]{subfig} +% subfig.sty, also written by Steven Douglas Cochran, is the modern +% replacement for subfigure.sty. However, subfig.sty requires and +% automatically loads Axel Sommerfeldt's caption.sty which will override +% IEEEtran.cls handling of captions and this will result in nonIEEE style +% figure/table captions. To prevent this problem, be sure and preload +% caption.sty with its "caption=false" package option. This is will preserve +% IEEEtran.cls handing of captions. Version 1.3 (2005/06/28) and later +% (recommended due to many improvements over 1.2) of subfig.sty supports +% the caption=false option directly: +%\usepackage[caption=false,font=footnotesize]{subfig} +% +% The latest version and documentation can be obtained at: +% http://www.ctan.org/tex-archive/macros/latex/contrib/subfig/ +% The latest version and documentation of caption.sty can be obtained at: +% http://www.ctan.org/tex-archive/macros/latex/contrib/caption/ + + + + +% *** FLOAT PACKAGES *** +% +%\usepackage{fixltx2e} +% fixltx2e, the successor to the earlier fix2col.sty, was written by +% Frank Mittelbach and David Carlisle. This package corrects a few problems +% in the LaTeX2e kernel, the most notable of which is that in current +% LaTeX2e releases, the ordering of single and double column floats is not +% guaranteed to be preserved. Thus, an unpatched LaTeX2e can allow a +% single column figure to be placed prior to an earlier double column +% figure. The latest version and documentation can be found at: +% http://www.ctan.org/tex-archive/macros/latex/base/ + + + +%\usepackage{stfloats} +% stfloats.sty was written by Sigitas Tolusis. This package gives LaTeX2e +% the ability to do double column floats at the bottom of the page as well +% as the top. (e.g., "\begin{figure*}[!b]" is not normally possible in +% LaTeX2e). It also provides a command: +%\fnbelowfloat +% to enable the placement of footnotes below bottom floats (the standard +% LaTeX2e kernel puts them above bottom floats). This is an invasive package +% which rewrites many portions of the LaTeX2e float routines. It may not work +% with other packages that modify the LaTeX2e float routines. The latest +% version and documentation can be obtained at: +% http://www.ctan.org/tex-archive/macros/latex/contrib/sttools/ +% Documentation is contained in the stfloats.sty comments as well as in the +% presfull.pdf file. Do not use the stfloats baselinefloat ability as IEEE +% does not allow \baselineskip to stretch. Authors submitting work to the +% IEEE should note that IEEE rarely uses double column equations and +% that authors should try to avoid such use. Do not be tempted to use the +% cuted.sty or midfloat.sty packages (also by Sigitas Tolusis) as IEEE does +% not format its papers in such ways. + + +%\ifCLASSOPTIONcaptionsoff +% \usepackage[nomarkers]{endfloat} +% \let\MYoriglatexcaption\caption +% \renewcommand{\caption}[2][\relax]{\MYoriglatexcaption[#2]{#2}} +%\fi +% endfloat.sty was written by James Darrell McCauley and Jeff Goldberg. +% This package may be useful when used in conjunction with IEEEtran.cls' +% captionsoff option. Some IEEE journals/societies require that submissions +% have lists of figures/tables at the end of the paper and that +% figures/tables without any captions are placed on a page by themselves at +% the end of the document. If needed, the draftcls IEEEtran class option or +% \CLASSINPUTbaselinestretch interface can be used to increase the line +% spacing as well. Be sure and use the nomarkers option of endfloat to +% prevent endfloat from "marking" where the figures would have been placed +% in the text. The two hack lines of code above are a slight modification of +% that suggested by in the endfloat docs (section 8.3.1) to ensure that +% the full captions always appear in the list of figures/tables - even if +% the user used the short optional argument of \caption[]{}. +% IEEE papers do not typically make use of \caption[]'s optional argument, +% so this should not be an issue. A similar trick can be used to disable +% captions of packages such as subfig.sty that lack options to turn off +% the subcaptions: +% For subfig.sty: +% \let\MYorigsubfloat\subfloat +% \renewcommand{\subfloat}[2][\relax]{\MYorigsubfloat[]{#2}} +% For subfigure.sty: +% \let\MYorigsubfigure\subfigure +% \renewcommand{\subfigure}[2][\relax]{\MYorigsubfigure[]{#2}} +% However, the above trick will not work if both optional arguments of +% the \subfloat/subfig command are used. Furthermore, there needs to be a +% description of each subfigure *somewhere* and endfloat does not add +% subfigure captions to its list of figures. Thus, the best approach is to +% avoid the use of subfigure captions (many IEEE journals avoid them anyway) +% and instead reference/explain all the subfigures within the main caption. +% The latest version of endfloat.sty and its documentation can obtained at: +% http://www.ctan.org/tex-archive/macros/latex/contrib/endfloat/ +% +% The IEEEtran \ifCLASSOPTIONcaptionsoff conditional can also be used +% later in the document, say, to conditionally put the References on a +% page by themselves. + + + + + +% *** PDF, URL AND HYPERLINK PACKAGES *** +% +%\usepackage{url} +% url.sty was written by Donald Arseneau. It provides better support for +% handling and breaking URLs. url.sty is already installed on most LaTeX +% systems. The latest version can be obtained at: +% http://www.ctan.org/tex-archive/macros/latex/contrib/misc/ +% Read the url.sty source comments for usage information. Basically, +% \url{my_url_here}. + + + + + +% *** Do not adjust lengths that control margins, column widths, etc. *** +% *** Do not use packages that alter fonts (such as pslatex). *** +% There should be no need to do such things with IEEEtran.cls V1.6 and later. +% (Unless specifically asked to do so by the journal or conference you plan +% to submit to, of course. ) + + +% correct bad hyphenation here +\hyphenation{op-tical net-works semi-conduc-tor} + + +\begin{document} +% +% paper title +% can use linebreaks \\ within to get better formatting as desired +\title{Bare Demo of IEEEtran.cls for Journals} +% +% +% author names and IEEE memberships +% note positions of commas and nonbreaking spaces ( ~ ) LaTeX will not break +% a structure at a ~ so this keeps an author's name from being broken across +% two lines. +% use \thanks{} to gain access to the first footnote area +% a separate \thanks must be used for each paragraph as LaTeX2e's \thanks +% was not built to handle multiple paragraphs +% + +\author{Michael~Shell,~\IEEEmembership{Member,~IEEE,} + John~Doe,~\IEEEmembership{Fellow,~OSA,} + and~Jane~Doe,~\IEEEmembership{Life~Fellow,~IEEE}% <-this % stops a space +\thanks{M. Shell is with the Department +of Electrical and Computer Engineering, Georgia Institute of Technology, Atlanta, +GA, 30332 USA e-mail: (see http://www.michaelshell.org/contact.html).}% <-this % stops a space +\thanks{J. Doe and J. Doe are with Anonymous University.}% <-this % stops a space +\thanks{Manuscript received April 19, 2005; revised January 11, 2007.}} + +% note the % following the last \IEEEmembership and also \thanks - +% these prevent an unwanted space from occurring between the last author name +% and the end of the author line. i.e., if you had this: +% +% \author{....lastname \thanks{...} \thanks{...} } +% ^------------^------------^----Do not want these spaces! +% +% a space would be appended to the last name and could cause every name on that +% line to be shifted left slightly. This is one of those "LaTeX things". For +% instance, "\textbf{A} \textbf{B}" will typeset as "A B" not "AB". To get +% "AB" then you have to do: "\textbf{A}\textbf{B}" +% \thanks is no different in this regard, so shield the last } of each \thanks +% that ends a line with a % and do not let a space in before the next \thanks. +% Spaces after \IEEEmembership other than the last one are OK (and needed) as +% you are supposed to have spaces between the names. For what it is worth, +% this is a minor point as most people would not even notice if the said evil +% space somehow managed to creep in. + + + +% The paper headers +\markboth{Journal of \LaTeX\ Class Files,~Vol.~6, No.~1, January~2007}% +{Shell \MakeLowercase{\textit{et al.}}: Bare Demo of IEEEtran.cls for Journals} +% The only time the second header will appear is for the odd numbered pages +% after the title page when using the twoside option. +% +% *** Note that you probably will NOT want to include the author's *** +% *** name in the headers of peer review papers. *** +% You can use \ifCLASSOPTIONpeerreview for conditional compilation here if +% you desire. + + + + +% If you want to put a publisher's ID mark on the page you can do it like +% this: +%\IEEEpubid{0000--0000/00\$00.00~\copyright~2007 IEEE} +% Remember, if you use this you must call \IEEEpubidadjcol in the second +% column for its text to clear the IEEEpubid mark. + + + +% use for special paper notices +%\IEEEspecialpapernotice{(Invited Paper)} + + + + +% make the title area +\maketitle + + +\begin{abstract} +%\boldmath +The abstract goes here. +\end{abstract} +% IEEEtran.cls defaults to using nonbold math in the Abstract. +% This preserves the distinction between vectors and scalars. However, +% if the journal you are submitting to favors bold math in the abstract, +% then you can use LaTeX's standard command \boldmath at the very start +% of the abstract to achieve this. Many IEEE journals frown on math +% in the abstract anyway. + +% Note that keywords are not normally used for peerreview papers. +\begin{IEEEkeywords} +IEEEtran, journal, \LaTeX, paper, template. +\end{IEEEkeywords} + + + + + + +% For peer review papers, you can put extra information on the cover +% page as needed: +% \ifCLASSOPTIONpeerreview +% \begin{center} \bfseries EDICS Category: 3-BBND \end{center} +% \fi +% +% For peerreview papers, this IEEEtran command inserts a page break and +% creates the second title. It will be ignored for other modes. +\IEEEpeerreviewmaketitle + + + +\section{Introduction} +% The very first letter is a 2 line initial drop letter followed +% by the rest of the first word in caps. +% +% form to use if the first word consists of a single letter: +% \IEEEPARstart{A}{demo} file is .... +% +% form to use if you need the single drop letter followed by +% normal text (unknown if ever used by IEEE): +% \IEEEPARstart{A}{}demo file is .... +% +% Some journals put the first two words in caps: +% \IEEEPARstart{T}{his demo} file is .... +% +% Here we have the typical use of a "T" for an initial drop letter +% and "HIS" in caps to complete the first word. +\IEEEPARstart{T}{his} demo file is intended to serve as a ``starter file'' +for IEEE journal papers produced under \LaTeX\ using +IEEEtran.cls version 1.7 and later. +% You must have at least 2 lines in the paragraph with the drop letter +% (should never be an issue) +I wish you the best of success. + +\hfill mds + +\hfill January 11, 2007 + +\subsection{Subsection Heading Here} +Subsection text here. + +% needed in second column of first page if using \IEEEpubid +%\IEEEpubidadjcol + +\subsubsection{Subsubsection Heading Here} +Subsubsection text here. + + +% An example of a floating figure using the graphicx package. +% Note that \label must occur AFTER (or within) \caption. +% For figures, \caption should occur after the \includegraphics. +% Note that IEEEtran v1.7 and later has special internal code that +% is designed to preserve the operation of \label within \caption +% even when the captionsoff option is in effect. However, because +% of issues like this, it may be the safest practice to put all your +% \label just after \caption rather than within \caption{}. +% +% Reminder: the "draftcls" or "draftclsnofoot", not "draft", class +% option should be used if it is desired that the figures are to be +% displayed while in draft mode. +% +%\begin{figure}[!t] +%\centering +%\includegraphics[width=2.5in]{myfigure} +% where an .eps filename suffix will be assumed under latex, +% and a .pdf suffix will be assumed for pdflatex; or what has been declared +% via \DeclareGraphicsExtensions. +%\caption{Simulation Results} +%\label{fig_sim} +%\end{figure} + +% Note that IEEE typically puts floats only at the top, even when this +% results in a large percentage of a column being occupied by floats. + + +% An example of a double column floating figure using two subfigures. +% (The subfig.sty package must be loaded for this to work.) +% The subfigure \label commands are set within each subfloat command, the +% \label for the overall figure must come after \caption. +% \hfil must be used as a separator to get equal spacing. +% The subfigure.sty package works much the same way, except \subfigure is +% used instead of \subfloat. +% +%\begin{figure*}[!t] +%\centerline{\subfloat[Case I]\includegraphics[width=2.5in]{subfigcase1}% +%\label{fig_first_case}} +%\hfil +%\subfloat[Case II]{\includegraphics[width=2.5in]{subfigcase2}% +%\label{fig_second_case}}} +%\caption{Simulation results} +%\label{fig_sim} +%\end{figure*} +% +% Note that often IEEE papers with subfigures do not employ subfigure +% captions (using the optional argument to \subfloat), but instead will +% reference/describe all of them (a), (b), etc., within the main caption. + + +% An example of a floating table. Note that, for IEEE style tables, the +% \caption command should come BEFORE the table. Table text will default to +% \footnotesize as IEEE normally uses this smaller font for tables. +% The \label must come after \caption as always. +% +%\begin{table}[!t] +%% increase table row spacing, adjust to taste +%\renewcommand{\arraystretch}{1.3} +% if using array.sty, it might be a good idea to tweak the value of +% \extrarowheight as needed to properly center the text within the cells +%\caption{An Example of a Table} +%\label{table_example} +%\centering +%% Some packages, such as MDW tools, offer better commands for making tables +%% than the plain LaTeX2e tabular which is used here. +%\begin{tabular}{|c||c|} +%\hline +%One & Two\\ +%\hline +%Three & Four\\ +%\hline +%\end{tabular} +%\end{table} + + +% Note that IEEE does not put floats in the very first column - or typically +% anywhere on the first page for that matter. Also, in-text middle ("here") +% positioning is not used. Most IEEE journals use top floats exclusively. +% Note that, LaTeX2e, unlike IEEE journals, places footnotes above bottom +% floats. This can be corrected via the \fnbelowfloat command of the +% stfloats package. + + + +\section{Conclusion} +The conclusion goes here. + + + + + +% if have a single appendix: +%\appendix[Proof of the Zonklar Equations] +% or +%\appendix % for no appendix heading +% do not use \section anymore after \appendix, only \section* +% is possibly needed + +% use appendices with more than one appendix +% then use \section to start each appendix +% you must declare a \section before using any +% \subsection or using \label (\appendices by itself +% starts a section numbered zero.) +% + + +\appendices +\section{Proof of the First Zonklar Equation} +Appendix one text goes here. + +% you can choose not to have a title for an appendix +% if you want by leaving the argument blank +\section{} +Appendix two text goes here. + + +% use section* for acknowledgement +\section*{Acknowledgment} + + +The authors would like to thank... + + +% Can use something like this to put references on a page +% by themselves when using endfloat and the captionsoff option. +\ifCLASSOPTIONcaptionsoff + \newpage +\fi + + + +% trigger a \newpage just before the given reference +% number - used to balance the columns on the last page +% adjust value as needed - may need to be readjusted if +% the document is modified later +%\IEEEtriggeratref{8} +% The "triggered" command can be changed if desired: +%\IEEEtriggercmd{\enlargethispage{-5in}} + +% references section + +% can use a bibliography generated by BibTeX as a .bbl file +% BibTeX documentation can be easily obtained at: +% http://www.ctan.org/tex-archive/biblio/bibtex/contrib/doc/ +% The IEEEtran BibTeX style support page is at: +% http://www.michaelshell.org/tex/ieeetran/bibtex/ +%\bibliographystyle{IEEEtran} +% argument is your BibTeX string definitions and bibliography database(s) +%\bibliography{IEEEabrv,../bib/paper} +% +% manually copy in the resultant .bbl file +% set second argument of \begin to the number of references +% (used to reserve space for the reference number labels box) +\begin{thebibliography}{1} + +\bibitem{IEEEhowto:kopka} +H.~Kopka and P.~W. Daly, \emph{A Guide to \LaTeX}, 3rd~ed.\hskip 1em plus + 0.5em minus 0.4em\relax Harlow, England: Addison-Wesley, 1999. + +\end{thebibliography} + +% biography section +% +% If you have an EPS/PDF photo (graphicx package needed) extra braces are +% needed around the contents of the optional argument to biography to prevent +% the LaTeX parser from getting confused when it sees the complicated +% \includegraphics command within an optional argument. (You could create +% your own custom macro containing the \includegraphics command to make things +% simpler here.) +%\begin{biography}[{\includegraphics[width=1in,height=1.25in,clip,keepaspectratio]{mshell}}]{Michael Shell} +% or if you just want to reserve a space for a photo: + +\begin{IEEEbiography}{Michael Shell} +Biography text here. +\end{IEEEbiography} + +% if you will not have a photo at all: +\begin{IEEEbiographynophoto}{John Doe} +Biography text here. +\end{IEEEbiographynophoto} + +% insert where needed to balance the two columns on the last page with +% biographies +%\newpage + +\begin{IEEEbiographynophoto}{Jane Doe} +Biography text here. +\end{IEEEbiographynophoto} + +% You can push biographies down or up by placing +% a \vfill before or after them. The appropriate +% use of \vfill depends on what kind of text is +% on the last page and whether or not the columns +% are being equalized. + +%\vfill + +% Can be used to pull up biographies so that the bottom of the last one +% is flush with the other column. +%\enlargethispage{-5in} + + + +% that's all folks +\end{document} + + diff --git a/IEEEtran/bare_jrnl_compsoc.tex b/IEEEtran/bare_jrnl_compsoc.tex new file mode 100644 index 0000000..c733757 --- /dev/null +++ b/IEEEtran/bare_jrnl_compsoc.tex @@ -0,0 +1,844 @@ + +%% bare_jrnl_compsoc.tex +%% V1.3 +%% 2007/01/11 +%% by Michael Shell +%% See: +%% http://www.michaelshell.org/ +%% for current contact information. +%% +%% This is a skeleton file demonstrating the use of IEEEtran.cls +%% (requires IEEEtran.cls version 1.7 or later) with an IEEE Computer +%% Society journal paper. +%% +%% Support sites: +%% http://www.michaelshell.org/tex/ieeetran/ +%% http://www.ctan.org/tex-archive/macros/latex/contrib/IEEEtran/ +%% and +%% http://www.ieee.org/ + +%%************************************************************************* +%% Legal Notice: +%% This code is offered as-is without any warranty either expressed or +%% implied; without even the implied warranty of MERCHANTABILITY or +%% FITNESS FOR A PARTICULAR PURPOSE! +%% User assumes all risk. +%% In no event shall IEEE or any contributor to this code be liable for +%% any damages or losses, including, but not limited to, incidental, +%% consequential, or any other damages, resulting from the use or misuse +%% of any information contained here. +%% +%% All comments are the opinions of their respective authors and are not +%% necessarily endorsed by the IEEE. +%% +%% This work is distributed under the LaTeX Project Public License (LPPL) +%% ( http://www.latex-project.org/ ) version 1.3, and may be freely used, +%% distributed and modified. A copy of the LPPL, version 1.3, is included +%% in the base LaTeX documentation of all distributions of LaTeX released +%% 2003/12/01 or later. +%% Retain all contribution notices and credits. +%% ** Modified files should be clearly indicated as such, including ** +%% ** renaming them and changing author support contact information. ** +%% +%% File list of work: IEEEtran.cls, IEEEtran_HOWTO.pdf, bare_adv.tex, +%% bare_conf.tex, bare_jrnl.tex, bare_jrnl_compsoc.tex +%%************************************************************************* + +% *** Authors should verify (and, if needed, correct) their LaTeX system *** +% *** with the testflow diagnostic prior to trusting their LaTeX platform *** +% *** with production work. IEEE's font choices can trigger bugs that do *** +% *** not appear when using other class files. *** +% The testflow support page is at: +% http://www.michaelshell.org/tex/testflow/ + + + + +% Note that the a4paper option is mainly intended so that authors in +% countries using A4 can easily print to A4 and see how their papers will +% look in print - the typesetting of the document will not typically be +% affected with changes in paper size (but the bottom and side margins will). +% Use the testflow package mentioned above to verify correct handling of +% both paper sizes by the user's LaTeX system. +% +% Also note that the "draftcls" or "draftclsnofoot", not "draft", option +% should be used if it is desired that the figures are to be displayed in +% draft mode. +% +% The Computer Society usually requires 12pt for submissions. +% +\documentclass[12pt,journal,compsoc]{IEEEtran} +% +% If IEEEtran.cls has not been installed into the LaTeX system files, +% manually specify the path to it like: +% \documentclass[12pt,journal,compsoc]{../sty/IEEEtran} + + + + + +% Some very useful LaTeX packages include: +% (uncomment the ones you want to load) + + +% *** MISC UTILITY PACKAGES *** +% +%\usepackage{ifpdf} +% Heiko Oberdiek's ifpdf.sty is very useful if you need conditional +% compilation based on whether the output is pdf or dvi. +% usage: +% \ifpdf +% % pdf code +% \else +% % dvi code +% \fi +% The latest version of ifpdf.sty can be obtained from: +% http://www.ctan.org/tex-archive/macros/latex/contrib/oberdiek/ +% Also, note that IEEEtran.cls V1.7 and later provides a builtin +% \ifCLASSINFOpdf conditional that works the same way. +% When switching from latex to pdflatex and vice-versa, the compiler may +% have to be run twice to clear warning/error messages. + + + + + + +% *** CITATION PACKAGES *** +% +\ifCLASSOPTIONcompsoc + % IEEE Computer Society needs nocompress option + % requires cite.sty v4.0 or later (November 2003) + % \usepackage[nocompress]{cite} +\else + % normal IEEE + % \usepackage{cite} +\fi +% cite.sty was written by Donald Arseneau +% V1.6 and later of IEEEtran pre-defines the format of the cite.sty package +% \cite{} output to follow that of IEEE. Loading the cite package will +% result in citation numbers being automatically sorted and properly +% "compressed/ranged". e.g., [1], [9], [2], [7], [5], [6] without using +% cite.sty will become [1], [2], [5]--[7], [9] using cite.sty. cite.sty's +% \cite will automatically add leading space, if needed. Use cite.sty's +% noadjust option (cite.sty V3.8 and later) if you want to turn this off. +% cite.sty is already installed on most LaTeX systems. Be sure and use +% version 4.0 (2003-05-27) and later if using hyperref.sty. cite.sty does +% not currently provide for hyperlinked citations. +% The latest version can be obtained at: +% http://www.ctan.org/tex-archive/macros/latex/contrib/cite/ +% The documentation is contained in the cite.sty file itself. +% +% Note that some packages require special options to format as the Computer +% Society requires. In particular, Computer Society papers do not use +% compressed citation ranges as is done in typical IEEE papers +% (e.g., [1]-[4]). Instead, they list every citation separately in order +% (e.g., [1], [2], [3], [4]). To get the latter we need to load the cite +% package with the nocompress option which is supported by cite.sty v4.0 +% and later. Note also the use of a CLASSOPTION conditional provided by +% IEEEtran.cls V1.7 and later. + + + + + +% *** GRAPHICS RELATED PACKAGES *** +% +\ifCLASSINFOpdf + % \usepackage[pdftex]{graphicx} + % declare the path(s) where your graphic files are + % \graphicspath{{../pdf/}{../jpeg/}} + % and their extensions so you won't have to specify these with + % every instance of \includegraphics + % \DeclareGraphicsExtensions{.pdf,.jpeg,.png} +\else + % or other class option (dvipsone, dvipdf, if not using dvips). graphicx + % will default to the driver specified in the system graphics.cfg if no + % driver is specified. + % \usepackage[dvips]{graphicx} + % declare the path(s) where your graphic files are + % \graphicspath{{../eps/}} + % and their extensions so you won't have to specify these with + % every instance of \includegraphics + % \DeclareGraphicsExtensions{.eps} +\fi +% graphicx was written by David Carlisle and Sebastian Rahtz. It is +% required if you want graphics, photos, etc. graphicx.sty is already +% installed on most LaTeX systems. The latest version and documentation can +% be obtained at: +% http://www.ctan.org/tex-archive/macros/latex/required/graphics/ +% Another good source of documentation is "Using Imported Graphics in +% LaTeX2e" by Keith Reckdahl which can be found as epslatex.ps or +% epslatex.pdf at: http://www.ctan.org/tex-archive/info/ +% +% latex, and pdflatex in dvi mode, support graphics in encapsulated +% postscript (.eps) format. pdflatex in pdf mode supports graphics +% in .pdf, .jpeg, .png and .mps (metapost) formats. Users should ensure +% that all non-photo figures use a vector format (.eps, .pdf, .mps) and +% not a bitmapped formats (.jpeg, .png). IEEE frowns on bitmapped formats +% which can result in "jaggedy"/blurry rendering of lines and letters as +% well as large increases in file sizes. +% +% You can find documentation about the pdfTeX application at: +% http://www.tug.org/applications/pdftex + + + + + +% *** MATH PACKAGES *** +% +%\usepackage[cmex10]{amsmath} +% A popular package from the American Mathematical Society that provides +% many useful and powerful commands for dealing with mathematics. If using +% it, be sure to load this package with the cmex10 option to ensure that +% only type 1 fonts will utilized at all point sizes. Without this option, +% it is possible that some math symbols, particularly those within +% footnotes, will be rendered in bitmap form which will result in a +% document that can not be IEEE Xplore compliant! +% +% Also, note that the amsmath package sets \interdisplaylinepenalty to 10000 +% thus preventing page breaks from occurring within multiline equations. Use: +%\interdisplaylinepenalty=2500 +% after loading amsmath to restore such page breaks as IEEEtran.cls normally +% does. amsmath.sty is already installed on most LaTeX systems. The latest +% version and documentation can be obtained at: +% http://www.ctan.org/tex-archive/macros/latex/required/amslatex/math/ + + + + + +% *** SPECIALIZED LIST PACKAGES *** +% +%\usepackage{algorithmic} +% algorithmic.sty was written by Peter Williams and Rogerio Brito. +% This package provides an algorithmic environment fo describing algorithms. +% You can use the algorithmic environment in-text or within a figure +% environment to provide for a floating algorithm. Do NOT use the algorithm +% floating environment provided by algorithm.sty (by the same authors) or +% algorithm2e.sty (by Christophe Fiorio) as IEEE does not use dedicated +% algorithm float types and packages that provide these will not provide +% correct IEEE style captions. The latest version and documentation of +% algorithmic.sty can be obtained at: +% http://www.ctan.org/tex-archive/macros/latex/contrib/algorithms/ +% There is also a support site at: +% http://algorithms.berlios.de/index.html +% Also of interest may be the (relatively newer and more customizable) +% algorithmicx.sty package by Szasz Janos: +% http://www.ctan.org/tex-archive/macros/latex/contrib/algorithmicx/ + + + + +% *** ALIGNMENT PACKAGES *** +% +%\usepackage{array} +% Frank Mittelbach's and David Carlisle's array.sty patches and improves +% the standard LaTeX2e array and tabular environments to provide better +% appearance and additional user controls. As the default LaTeX2e table +% generation code is lacking to the point of almost being broken with +% respect to the quality of the end results, all users are strongly +% advised to use an enhanced (at the very least that provided by array.sty) +% set of table tools. array.sty is already installed on most systems. The +% latest version and documentation can be obtained at: +% http://www.ctan.org/tex-archive/macros/latex/required/tools/ + + +%\usepackage{mdwmath} +%\usepackage{mdwtab} +% Also highly recommended is Mark Wooding's extremely powerful MDW tools, +% especially mdwmath.sty and mdwtab.sty which are used to format equations +% and tables, respectively. The MDWtools set is already installed on most +% LaTeX systems. The lastest version and documentation is available at: +% http://www.ctan.org/tex-archive/macros/latex/contrib/mdwtools/ + + +% IEEEtran contains the IEEEeqnarray family of commands that can be used to +% generate multiline equations as well as matrices, tables, etc., of high +% quality. + + +%\usepackage{eqparbox} +% Also of notable interest is Scott Pakin's eqparbox package for creating +% (automatically sized) equal width boxes - aka "natural width parboxes". +% Available at: +% http://www.ctan.org/tex-archive/macros/latex/contrib/eqparbox/ + + + + + +% *** SUBFIGURE PACKAGES *** +%\ifCLASSOPTIONcompsoc +%\usepackage[tight,normalsize,sf,SF]{subfigure} +%\else +%\usepackage[tight,footnotesize]{subfigure} +%\fi +% subfigure.sty was written by Steven Douglas Cochran. This package makes it +% easy to put subfigures in your figures. e.g., "Figure 1a and 1b". For IEEE +% work, it is a good idea to load it with the tight package option to reduce +% the amount of white space around the subfigures. Computer Society papers +% use a larger font and \sffamily font for their captions, hence the +% additional options needed under compsoc mode. subfigure.sty is already +% installed on most LaTeX systems. The latest version and documentation can +% be obtained at: +% http://www.ctan.org/tex-archive/obsolete/macros/latex/contrib/subfigure/ +% subfigure.sty has been superceeded by subfig.sty. + + +%\ifCLASSOPTIONcompsoc +% \usepackage[caption=false]{caption} +% \usepackage[font=normalsize,labelfont=sf,textfont=sf]{subfig} +%\else +% \usepackage[caption=false]{caption} +% \usepackage[font=footnotesize]{subfig} +%\fi +% subfig.sty, also written by Steven Douglas Cochran, is the modern +% replacement for subfigure.sty. However, subfig.sty requires and +% automatically loads Axel Sommerfeldt's caption.sty which will override +% IEEEtran.cls handling of captions and this will result in nonIEEE style +% figure/table captions. To prevent this problem, be sure and preload +% caption.sty with its "caption=false" package option. This is will preserve +% IEEEtran.cls handing of captions. Version 1.3 (2005/06/28) and later +% (recommended due to many improvements over 1.2) of subfig.sty supports +% the caption=false option directly: +%\ifCLASSOPTIONcompsoc +% \usepackage[caption=false,font=normalsize,labelfont=sf,textfont=sf]{subfig} +%\else +% \usepackage[caption=false,font=footnotesize]{subfig} +%\fi +% +% The latest version and documentation can be obtained at: +% http://www.ctan.org/tex-archive/macros/latex/contrib/subfig/ +% The latest version and documentation of caption.sty can be obtained at: +% http://www.ctan.org/tex-archive/macros/latex/contrib/caption/ + + + + +% *** FLOAT PACKAGES *** +% +%\usepackage{fixltx2e} +% fixltx2e, the successor to the earlier fix2col.sty, was written by +% Frank Mittelbach and David Carlisle. This package corrects a few problems +% in the LaTeX2e kernel, the most notable of which is that in current +% LaTeX2e releases, the ordering of single and double column floats is not +% guaranteed to be preserved. Thus, an unpatched LaTeX2e can allow a +% single column figure to be placed prior to an earlier double column +% figure. The latest version and documentation can be found at: +% http://www.ctan.org/tex-archive/macros/latex/base/ + + + +%\usepackage{stfloats} +% stfloats.sty was written by Sigitas Tolusis. This package gives LaTeX2e +% the ability to do double column floats at the bottom of the page as well +% as the top. (e.g., "\begin{figure*}[!b]" is not normally possible in +% LaTeX2e). It also provides a command: +%\fnbelowfloat +% to enable the placement of footnotes below bottom floats (the standard +% LaTeX2e kernel puts them above bottom floats). This is an invasive package +% which rewrites many portions of the LaTeX2e float routines. It may not work +% with other packages that modify the LaTeX2e float routines. The latest +% version and documentation can be obtained at: +% http://www.ctan.org/tex-archive/macros/latex/contrib/sttools/ +% Documentation is contained in the stfloats.sty comments as well as in the +% presfull.pdf file. Do not use the stfloats baselinefloat ability as IEEE +% does not allow \baselineskip to stretch. Authors submitting work to the +% IEEE should note that IEEE rarely uses double column equations and +% that authors should try to avoid such use. Do not be tempted to use the +% cuted.sty or midfloat.sty packages (also by Sigitas Tolusis) as IEEE does +% not format its papers in such ways. + + + + +%\ifCLASSOPTIONcaptionsoff +% \usepackage[nomarkers]{endfloat} +% \let\MYoriglatexcaption\caption +% \renewcommand{\caption}[2][\relax]{\MYoriglatexcaption[#2]{#2}} +%\fi +% endfloat.sty was written by James Darrell McCauley and Jeff Goldberg. +% This package may be useful when used in conjunction with IEEEtran.cls' +% captionsoff option. Some IEEE journals/societies require that submissions +% have lists of figures/tables at the end of the paper and that +% figures/tables without any captions are placed on a page by themselves at +% the end of the document. If needed, the draftcls IEEEtran class option or +% \CLASSINPUTbaselinestretch interface can be used to increase the line +% spacing as well. Be sure and use the nomarkers option of endfloat to +% prevent endfloat from "marking" where the figures would have been placed +% in the text. The two hack lines of code above are a slight modification of +% that suggested by in the endfloat docs (section 8.3.1) to ensure that +% the full captions always appear in the list of figures/tables - even if +% the user used the short optional argument of \caption[]{}. +% IEEE papers do not typically make use of \caption[]'s optional argument, +% so this should not be an issue. A similar trick can be used to disable +% captions of packages such as subfig.sty that lack options to turn off +% the subcaptions: +% For subfig.sty: +% \let\MYorigsubfloat\subfloat +% \renewcommand{\subfloat}[2][\relax]{\MYorigsubfloat[]{#2}} +% For subfigure.sty: +% \let\MYorigsubfigure\subfigure +% \renewcommand{\subfigure}[2][\relax]{\MYorigsubfigure[]{#2}} +% However, the above trick will not work if both optional arguments of +% the \subfloat/subfig command are used. Furthermore, there needs to be a +% description of each subfigure *somewhere* and endfloat does not add +% subfigure captions to its list of figures. Thus, the best approach is to +% avoid the use of subfigure captions (many IEEE journals avoid them anyway) +% and instead reference/explain all the subfigures within the main caption. +% The latest version of endfloat.sty and its documentation can obtained at: +% http://www.ctan.org/tex-archive/macros/latex/contrib/endfloat/ +% +% The IEEEtran \ifCLASSOPTIONcaptionsoff conditional can also be used +% later in the document, say, to conditionally put the References on a +% page by themselves. + + + + +% *** PDF, URL AND HYPERLINK PACKAGES *** +% +%\usepackage{url} +% url.sty was written by Donald Arseneau. It provides better support for +% handling and breaking URLs. url.sty is already installed on most LaTeX +% systems. The latest version can be obtained at: +% http://www.ctan.org/tex-archive/macros/latex/contrib/misc/ +% Read the url.sty source comments for usage information. Basically, +% \url{my_url_here}. + + + + + +% *** Do not adjust lengths that control margins, column widths, etc. *** +% *** Do not use packages that alter fonts (such as pslatex). *** +% There should be no need to do such things with IEEEtran.cls V1.6 and later. +% (Unless specifically asked to do so by the journal or conference you plan +% to submit to, of course. ) + + +% correct bad hyphenation here +\hyphenation{op-tical net-works semi-conduc-tor} + + +\begin{document} +% +% paper title +% can use linebreaks \\ within to get better formatting as desired +\title{Bare Demo of IEEEtran.cls\\ for Computer Society Journals} +% +% +% author names and IEEE memberships +% note positions of commas and nonbreaking spaces ( ~ ) LaTeX will not break +% a structure at a ~ so this keeps an author's name from being broken across +% two lines. +% use \thanks{} to gain access to the first footnote area +% a separate \thanks must be used for each paragraph as LaTeX2e's \thanks +% was not built to handle multiple paragraphs +% +% +%\IEEEcompsocitemizethanks is a special \thanks that produces the bulleted +% lists the Computer Society journals use for "first footnote" author +% affiliations. Use \IEEEcompsocthanksitem which works much like \item +% for each affiliation group. When not in compsoc mode, +% \IEEEcompsocitemizethanks becomes like \thanks and +% \IEEEcompsocthanksitem becomes a line break with idention. This +% facilitates dual compilation, although admittedly the differences in the +% desired content of \author between the different types of papers makes a +% one-size-fits-all approach a daunting prospect. For instance, compsoc +% journal papers have the author affiliations above the "Manuscript +% received ..." text while in non-compsoc journals this is reversed. Sigh. + +\author{Michael~Shell,~\IEEEmembership{Member,~IEEE,} + John~Doe,~\IEEEmembership{Fellow,~OSA,} + and~Jane~Doe,~\IEEEmembership{Life~Fellow,~IEEE}% <-this % stops a space +\IEEEcompsocitemizethanks{\IEEEcompsocthanksitem M. Shell is with the Department +of Electrical and Computer Engineering, Georgia Institute of Technology, Atlanta, +GA, 30332.\protect\\ +% note need leading \protect in front of \\ to get a newline within \thanks as +% \\ is fragile and will error, could use \hfil\break instead. +E-mail: see http://www.michaelshell.org/contact.html +\IEEEcompsocthanksitem J. Doe and J. Doe are with Anonymous University.}% <-this % stops a space +\thanks{Manuscript received April 19, 2005; revised January 11, 2007.}} + +% note the % following the last \IEEEmembership and also \thanks - +% these prevent an unwanted space from occurring between the last author name +% and the end of the author line. i.e., if you had this: +% +% \author{....lastname \thanks{...} \thanks{...} } +% ^------------^------------^----Do not want these spaces! +% +% a space would be appended to the last name and could cause every name on that +% line to be shifted left slightly. This is one of those "LaTeX things". For +% instance, "\textbf{A} \textbf{B}" will typeset as "A B" not "AB". To get +% "AB" then you have to do: "\textbf{A}\textbf{B}" +% \thanks is no different in this regard, so shield the last } of each \thanks +% that ends a line with a % and do not let a space in before the next \thanks. +% Spaces after \IEEEmembership other than the last one are OK (and needed) as +% you are supposed to have spaces between the names. For what it is worth, +% this is a minor point as most people would not even notice if the said evil +% space somehow managed to creep in. + + + +% The paper headers +\markboth{Journal of \LaTeX\ Class Files,~Vol.~6, No.~1, January~2007}% +{Shell \MakeLowercase{\textit{et al.}}: Bare Demo of IEEEtran.cls for Computer Society Journals} +% The only time the second header will appear is for the odd numbered pages +% after the title page when using the twoside option. +% +% *** Note that you probably will NOT want to include the author's *** +% *** name in the headers of peer review papers. *** +% You can use \ifCLASSOPTIONpeerreview for conditional compilation here if +% you desire. + + + +% The publisher's ID mark at the bottom of the page is less important with +% Computer Society journal papers as those publications place the marks +% outside of the main text columns and, therefore, unlike regular IEEE +% journals, the available text space is not reduced by their presence. +% If you want to put a publisher's ID mark on the page you can do it like +% this: +%\IEEEpubid{0000--0000/00\$00.00~\copyright~2007 IEEE} +% or like this to get the Computer Society new two part style. +%\IEEEpubid{\makebox[\columnwidth]{\hfill 0000--0000/00/\$00.00~\copyright~2007 IEEE}% +%\hspace{\columnsep}\makebox[\columnwidth]{Published by the IEEE Computer Society\hfill}} +% Remember, if you use this you must call \IEEEpubidadjcol in the second +% column for its text to clear the IEEEpubid mark (Computer Society jorunal +% papers don't need this extra clearance.) + + + +% use for special paper notices +%\IEEEspecialpapernotice{(Invited Paper)} + + + +% for Computer Society papers, we must declare the abstract and index terms +% PRIOR to the title within the \IEEEcompsoctitleabstractindextext IEEEtran +% command as these need to go into the title area created by \maketitle. +\IEEEcompsoctitleabstractindextext{% +\begin{abstract} +%\boldmath +The abstract goes here. +\end{abstract} +% IEEEtran.cls defaults to using nonbold math in the Abstract. +% This preserves the distinction between vectors and scalars. However, +% if the journal you are submitting to favors bold math in the abstract, +% then you can use LaTeX's standard command \boldmath at the very start +% of the abstract to achieve this. Many IEEE journals frown on math +% in the abstract anyway. In particular, the Computer Society does +% not want either math or citations to appear in the abstract. + +% Note that keywords are not normally used for peerreview papers. +\begin{IEEEkeywords} +Computer Society, IEEEtran, journal, \LaTeX, paper, template. +\end{IEEEkeywords}} + + +% make the title area +\maketitle + + +% To allow for easy dual compilation without having to reenter the +% abstract/keywords data, the \IEEEcompsoctitleabstractindextext text will +% not be used in maketitle, but will appear (i.e., to be "transported") +% here as \IEEEdisplaynotcompsoctitleabstractindextext when compsoc mode +% is not selected if conference mode is selected - because compsoc +% conference papers position the abstract like regular (non-compsoc) +% papers do! +\IEEEdisplaynotcompsoctitleabstractindextext +% \IEEEdisplaynotcompsoctitleabstractindextext has no effect when using +% compsoc under a non-conference mode. + + +% For peer review papers, you can put extra information on the cover +% page as needed: +% \ifCLASSOPTIONpeerreview +% \begin{center} \bfseries EDICS Category: 3-BBND \end{center} +% \fi +% +% For peerreview papers, this IEEEtran command inserts a page break and +% creates the second title. It will be ignored for other modes. +\IEEEpeerreviewmaketitle + + + +\section{Introduction} +% Computer Society journal papers do something a tad strange with the very +% first section heading (almost always called "Introduction"). They place it +% ABOVE the main text! IEEEtran.cls currently does not do this for you. +% However, You can achieve this effect by making LaTeX jump through some +% hoops via something like: +% +%\ifCLASSOPTIONcompsoc +% \noindent\raisebox{2\baselineskip}[0pt][0pt]% +% {\parbox{\columnwidth}{\section{Introduction}\label{sec:introduction}% +% \global\everypar=\everypar}}% +% \vspace{-1\baselineskip}\vspace{-\parskip}\par +%\else +% \section{Introduction}\label{sec:introduction}\par +%\fi +% +% Admittedly, this is a hack and may well be fragile, but seems to do the +% trick for me. Note the need to keep any \label that may be used right +% after \section in the above as the hack puts \section within a raised box. + + + +% The very first letter is a 2 line initial drop letter followed +% by the rest of the first word in caps (small caps for compsoc). +% +% form to use if the first word consists of a single letter: +% \IEEEPARstart{A}{demo} file is .... +% +% form to use if you need the single drop letter followed by +% normal text (unknown if ever used by IEEE): +% \IEEEPARstart{A}{}demo file is .... +% +% Some journals put the first two words in caps: +% \IEEEPARstart{T}{his demo} file is .... +% +% Here we have the typical use of a "T" for an initial drop letter +% and "HIS" in caps to complete the first word. +\IEEEPARstart{T}{his} demo file is intended to serve as a ``starter file'' +for IEEE Computer Society journal papers produced under \LaTeX\ using +IEEEtran.cls version 1.7 and later. +% You must have at least 2 lines in the paragraph with the drop letter +% (should never be an issue) +I wish you the best of success. + +\hfill mds + +\hfill January 11, 2007 + +\subsection{Subsection Heading Here} +Subsection text here. + +% needed in second column of first page if using \IEEEpubid +%\IEEEpubidadjcol + +\subsubsection{Subsubsection Heading Here} +Subsubsection text here. + + +% An example of a floating figure using the graphicx package. +% Note that \label must occur AFTER (or within) \caption. +% For figures, \caption should occur after the \includegraphics. +% Note that IEEEtran v1.7 and later has special internal code that +% is designed to preserve the operation of \label within \caption +% even when the captionsoff option is in effect. However, because +% of issues like this, it may be the safest practice to put all your +% \label just after \caption rather than within \caption{}. +% +% Reminder: the "draftcls" or "draftclsnofoot", not "draft", class +% option should be used if it is desired that the figures are to be +% displayed while in draft mode. +% +%\begin{figure}[!t] +%\centering +%\includegraphics[width=2.5in]{myfigure} +% where an .eps filename suffix will be assumed under latex, +% and a .pdf suffix will be assumed for pdflatex; or what has been declared +% via \DeclareGraphicsExtensions. +%\caption{Simulation Results} +%\label{fig_sim} +%\end{figure} + +% Note that IEEE typically puts floats only at the top, even when this +% results in a large percentage of a column being occupied by floats. +% However, the Computer Society has been known to put floats at the bottom. + + +% An example of a double column floating figure using two subfigures. +% (The subfig.sty package must be loaded for this to work.) +% The subfigure \label commands are set within each subfloat command, the +% \label for the overall figure must come after \caption. +% \hfil must be used as a separator to get equal spacing. +% The subfigure.sty package works much the same way, except \subfigure is +% used instead of \subfloat. +% +%\begin{figure*}[!t] +%\centerline{\subfloat[Case I]\includegraphics[width=2.5in]{subfigcase1}% +%\label{fig_first_case}} +%\hfil +%\subfloat[Case II]{\includegraphics[width=2.5in]{subfigcase2}% +%\label{fig_second_case}}} +%\caption{Simulation results} +%\label{fig_sim} +%\end{figure*} +% +% Note that often IEEE papers with subfigures do not employ subfigure +% captions (using the optional argument to \subfloat), but instead will +% reference/describe all of them (a), (b), etc., within the main caption. + + +% An example of a floating table. Note that, for IEEE style tables, the +% \caption command should come BEFORE the table. Table text will default to +% \footnotesize as IEEE normally uses this smaller font for tables. +% The \label must come after \caption as always. +% +%\begin{table}[!t] +%% increase table row spacing, adjust to taste +%\renewcommand{\arraystretch}{1.3} +% if using array.sty, it might be a good idea to tweak the value of +% \extrarowheight as needed to properly center the text within the cells +%\caption{An Example of a Table} +%\label{table_example} +%\centering +%% Some packages, such as MDW tools, offer better commands for making tables +%% than the plain LaTeX2e tabular which is used here. +%\begin{tabular}{|c||c|} +%\hline +%One & Two\\ +%\hline +%Three & Four\\ +%\hline +%\end{tabular} +%\end{table} + + +% Note that IEEE does not put floats in the very first column - or typically +% anywhere on the first page for that matter. Also, in-text middle ("here") +% positioning is not used. Most IEEE journals use top floats exclusively. +% However, Computer Society journals sometimes do use bottom floats - bear +% this in mind when choosing appropriate optional arguments for the +% figure/table environments. +% Note that, LaTeX2e, unlike IEEE journals, places footnotes above bottom +% floats. This can be corrected via the \fnbelowfloat command of the +% stfloats package. + + + +\section{Conclusion} +The conclusion goes here. + + + + + +% if have a single appendix: +%\appendix[Proof of the Zonklar Equations] +% or +%\appendix % for no appendix heading +% do not use \section anymore after \appendix, only \section* +% is possibly needed + +% use appendices with more than one appendix +% then use \section to start each appendix +% you must declare a \section before using any +% \subsection or using \label (\appendices by itself +% starts a section numbered zero.) +% + + +\appendices +\section{Proof of the First Zonklar Equation} +Appendix one text goes here. + +% you can choose not to have a title for an appendix +% if you want by leaving the argument blank +\section{} +Appendix two text goes here. + + +% use section* for acknowledgement +\ifCLASSOPTIONcompsoc + % The Computer Society usually uses the plural form + \section*{Acknowledgments} +\else + % regular IEEE prefers the singular form + \section*{Acknowledgment} +\fi + + +The authors would like to thank... + + +% Can use something like this to put references on a page +% by themselves when using endfloat and the captionsoff option. +\ifCLASSOPTIONcaptionsoff + \newpage +\fi + + + +% trigger a \newpage just before the given reference +% number - used to balance the columns on the last page +% adjust value as needed - may need to be readjusted if +% the document is modified later +%\IEEEtriggeratref{8} +% The "triggered" command can be changed if desired: +%\IEEEtriggercmd{\enlargethispage{-5in}} + +% references section + +% can use a bibliography generated by BibTeX as a .bbl file +% BibTeX documentation can be easily obtained at: +% http://www.ctan.org/tex-archive/biblio/bibtex/contrib/doc/ +% The IEEEtran BibTeX style support page is at: +% http://www.michaelshell.org/tex/ieeetran/bibtex/ +%\bibliographystyle{IEEEtran} +% argument is your BibTeX string definitions and bibliography database(s) +%\bibliography{IEEEabrv,../bib/paper} +% +% manually copy in the resultant .bbl file +% set second argument of \begin to the number of references +% (used to reserve space for the reference number labels box) +\begin{thebibliography}{1} + +\bibitem{IEEEhowto:kopka} +H.~Kopka and P.~W. Daly, \emph{A Guide to \LaTeX}, 3rd~ed.\hskip 1em plus + 0.5em minus 0.4em\relax Harlow, England: Addison-Wesley, 1999. + +\end{thebibliography} + +% biography section +% +% If you have an EPS/PDF photo (graphicx package needed) extra braces are +% needed around the contents of the optional argument to biography to prevent +% the LaTeX parser from getting confused when it sees the complicated +% \includegraphics command within an optional argument. (You could create +% your own custom macro containing the \includegraphics command to make things +% simpler here.) +%\begin{biography}[{\includegraphics[width=1in,height=1.25in,clip,keepaspectratio]{mshell}}]{Michael Shell} +% or if you just want to reserve a space for a photo: + +\begin{IEEEbiography}{Michael Shell} +Biography text here. +\end{IEEEbiography} + +% if you will not have a photo at all: +\begin{IEEEbiographynophoto}{John Doe} +Biography text here. +\end{IEEEbiographynophoto} + +% insert where needed to balance the two columns on the last page with +% biographies +%\newpage + +\begin{IEEEbiographynophoto}{Jane Doe} +Biography text here. +\end{IEEEbiographynophoto} + +% You can push biographies down or up by placing +% a \vfill before or after them. The appropriate +% use of \vfill depends on what kind of text is +% on the last page and whether or not the columns +% are being equalized. + +%\vfill + +% Can be used to pull up biographies so that the bottom of the last one +% is flush with the other column. +%\enlargethispage{-5in} + + + +% that's all folks +\end{document} + + diff --git a/IEEEtran/changelog.txt b/IEEEtran/changelog.txt new file mode 100644 index 0000000..80e3b3f --- /dev/null +++ b/IEEEtran/changelog.txt @@ -0,0 +1,762 @@ + + + Changelog history of the IEEEtran LaTeX class. + + + v1.8 -- 2012/11/21 + by Harald Hanche-Olsen and Anders Christensen (IEEE Computational Intelligence Society) + +******* +11/2012 v1.8 changes: + +1335c1335 +< \itemindent 0em% +--- +> \itemindent 0.3em% +1386c1386 +< \itemindent 0em% +--- +> \itemindent .3em% +1436c1436 +< \itemindent 0em% +--- +> \itemindent .3em% +1524c1524 +< \def\unnumberedfootnote{\gdef\@thefnmark{}\@footnotetext} +--- +> \def\unnumberedfootnote{\gdef\@thefnmark{\quad}\@footnotetext} +1526c1526 +< \skip\@mpfootins = \skip\footins +--- +> \skip\@mpfootins 0.3\baselineskip +1531a1532 +> %\long\def\@makefnmark{\scriptsize\normalfont\@thefnmark} +1541c1542 +< \def\footnoterule{\vskip-2pt \hrule height 0.4pt depth \z@ \vskip1.6pt\relax} +--- +> \def\footnoterule{\vskip-2pt \hrule height 0.6pt depth \z@ \vskip1.6pt\relax} +1652c1653 +< \def\figurename{Figure} +--- +> \def\figurename{Fig.} +1740c1741 +< \setlength\abovecaptionskip{0.25\baselineskip} +--- +> \setlength\abovecaptionskip{0.65\baselineskip} +1799c1800 +< \footnotesize{\centering\normalfont\footnotesize#1.\quad\scshape #2\par}% +--- +> \footnotesize{\centering\normalfont\footnotesize#1.\qquad\scshape #2\par}% +1812c1813 +< \ifCLASSOPTIONconference \hbox to\hsize{\normalfont\footnotesize\hfil\box\@tempboxa\hfil}% +--- +> \ifCLASSOPTIONconference \hbox to\hsize{\normalfont\footnotesize\box\@tempboxa\hfil}% +1856c1857 +< \def\table{\def\@floatboxreset{\reset@font\footnotesize\@setminipage}% +--- +> \def\table{\def\@floatboxreset{\reset@font\scriptsize\@setminipage}% +1861c1862 +< \@namedef{table*}{\def\@floatboxreset{\reset@font\footnotesize\@setminipage}\@dblfloat{table}} +--- +> \@namedef{table*}{\def\@floatboxreset{\reset@font\scriptsize\@setminipage}\@dblfloat{table}} +3747c3748 +< \def\endIEEEkeywords{\relax\ifCLASSOPTIONtechnote\vspace{1.34ex}\else\vspace{1.67ex}\fi +--- +> \def\endIEEEkeywords{\relax\ifCLASSOPTIONtechnote\vspace{1.34ex}\else\vspace{0.5ex}\fi +3826,3827c3827,3829 +< +< \def\@seccntformat#1{\csname the#1dis\endcsname\hskip 1em\relax} +--- +> \def\@seccntformat#1{\hb@xt@ 1.4em{\csname the#1dis\endcsname\hss\relax}} +> \def\@seccntformatinl#1{\hb@xt@ 1.1em{\csname the#1dis\endcsname\hss\relax}} +> \def\@seccntformatch#1{\csname the#1dis\endcsname\hskip 1em\relax} +3843c3845,3853 +< \protected@edef\@svsec{\@seccntformat{#1}\relax}% +--- +> \ifnum #2=1 +> \protected@edef\@svsec{\@seccntformatch{#1}\relax}% +> \else +> \ifnum #2>2 +> \protected@edef\@svsec{\@seccntformatinl{#1}\relax}% +> \else +> \protected@edef\@svsec{\@seccntformat{#1}\relax}% +> \fi +> \fi + + + + + + +***************************************** + +2007/03/05 + by Michael Shell (MDS) + http://www.michaelshell.org/ + +******* + 3/2007 V1.7a (MDS) changes: + + 1) Corrected problem of unwanted two column peer review title page format. + Thanks to Virgilio Rodriguez for reporting this bug. + + 2) "depreciated" -> "deprecated". Thanks to Virgilio Rodriguez for + suggesting this change. + +******* + 1/2007 V1.7 (MDS) changes: + + 1) New class option compsoc to support the IEEE Computer Society format. + + 2) New class option captionsoff disables the display of figure/table + captions. endfloat.sty is now mentioned in the docs. Thanks to Geoff + Walker for suggesting these changes. + + 3) Fixed compatibility issues with subfig.sty and caption.sty. Thanks to + Steven Douglas Cochran and Axel Sommerfeldt for suggesting this change. + + 4) New \CLASSINPUT, \CLASSOPTION and \CLASSINFO interface allows for more + user control and conditional compilation. + + 5) \ifcenterfigcaptions (\centerfigcaptionstrue, \centerfigcaptionsfalse), + \CMPARstart and \overrideIEEEmargins have been removed and no are + longer supported. The effect of \overrideIEEEmargins can be mimicked + via the more general \CLASSINPUT interface: + % US letter paper: + \newcommand{\CLASSINPUTinnersidemargin}{0.775in} + \newcommand{\CLASSINPUToutersidemargin}{0.585in} + % A4 paper: + \newcommand{\CLASSINPUTinnersidemargin}{17mm} + \newcommand{\CLASSINPUToutersidemargin}{11.647mm} + + 6) Several commands and environments have been deprecated in favor of + replacements with IEEE prefixes to better avoid potential future name + clashes with other packages. Legacy code retained to allow the use of + the obsolete forms (for now), but with a warning message to the console + during compilation: + \IEEEauthorblockA, \IEEEauthorblockN, \IEEEauthorrefmark, + \IEEEbiography, \IEEEbiographynophoto, \IEEEkeywords, \IEEEPARstart, + \IEEEproof, \IEEEpubid, \IEEEpubidadjcol, \IEEEQED, \IEEEQEDclosed, + \IEEEQEDopen, \IEEEspecialpapernotice. IEEEtran.cls now redefines + \proof in way to avoid problems with the amsthm.sty package. + For IED lists: + \IEEEiedlabeljustifyc, \IEEEiedlabeljustifyl, \IEEEiedlabeljustifyr, + \IEEEnocalcleftmargin, \IEEElabelindent, \IEEEsetlabelwidth, + \IEEEusemathlabelsep + + 7) These commands/lengths now require the IEEE prefix and do not have + legacy support: \IEEEnormaljot. + For IED lists: \ifIEEEnocalcleftmargin, \ifIEEEnolabelindentfactor, + \IEEEiedlistdecl, \IEEElabelindentfactor + + 8) \normalsizebaselineskip skip replaced by + \CLASSINFOnormalsizebaselineskip (nonrubber dimen) length. + Also, new \CLASSINFOnormalsizeunitybaselineskip (nonrubber dimen) + provided. + + 9) Now defaults to using Alpha numbering rather than Roman for appendices + numbering. This is because Alpha numbering is more common and avoids + problems with theorem numbering. \ifuseRomanappendices + (\useRomanappendicestrue, \useRomanappendicesfalse) is no longer + supported. Instead, use the new class option romanappendices if Roman + appendices numbering is desired. Thanks to Leonid Mirkin for reporting + the problem with theorems in appendices and suggesting changes. + +10) Improved paper size setting code for pdflatex. + +11) Better handling of theorem numbering when using the section counter + within the appendix(cies). Thanks to Leonid Mirkin for suggesting + this change. + +12) Fixed bug that caused equations at the end of theorems to be too + close to the line below them. + +13) Provided hook to conference mode console notice and changed notice to + better support conferences that use A4 paper. Thanks to Volker Kuhlmann + for suggesting this change. + +14) \IEEEauthorrefmark made robust to allow it to be used in \thanks + without a leading \protect + +15) Improved \textunderscore to provide a much better fake _ when used with + OT1 encoding. Under OT1, detect use of pcr or cmtt \ttfamily and use + available true _ glyph for those two typewriter fonts. + +16) Revised internal \@sect command to be more robust for users who employ + modified section heading formats. Thanks to Zarko F. Cucej for + suggesting this change. + +17) Improved \thesubsubsection definition to prevent breaks at the hyphen. + Thanks to Moritz Borgmann for suggesting this change. Thanks to + Dan Luecking and Heiko Oberdiek for explaining some of the various + alternatives and techniques to fix it. + +18) No longer provide \NAT@parse hack to get cite.sty to play (somewhat) + with hyperref.sty as this is already included in cite.sty version + 4.0 (2003-05-27) and later. + +19) At the beginning of document, set the default style of url.sty to be + the same as the current text font - as is done in IEEE journals. + +20) Corrected excessive line spacing in journal table captions. Thanks to + Moritz Borgmann for suggesting this change. + +21) Corrected \thesubsubsection to use the "I-A1" format IEEE uses rather + than "I-A.1" as was done before. Ditto for \theparagraph. Thanks to + Moritz Borgmann for suggesting this change. + +22) Enclose papersize specials within \AtBeginDvi in case someone wants + to make a format with IEEEtran. Thanks to Moritz Borgmann for + suggesting this change. + +23) Eliminated the small space after abstract and keywords dash as IEEE + now does. Thanks to Moritz Borgmann for suggesting this change. + +24) IEEEkeywords is no longer locked out in conference mode + +25) Increase defaults of \binoppenalty and \relpenalty to discourage + breaks within equations. Thanks to Moritz Borgmann for suggesting + this change. + +26) Support optional argument for IEEEproof. Thanks to Ingo Steinwart for + suggesting this change. Also, start a new \par with \IEEEproof. + +27) Add support for an optional argument to \bstctlcite. + +28) Changed \topfraction and \dbltopfraction from 1.0 to 0.9. Thanks to + Donald Arseneau for suggesting this change. + + +******* + 09/2005 V1.6c (MDS) changes: + + 1) Changed endfigure/endfloat definitions so as not to cause problems with + preview-LaTeX and other packages. Thanks to Stephan Heuel and David + Kastrup for reporting this problem. + + + +******* + 11/2002 V1.6b (MDS) changes: + + 1) Fixed problem with figure captions when using hyperref. Thanks to + Leandro Barajas and Michael Bassetti for reporting this bug. + + 2) Provide a fake nabib command \NAT@parse so that hyperref will not + interfere with the operation of cite.sty. However, as a result citation + numbers will not be hyperlinked. Also, natbib will not be able to work + with IEEEtran. However, this is perhaps the best solution until + cite.sty and hyperref.sty are able to co-exist with each other. + It easy enough to override the fake command via: + \makeatletter + \let\NAT@parse\undefined + \makeatother + + 3) Revised font selection method so as not to have problems when used + with setspace.sty. Thanks to Zhang Yan for reporting this bug. + + 4) Added \special to feed papersize to dvips. Thanks to Moritz Borgmann + for suggesting this feature. + + 5) In addition to the IEEE IED lists, the original IED style list + environments (as is done in article.cls) are now provided as + LaTeXitemize, LaTeXenumerate, and LaTeXdescription. Also, users can + now redefine \makelabel within IEEE IED list controls. There may be + some use for this in specialized applications. Thanks to Eli Barzilay + for suggesting this feature. + + 6) \table* now defaults to \footnotesize text like \table. + + 7) The draft modes now no longer force a pagebreak after the title. + Thanks to Christian Peel for suggesting this change. + + 8) New draftclsnofoot mode is like draftcls, but does not display the + date and the word "DRAFT" at the foot of the page. Thanks to + Christian Peel for suggesting this feature. + + 9) New peerreview and peerreviewca modes with \IEEEpeerreviewmaketitle + command allows for a "cover" titlepage for anonymous peer review. + Except for the cover titlepage, peerreview is much like journal mode. + peerreviewca is like peerreview, but allows the author names to be + entered and formatted as under conference mode so that author + affiliations and contact information can be easily seen on the cover + page. Thanks to Eric Benedict for suggesting this feature. + + + +******* + 7/2002 V1.6 (MDS) changes: + + 1) Added conference mode via conference option. Defaults to the + traditional journal mode. e.g., \documentclass[conference]{IEEEtran} + + 2) Added support for A4 paper via new a4paper option. Pdflatex's paper + size lengths are now automatically set to the proper paper size being + used. + + 3) Revised margins again. Page text is now horizontally centered. + Conference mode increases the top and bottom margins with the bottom + margin being slightly larger. For A4 paper, the top margin and text + typesetting will not change from those of US letter paper, but the side + margins will be smaller and the bottom margin will be larger than that + of US letter. All per IEEE specs. + + 4) Fixed footnote line spacing anomaly in draft mode. + Thanks to Alberto Rodriguez for reporting this bug. + + Also, slightly revised footnote and \thanks note spacing. + Set \interfootnotelinepenalty=10000 to prevent LaTeX + from breaking footnotes across multiple pages or columns. + + 5) Fixed bug that caused overwritten photo areas and sometimes anomalous + spacing when a new paragraph was started within a biography. Also, + the presence of \par's, new lines or spaces at the beginning of + abstract, keywords, biography, or biographynophoto will no longer + affect the first word spacing. + Thanks to Eric Durant for reporting this bug. + + The biography environment now does a better job in preventing + a biography photo area from being broken across pages or columns. + + 6) Fixed whitespace between \cite entries bug. i.e., + both \cite{einstein24, knuth84} and \cite{einstein24,knuth84} + are now valid. \cite is now a robust command as it should be. + IEEEtran now no longer defines the old non-standard \shortcite or + \citename. + + The base IEEEtran.cls does not sort citation numbers or produce ranges + for three or more consecutive numbers. However, V1.6 of IEEEtran.cls + now pre-defines the following format control macros to facilitate easy + use with Donald Arseneau's cite.sty package (tested with cite.sty V3.9): + + \def\citepunct{], [} + \def\citedash{]--[} + + cite.sty is standard on most LaTeX sytems and can be obtained from + www.ctan.org. Thanks to Donald Arseneau for creating cite.sty, + providing the required format arguments to produce the IEEE style + and designing a cite interface capable of handling the IEEE citation + style. + + Note: Historically, IEEE has wanted authors to "hardcode" symbolics. + (i.e., replace all \cite{} with fixed [x]). However, it now seems that + most electronic manuscript submissions to IEEE are in .pdf format, and + as such, do not require the LaTeX document reference numbers to be hard + coded. If an author is required to submit actual LaTeX files, I do + recommend that the bibliography file (.bbl) be copied into the .tex + document and the \bibliographystyle{} and \bibliography{} commands be + commented out so that the .tex file does not depend on (potentially + lengthy and/or confidential) external bibliography database files + + 7) Adjusted some spacing parameters. The spacing above and below equations + has been revised (to a typical IEEE value). \jot now has a decent value. + The title text is now exactly 24pt. (On a related note, \fontsubfuzz has + been increased to 0.9pt to prevent annoying font substitution warnings + when using the Computer Modern fonts that use the 24.88pt size.) + In V1.6, \small is now 8.5pt in 9pt docs because \footnotesize is 8pt. + For 9pt docs, you should probably go ahead and use \footnotesize when + you need text a little smaller than \normalsize. + The interword spacing has been adjusted to be extremely close to that + which IEEE uses. You can use a new class option, nofonttune, if you need + to disable the adjusting of the interword spacing. This adjustment and + an increase to \hyphenpenalty have greatly reduced the amount of + hyphenation in a typical paper. + The baselineskip for the normalsize fonts has been tweaked to reduce + underfull vboxes on journal paper columns with only paragraphs. + Conference mode does the same thing but by also tweaking the \textheight + slightly off 9.25in (IEEE spec) to ensure an integer number of lines per + page. Draft (also draftcls) mode has also been revised to reduce + underfull vbox warnings. However, draft mode can still produce underfull + vboxes (a direct result of the increase in line spacing and margins) if: + A non-normalsize font occupies an entire column (abstract and index + terms take up a whole column by themselves); or the beginning of a + section occurs near the end of a column and cannot be squeezed into the + bottom, etc. This is normal as draft mode's liberal spacings cannot + guarantee perfect formatting. + + 8) New biographynophoto environment for biographies without photos. + Usage: + + \begin{biographynophoto}{author name} + biography text here + \end{biographynophoto} + + 9) Fixed bug that produced multiple table of contents entries for papers + with more than one biography. Also, biography now works better with + hyperref. + +10) New \sublargesize font size command provides for 11pt text in a 10pt + document. (Needed for things like author names.) For documents not + using 10pt normal size text, \sublargesize is currently identical + to \large. + +11) New \IEEEmembership command to provide correct font to indicate IEEE + membership for journal papers. + +12) Fixed author name line overflow problem when in journal mode. This + problem had been introduced in V1.5 in my rush to get \and to work for + conferences. \and is unneeded (and invalid) in journal mode. For + conference mode, \and will work as expected and features an optional + spacing argument. i.e., \and[\hspace{5ex}] + \and will default (recommended) to using \hfill which will result in + equal spacing between author blocks. + +13) New \authorblockN, \authorblockA and \authorrefmark commands to + facilitate easy formatting of author names, affiliations and cross + reference symbols, respectively, when in conference mode. These + three commands are to be used only for conference papers. + In conference mode, \author text is placed within a modified tabular + environment (somewhat like article.cls). So, within \author in + conference mode, you should not try to enclose multiple \\ within an + environment or command (other than the argument braces of + \authorblockX{}). For example: + + \author{\authorblockN{{John Doe \\ Jane Doe}}} % WRONG! + + will generate an error. + + Note that font size/attribute changes will now persists across \\ + within \author. (But, not across author blocks nor across \and.) + However, with the new commands, there should be no need to alter any + font attributes within \author. All text sizing and spacing within + \author{} and the author block commands is per IEEE specs for both + conference and journal modes. (In conference mode, the author names + are only very slightly larger than the affiliations which are in normal + size.) For specialized applications you can alter the justification of + author lines by placing \hfill at the beginning or at the end of a line. + The interline spacing within \author is determined by the font + attributes that are in effect at the end of each line within author. + +14) Because the titles and author name blocks use different font + sizes/styles from the main text, it was possible that two column papers + with titles that span both columns (standard journal and conference + papers, but not technotes) with certain numbers of lines for the title + and authors' name/affiliations can cause underfull vbox problems + (paragraphs with large spacings between them) in the second column of + the main text on the title page - if there were no new sections, + equations or figures in this column (they would provide some needed + rubber spacing). The use of things like special paper notices and + publisher ID marks also affected this issue. The problem could not + happen in the first column because the first column has a rubber length + around the heading of the first section. Furthermore, problems seldom + occurred on pages after the first as the margins had been chosen not to + cause it with the popular font sizes. Rubber lengths after the author + names would not fix this problem. + Auto-calculating a "good" spacing after the title is a tad difficult + to do in LaTeX. However, I am pleased to report that V1.6 has this new + capability - "dynamically determined title spacing". IEEEtran will now + measure the height of all the title and author text in \maketitle + and then calculate a rigid (non-rubber) spacer to follow that meets + IEEE specs and also produces a \textheight on the title page that + ensures an integer number of normalsized lines on the rest of the page. + Single column papers, and two column papers with the title entirely in + column one (technotes) do not need dynamic rigid spacing and therefore + use standard rubber spacers. + + Note: This problem can still crop up if you use floats that span both + columns (i.e., figure*). It has been a decade+ long limitation with + LaTeX that the stretchable portion of \dbltextfloatsep is ignored. + If you get a problem with underful vbox warnings and paragraphs that + "are pulled apart" on page with a float that spans both columns, tweak + the space between the figure and the main text a little: + + \vskip 5pt + \end{figure*} + + If you can't find a value that fixes both columns, you are going to + have to put a rubber spacer somewhere in one or both of the columns. +15) Because of change #14 above, those of you using \pubid will, as of V1.6, + have to place it *before* \maketitle in order for it have the intended + affect. The dynamic spacer algorithm must see if you are using \pubid + when \maketitle is called. \pubidadjcol works as before except that it + now has additional logic to prevent it from doing anything if \pubid + was never called. + +16) In some unusual, non-standard circumstances, an author may desire to + alter the spacing after the title area or put some unusual text above + the main text. For instance, to stop a bad break when a new section + occurs right at the start of the second page. This is difficult to do + when the title spans both columns of two column text since LaTeX treats + such title text as a type of float. A new command, + \IEEEaftertitletext{}, gives access to the end of that produced by + \maketitle. The types of things that can go into \IEEEaftertitletext + are the same as those into \twocolumn[] - no \par, but \\ are OK. There + is no restriction on the range of spacings that can be used. e.g., + \IEEEaftertitletext{\vspace{-100pt}} will push the main text well into + the title and \IEEEaftertitletext{\vspace{100pt}} will push it far down + the page. You will have complete control. If used, place + \IEEEaftertitletext{} before \maketitle like \title and \author. + IEEEtran's dynamic title spacing intentionally does not take into + consideration the contents of \IEEEaftertitletext{} when determining + the spacer after the title area (otherwise it would try to second + guess you), so the user will have manually adjust the height of the + contents in \IEEEaftertitletext{} if the problem discussed in #14 above + should develop. A safe bet is to keep the height of contents of + \IEEEaftertitletext{} to integer multiples of \baselineskip, e.g., + \IEEEaftertitletext{\vspace{-1\baselineskip}} + + Because it can result in an IEEE nonstandard format, the use of + \IEEEaftertitletext{} is discouraged. Possible uses include (1) the use + of IEEEtran for non-IEEE work with different title spacing requirements, + or (2) as an emergency manual override if a problem should develop in + IEEEtran's automatic spacing algorithm. + +17) completely rewritten \PARstart to: + a. no longer have problems when the user begins an environment + within the paragraph that uses \PARstart. + b. auto-detect and use the current font family + c. revise handling of the space at the end of the first word so that + interword glue will now work as normal. + d. produce correctly aligned edges for the (two) indented lines. + + Because the current font family is now auto-detected, there is no + longer any need for \CMPARstart - it is now the same as \PARstart. + +18) There is now a new "open box" Q.E.D. symbol (\QEDopen) as well as the + original default (\QED) closed one (\QEDclosed). Some journals use + the open form. To make \proof use the open form, just do: + \renewcommand{\QED}{\QEDopen} + +19) Additional \typeout{} notices added to warn the user when unusual + settings/commands are detected or as reminders to avoid common errors + when in conference mode. + +20) IEEEtran now provides \abovecaptionskip and \belowcaptionskip skip + registers because article class provides them and some packages + may error if they are missing. However, IEEEtran only uses + \abovecaptionskip for actual caption spacing. + +21) Fixed bug that prevented users from redefining the section headings + to use arabic digits. Thanks to Richardt H. Wilkinson for reporting + this bug. + +22) Code cleaned up to be more efficient with the use of TeX registers; + removed some old LaTeX 2.09 code; revised option processing to + LaTeX2e standard; eliminated unwanted "phantom" spaces in some + environments. + +23) Added new \IEEEeqnarray, \IEEEeqnarraybox, \IEEEeqnarrayboxm and + \IEEEeqnarrayboxt environments to provide superior alternatives to the + standard LaTeX \eqnarray, \array and \tabular. Additional new support + commands include \IEEEeqnarraydecl, \IEEEeqnarrayboxdecl, + \IEEEeqnarraymathstyle, \IEEEeqnarraytextstyle, \yesnumber. + \IEEEnonumber, \IEEEyesnumber, \IEEEyessubnumber, \IEEEeqnarraynumspace, + \IEEEeqnarraymulticol, \IEEEeqnarrayomit, \IEEEeqnarraydefcol, + \IEEEeqnarraydefcolsep, \IEEEeqnarrayseprow, \IEEEeqnarrayseprowcut, + \IEEEeqnarrayrulerow, \IEEEeqnarraydblrulerowcut, + \IEEEeqnarraystrutmode, \IEEEeqnarraystrutsize, + \IEEEeqnarraystrutsizeadd, \IEEEvisiblestrutstrue, + \IEEEvisiblestrutsfalse and \IEEEstrut. + These are documented in the user's guide. + +24) V1.6 changed back to using () around theorem names (which are also now + in italics) as this is what IEEE is using now. Thanks to Christian Peel + for reporting this. Also, when section numbers are used as the first + part of theorem numbers, display them in arabic, not Roman. + +25) New \IEEEtriggeratref{X} command allows a page break to be triggered + just before the given reference number "X". This is most useful when + balancing the columns on the last page and a \newpage between references + is desired. \IEEEtriggercmd{X} allows a different command to be executed + at trigger. + + + +******* + 7/2001 V1.5 (MDS) changes: + + + 1) Fixed \and within \author bug: (! Misplaced \crcr. \endtabular ->\crcr) + Thanks to Rainer Dorsch for discovering and reporting that \and + did not work. + + 2) Fixed the biography environment so that if a biography's text is shorter + than the area allocated for the photo, a collision with the next + biography does not occur. You can now put real graphics (using the + graphicx package) into the biography photo box with a new optional + argument of the biography command! For example: + + \begin{biography}[{\includegraphics[width=1in,height=1.25in,clip, + keepaspectratio]{./tux.eps}}]{Linux Penguin} + + will use the specified graphic as the author's photo. The photo area is + exactly 1in wide by 1.25in high - as is done in IEEE Transactions. Try + to keep the same 4:5 aspect ratio if scanning/cropping your photos. + Note the need for the extra set of enclosing braces around the + \includegraphics. Without it, The LaTeX parser may get confused when it + sees the \includegraphics's brackets within the biography's optional + argument. Due to the length of the \includegraphics command, you may + wish to define your own shorthand form of it. I have not done so with + IEEEtran to prevent dependence on the graphicx package. If you do not + use the optional argument, or leave it empty, a standard frame box + with the words "Place Photo Here" will be used. If you want the space + to remain completely empty, you can do: + + \begin{biography}[\mbox{}]{The Invisible Man} + + The interface to biography's optional argument is into a + 1in X 1.25in minipage in which the argument text is centered both + horizontally and vertically: + + \begin{minipage}[b][1.25in][c]{1in}% + \centering + #1% + \end{minipage} + + Within the biography environment, \unitlength is set to 1in. + With this in mind, you can even design your own custom frameboxes. + For instance: + + \begin{biography}[\framebox(1,1.25){\parbox[][\height + ][c]{0.9in}{\centering PLACE\\ PHOTO\\ + HERE}}]{Author Name} + + will yield the same type of result as the default photo box. + + Thanks to Herbert Voss for discovering the collision bug, suggesting + the ability to handle graphics and providing some prototype code. + + + +******* + 3/2001 V1.4 (MDS) changes: + + + 1) New "draftcls" and "final" options have been added. + Thanks to Dragan Cvetkovic for suggesting an option like draftcls. + + 2) Documentation changes to reflect the fact that this IEEEtran.cls + is no longer beta test. + + 3) Slightly revised caption sizes. Figure and table captions are now + in \footnotesize, not \small as before. + + 4) Allow user to control figure caption justification. IEEEtran.cls + normally defaults to left justified as is done in Transactions. + However, for conferences, you may wish to issue the command: + \centerfigcaptionstrue + in the preamble. Short (less than one line long) figure captions + will then be centered. Multi-line figure captions will always be + properly left justified. V1.6: This is already done for you when + using the conference mode. + + + +******* + 1/2001 V1.3 + Michael Shell (MDS) made extensive changes and additions: + + + BUGS FIXED (and many others too numerous to mention!): + 1) Fixed improper alignment with itemized, enumerated and + description lists. Added new controls to these three + environments so that it is easy to get the alignment IEEE + uses. Furthermore, the itemize, enumerate and description lists + no longer force a new paragraph to begin at the end the list + (\par). (Sometimes lists are used within paragraphs.) + + 2) JVH's fixes now allow things like $\mathbf{N}(0,P(0))$ + to work properly without needing the extra braces: + ${\mathbf{N}}(0,P(0))$. There is no longer any dependence + on the "rawfonts" and "oldlfont" packages. Thanks Juergen! + + 3) Fixed underfull hbox errors and incorrect reference number + alignment when the number of references in the bibliography + exceeded 9 entries (which is almost every paper!). + + 4) Removed dependence on the LaTeX sizexx.clo files. + Now, 9pt documents should work correctly even on systems that + lack a size9.clo file. This is most often used in conjunction + with the option "technote" for "correspondence" papers like those + in IEEE Transactions on Information Theory. For virtually all + other papers, 10pt is used and so it is the default. + Some improper font sizes have been corrected. \footnotesize is + now 8pt in 9pt docs, so footnotes in technotes should be the + correct size now. + + 5) Added \interlinepenalty within the bibliography section to discourage + LaTeX from breaking within a reference. IEEE almost never breaks within + a reference and when they do it is usually in technotes + (correspondence papers). You may get an underfull vbox warning in the + bibliography indicating that the spacing just before the "REFERENCES" + section is larger than normal, but the final result will be more like + what IEEE will publish. See the comments in the BIBLIOGRAPHY section + around line 2034 below if you want to change this behavior. + + 6) No longer "blows up" when you use \paragraph and have a table + of contents. + + 7) Theorem environment changed, (but for V1.6, back to the old way, sigh). + + 8) Figure captions adjusted: IEEE left (not center) justifies + figure captions (for journals) and does not indent figure caption text. + + 9) Adjusted some spacings in the table of contents(TOC))/list-of-figures/ + list-of-tables so that section/table numbers will not so easily + collide with the titles. Section VIII was usually the worst offender. + Still doesn't right justify the section numbers, but neither does + article.cls (This must be why LaTeX likes the x.y.z section numbering + scheme unlike I, II, III, etc. of IEEE. ) + It may be "normal" as it is (left justified). sigh. + +10) Now uses "index terms" now as a heading instead of "keywords". + Furthermore, the "index terms" and "abstract" headings are in bold + italic. This is how IEEE does things. + +11) \thebibliography and \biography now put entries into + the table of contents for you. + +******* + + + + + + + ******* + 9/2000 (JVH) changes: (now designated as V1.2) + + made some corrections to get closer to LaTeX2e + 20000906 Juergen v.Hagen + vonhagen@ihefiji.etec.uni-karlsruhe.de + + Permission to redistribute granted as of December 2000. + ******* + + + + + + ******* + + 1996 (JWD) LaTeX2e version: (now designated as V1.1) + + In the most recent TeXhax digest, there was a request for a copy of + IEEEtrans.sty modified to work with LaTeX2e. I have a version I + modified to make it IEEEtrans.cls, which I have sent to the person + making the request and am now sending to you to consider posting to + the archives. + -- + Jon Dixon + dixonj@colorado.edu + http://spot.colorado.edu/~dixonj/ + +******* + + + + + +******* + + 30-August-1993 original LaTeX 2.09 version (IEEEtran.sty), + (now designated as V1.0): + + by Gerry Murray and Silvano Balemi + Automatic Control Lab, ETH Zurich, Switzerland + balemi@aut.ee.ethz.ch + +******* + + + diff --git a/fig/avg_eq-eps-converted-to.pdf b/fig/avg_eq-eps-converted-to.pdf new file mode 100644 index 0000000000000000000000000000000000000000..39c3fd5022d74720c2d7fe18617321bf58a03123 GIT binary patch literal 7636 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 literal 0 HcmV?d00001 diff --git a/fig/avg_eq.eps b/fig/avg_eq.eps new file mode 100644 index 0000000..143d971 --- /dev/null +++ b/fig/avg_eq.eps @@ -0,0 +1,756 @@ +%!PS-Adobe-2.0 EPSF-2.0 +%%Title: avg_eq.eps +%%Creator: gnuplot 4.6 patchlevel 0 +%%CreationDate: Fri Oct 17 16:11:14 2014 +%%DocumentFonts: (atend) +%%BoundingBox: 50 50 320 239 +%%EndComments +%%BeginProlog +/gnudict 256 dict def +gnudict begin +% +% The following true/false flags may be edited by hand if desired. +% The unit line width and grayscale image gamma correction may also be changed. +% +/Color false def +/Blacktext false def +/Solid false def +/Dashlength 1 def +/Landscape false def +/Level1 false def +/Rounded false def +/ClipToBoundingBox false def +/SuppressPDFMark false def +/TransparentPatterns false def +/gnulinewidth 5.000 def +/userlinewidth gnulinewidth def +/Gamma 1.0 def +/BackgroundColor {-1.000 -1.000 -1.000} def +% +/vshift -46 def +/dl1 { + 10.0 Dashlength mul mul + Rounded { currentlinewidth 0.75 mul sub dup 0 le { pop 0.01 } if } if +} def +/dl2 { + 10.0 Dashlength mul mul + Rounded { currentlinewidth 0.75 mul add } if +} def +/hpt_ 31.5 def +/vpt_ 31.5 def +/hpt hpt_ def +/vpt vpt_ def +/doclip { + ClipToBoundingBox { + newpath 50 50 moveto 320 50 lineto 320 239 lineto 50 239 lineto closepath + clip + } if +} def +% +% Gnuplot Prolog Version 4.4 (August 2010) +% +%/SuppressPDFMark true def +% +/M {moveto} bind def +/L {lineto} bind def +/R {rmoveto} bind def +/V {rlineto} bind def +/N {newpath moveto} bind def +/Z {closepath} bind def +/C {setrgbcolor} bind def +/f {rlineto fill} bind def +/g {setgray} bind def +/Gshow {show} def % May be redefined later in the file to support UTF-8 +/vpt2 vpt 2 mul def +/hpt2 hpt 2 mul def +/Lshow {currentpoint stroke M 0 vshift R + Blacktext {gsave 0 setgray show grestore} {show} ifelse} def +/Rshow {currentpoint stroke M dup stringwidth pop neg vshift R + Blacktext {gsave 0 setgray show grestore} {show} ifelse} def +/Cshow {currentpoint stroke M dup stringwidth pop -2 div vshift R + Blacktext {gsave 0 setgray show grestore} {show} ifelse} def +/UP {dup vpt_ mul /vpt exch def hpt_ mul /hpt exch def + /hpt2 hpt 2 mul def /vpt2 vpt 2 mul def} def +/DL {Color {setrgbcolor Solid {pop []} if 0 setdash} + {pop pop pop 0 setgray Solid {pop []} if 0 setdash} ifelse} def +/BL {stroke userlinewidth 2 mul setlinewidth + Rounded {1 setlinejoin 1 setlinecap} if} def +/AL {stroke userlinewidth 2 div setlinewidth + Rounded {1 setlinejoin 1 setlinecap} if} def +/UL {dup gnulinewidth mul /userlinewidth exch def + dup 1 lt {pop 1} if 10 mul /udl exch def} def +/PL {stroke userlinewidth setlinewidth + Rounded {1 setlinejoin 1 setlinecap} if} def +3.8 setmiterlimit +% Default Line colors +/LCw {1 1 1} def +/LCb {0 0 0} def +/LCa {0 0 0} def +/LC0 {1 0 0} def +/LC1 {0 1 0} def +/LC2 {0 0 1} def +/LC3 {1 0 1} def +/LC4 {0 1 1} def +/LC5 {1 1 0} def +/LC6 {0 0 0} def +/LC7 {1 0.3 0} def +/LC8 {0.5 0.5 0.5} def +% Default Line Types +/LTw {PL [] 1 setgray} def +/LTb {BL [] LCb DL} def +/LTa {AL [1 udl mul 2 udl mul] 0 setdash LCa setrgbcolor} def +/LT0 {PL [] LC0 DL} def +/LT1 {PL [4 dl1 2 dl2] LC1 DL} def +/LT2 {PL [2 dl1 3 dl2] LC2 DL} def +/LT3 {PL [1 dl1 1.5 dl2] LC3 DL} def +/LT4 {PL [6 dl1 2 dl2 1 dl1 2 dl2] LC4 DL} def +/LT5 {PL [3 dl1 3 dl2 1 dl1 3 dl2] LC5 DL} def +/LT6 {PL [2 dl1 2 dl2 2 dl1 6 dl2] LC6 DL} def +/LT7 {PL [1 dl1 2 dl2 6 dl1 2 dl2 1 dl1 2 dl2] LC7 DL} def +/LT8 {PL [2 dl1 2 dl2 2 dl1 2 dl2 2 dl1 2 dl2 2 dl1 4 dl2] LC8 DL} def +/Pnt {stroke [] 0 setdash gsave 1 setlinecap M 0 0 V stroke grestore} def +/Dia {stroke [] 0 setdash 2 copy vpt add M + hpt neg vpt neg V hpt vpt neg V + hpt vpt V hpt neg vpt V closepath stroke + Pnt} def +/Pls {stroke [] 0 setdash vpt sub M 0 vpt2 V + currentpoint stroke M + hpt neg vpt neg R hpt2 0 V stroke + } def +/Box {stroke [] 0 setdash 2 copy exch hpt sub exch vpt add M + 0 vpt2 neg V hpt2 0 V 0 vpt2 V + hpt2 neg 0 V closepath stroke + Pnt} def +/Crs {stroke [] 0 setdash exch hpt sub exch vpt add M + hpt2 vpt2 neg V currentpoint stroke M + hpt2 neg 0 R hpt2 vpt2 V stroke} def +/TriU {stroke [] 0 setdash 2 copy vpt 1.12 mul add M + hpt neg vpt -1.62 mul V + hpt 2 mul 0 V + hpt neg vpt 1.62 mul V closepath stroke + Pnt} def +/Star {2 copy Pls Crs} def +/BoxF {stroke [] 0 setdash exch hpt sub exch vpt add M + 0 vpt2 neg V hpt2 0 V 0 vpt2 V + hpt2 neg 0 V closepath fill} def +/TriUF {stroke [] 0 setdash vpt 1.12 mul add M + hpt neg vpt -1.62 mul V + hpt 2 mul 0 V + hpt neg vpt 1.62 mul V closepath fill} def +/TriD {stroke [] 0 setdash 2 copy vpt 1.12 mul sub M + hpt neg vpt 1.62 mul V + hpt 2 mul 0 V + hpt neg vpt -1.62 mul V closepath stroke + Pnt} def +/TriDF {stroke [] 0 setdash vpt 1.12 mul sub M + hpt neg vpt 1.62 mul V + hpt 2 mul 0 V + hpt neg vpt -1.62 mul V closepath fill} def +/DiaF {stroke [] 0 setdash vpt add M + hpt neg vpt neg V hpt vpt neg V + hpt vpt V hpt neg vpt V closepath fill} def +/Pent {stroke [] 0 setdash 2 copy gsave + translate 0 hpt M 4 {72 rotate 0 hpt L} repeat + closepath stroke grestore Pnt} def +/PentF {stroke [] 0 setdash gsave + translate 0 hpt M 4 {72 rotate 0 hpt L} repeat + closepath fill grestore} def +/Circle {stroke [] 0 setdash 2 copy + hpt 0 360 arc stroke Pnt} def +/CircleF {stroke [] 0 setdash hpt 0 360 arc fill} def +/C0 {BL [] 0 setdash 2 copy moveto vpt 90 450 arc} bind def +/C1 {BL [] 0 setdash 2 copy moveto + 2 copy vpt 0 90 arc closepath fill + vpt 0 360 arc closepath} bind def +/C2 {BL [] 0 setdash 2 copy moveto + 2 copy vpt 90 180 arc closepath fill + vpt 0 360 arc closepath} bind def +/C3 {BL [] 0 setdash 2 copy moveto + 2 copy vpt 0 180 arc closepath fill + vpt 0 360 arc closepath} bind def +/C4 {BL [] 0 setdash 2 copy moveto + 2 copy vpt 180 270 arc closepath fill + vpt 0 360 arc closepath} bind def +/C5 {BL [] 0 setdash 2 copy moveto + 2 copy vpt 0 90 arc + 2 copy moveto + 2 copy vpt 180 270 arc closepath fill + vpt 0 360 arc} bind def +/C6 {BL [] 0 setdash 2 copy moveto + 2 copy vpt 90 270 arc closepath fill + vpt 0 360 arc closepath} bind def +/C7 {BL [] 0 setdash 2 copy moveto + 2 copy vpt 0 270 arc closepath fill + vpt 0 360 arc closepath} bind def +/C8 {BL [] 0 setdash 2 copy moveto + 2 copy vpt 270 360 arc closepath fill + vpt 0 360 arc closepath} bind def +/C9 {BL [] 0 setdash 2 copy moveto + 2 copy vpt 270 450 arc closepath fill + vpt 0 360 arc closepath} bind def +/C10 {BL [] 0 setdash 2 copy 2 copy moveto vpt 270 360 arc closepath fill + 2 copy moveto + 2 copy vpt 90 180 arc closepath fill + vpt 0 360 arc closepath} bind def +/C11 {BL [] 0 setdash 2 copy moveto + 2 copy vpt 0 180 arc closepath fill + 2 copy moveto + 2 copy vpt 270 360 arc closepath fill + vpt 0 360 arc closepath} bind def +/C12 {BL [] 0 setdash 2 copy moveto + 2 copy vpt 180 360 arc closepath fill + vpt 0 360 arc closepath} bind def +/C13 {BL [] 0 setdash 2 copy moveto + 2 copy vpt 0 90 arc closepath fill + 2 copy moveto + 2 copy vpt 180 360 arc closepath fill + vpt 0 360 arc closepath} bind def +/C14 {BL [] 0 setdash 2 copy moveto + 2 copy vpt 90 360 arc closepath fill + vpt 0 360 arc} bind def +/C15 {BL [] 0 setdash 2 copy vpt 0 360 arc closepath fill + vpt 0 360 arc closepath} bind def +/Rec {newpath 4 2 roll moveto 1 index 0 rlineto 0 exch rlineto + neg 0 rlineto closepath} bind def +/Square {dup Rec} bind def +/Bsquare {vpt sub exch vpt sub exch vpt2 Square} bind def +/S0 {BL [] 0 setdash 2 copy moveto 0 vpt rlineto BL Bsquare} bind def +/S1 {BL [] 0 setdash 2 copy vpt Square fill Bsquare} bind def +/S2 {BL [] 0 setdash 2 copy exch vpt sub exch vpt Square fill Bsquare} bind def +/S3 {BL [] 0 setdash 2 copy exch vpt sub exch vpt2 vpt Rec fill Bsquare} bind def +/S4 {BL [] 0 setdash 2 copy exch vpt sub exch vpt sub vpt Square fill Bsquare} bind def +/S5 {BL [] 0 setdash 2 copy 2 copy vpt Square fill + exch vpt sub exch vpt sub vpt Square fill Bsquare} bind def +/S6 {BL [] 0 setdash 2 copy exch vpt sub exch vpt sub vpt vpt2 Rec fill Bsquare} bind def +/S7 {BL [] 0 setdash 2 copy exch vpt sub exch vpt sub vpt vpt2 Rec fill + 2 copy vpt Square fill Bsquare} bind def +/S8 {BL [] 0 setdash 2 copy vpt sub vpt Square fill Bsquare} bind def +/S9 {BL [] 0 setdash 2 copy vpt sub vpt vpt2 Rec fill Bsquare} bind def +/S10 {BL [] 0 setdash 2 copy vpt sub vpt Square fill 2 copy exch vpt sub exch vpt Square fill + Bsquare} bind def +/S11 {BL [] 0 setdash 2 copy vpt sub vpt Square fill 2 copy exch vpt sub exch vpt2 vpt Rec fill + Bsquare} bind def +/S12 {BL [] 0 setdash 2 copy exch vpt sub exch vpt sub vpt2 vpt Rec fill Bsquare} bind def +/S13 {BL [] 0 setdash 2 copy exch vpt sub exch vpt sub vpt2 vpt Rec fill + 2 copy vpt Square fill Bsquare} bind def +/S14 {BL [] 0 setdash 2 copy exch vpt sub exch vpt sub vpt2 vpt Rec fill + 2 copy exch vpt sub exch vpt Square fill Bsquare} bind def +/S15 {BL [] 0 setdash 2 copy Bsquare fill Bsquare} bind def +/D0 {gsave translate 45 rotate 0 0 S0 stroke grestore} bind def +/D1 {gsave translate 45 rotate 0 0 S1 stroke grestore} bind def +/D2 {gsave translate 45 rotate 0 0 S2 stroke grestore} bind def +/D3 {gsave translate 45 rotate 0 0 S3 stroke grestore} bind def +/D4 {gsave translate 45 rotate 0 0 S4 stroke grestore} bind def +/D5 {gsave translate 45 rotate 0 0 S5 stroke grestore} bind def +/D6 {gsave translate 45 rotate 0 0 S6 stroke grestore} bind def +/D7 {gsave translate 45 rotate 0 0 S7 stroke grestore} bind def +/D8 {gsave translate 45 rotate 0 0 S8 stroke grestore} bind def +/D9 {gsave translate 45 rotate 0 0 S9 stroke grestore} bind def +/D10 {gsave translate 45 rotate 0 0 S10 stroke grestore} bind def +/D11 {gsave translate 45 rotate 0 0 S11 stroke grestore} bind def +/D12 {gsave translate 45 rotate 0 0 S12 stroke grestore} bind def +/D13 {gsave translate 45 rotate 0 0 S13 stroke grestore} bind def +/D14 {gsave translate 45 rotate 0 0 S14 stroke grestore} bind def +/D15 {gsave translate 45 rotate 0 0 S15 stroke grestore} bind def +/DiaE {stroke [] 0 setdash vpt add M + hpt neg vpt neg V hpt vpt neg V + hpt vpt V hpt neg vpt V closepath stroke} def +/BoxE {stroke [] 0 setdash exch hpt sub exch vpt add M + 0 vpt2 neg V hpt2 0 V 0 vpt2 V + hpt2 neg 0 V closepath stroke} def +/TriUE {stroke [] 0 setdash vpt 1.12 mul add M + hpt neg vpt -1.62 mul V + hpt 2 mul 0 V + hpt neg vpt 1.62 mul V closepath stroke} def +/TriDE {stroke [] 0 setdash vpt 1.12 mul sub M + hpt neg vpt 1.62 mul V + hpt 2 mul 0 V + hpt neg vpt -1.62 mul V closepath stroke} def +/PentE {stroke [] 0 setdash gsave + translate 0 hpt M 4 {72 rotate 0 hpt L} repeat + closepath stroke grestore} def +/CircE {stroke [] 0 setdash + hpt 0 360 arc stroke} def +/Opaque {gsave closepath 1 setgray fill grestore 0 setgray closepath} def +/DiaW {stroke [] 0 setdash vpt add M + hpt neg vpt neg V hpt vpt neg V + hpt vpt V hpt neg vpt V Opaque stroke} def +/BoxW {stroke [] 0 setdash exch hpt sub exch vpt add M + 0 vpt2 neg V hpt2 0 V 0 vpt2 V + hpt2 neg 0 V Opaque stroke} def +/TriUW {stroke [] 0 setdash vpt 1.12 mul add M + hpt neg vpt -1.62 mul V + hpt 2 mul 0 V + hpt neg vpt 1.62 mul V Opaque stroke} def +/TriDW {stroke [] 0 setdash vpt 1.12 mul sub M + hpt neg vpt 1.62 mul V + hpt 2 mul 0 V + hpt neg vpt -1.62 mul V Opaque stroke} def +/PentW {stroke [] 0 setdash gsave + translate 0 hpt M 4 {72 rotate 0 hpt L} repeat + Opaque stroke grestore} def +/CircW {stroke [] 0 setdash + hpt 0 360 arc Opaque stroke} def +/BoxFill {gsave Rec 1 setgray fill grestore} def +/Density { + /Fillden exch def + currentrgbcolor + /ColB exch def /ColG exch def /ColR exch def + /ColR ColR Fillden mul Fillden sub 1 add def + /ColG ColG Fillden mul Fillden sub 1 add def + /ColB ColB Fillden mul Fillden sub 1 add def + ColR ColG ColB setrgbcolor} def +/BoxColFill {gsave Rec PolyFill} def +/PolyFill {gsave Density fill grestore grestore} def +/h {rlineto rlineto rlineto gsave closepath fill grestore} bind def +% +% PostScript Level 1 Pattern Fill routine for rectangles +% Usage: x y w h s a XX PatternFill +% x,y = lower left corner of box to be filled +% w,h = width and height of box +% a = angle in degrees between lines and x-axis +% XX = 0/1 for no/yes cross-hatch +% +/PatternFill {gsave /PFa [ 9 2 roll ] def + PFa 0 get PFa 2 get 2 div add PFa 1 get PFa 3 get 2 div add translate + PFa 2 get -2 div PFa 3 get -2 div PFa 2 get PFa 3 get Rec + gsave 1 setgray fill grestore clip + currentlinewidth 0.5 mul setlinewidth + /PFs PFa 2 get dup mul PFa 3 get dup mul add sqrt def + 0 0 M PFa 5 get rotate PFs -2 div dup translate + 0 1 PFs PFa 4 get div 1 add floor cvi + {PFa 4 get mul 0 M 0 PFs V} for + 0 PFa 6 get ne { + 0 1 PFs PFa 4 get div 1 add floor cvi + {PFa 4 get mul 0 2 1 roll M PFs 0 V} for + } if + stroke grestore} def +% +/languagelevel where + {pop languagelevel} {1} ifelse + 2 lt + {/InterpretLevel1 true def} + {/InterpretLevel1 Level1 def} + ifelse +% +% PostScript level 2 pattern fill definitions +% +/Level2PatternFill { +/Tile8x8 {/PaintType 2 /PatternType 1 /TilingType 1 /BBox [0 0 8 8] /XStep 8 /YStep 8} + bind def +/KeepColor {currentrgbcolor [/Pattern /DeviceRGB] setcolorspace} bind def +<< Tile8x8 + /PaintProc {0.5 setlinewidth pop 0 0 M 8 8 L 0 8 M 8 0 L stroke} +>> matrix makepattern +/Pat1 exch def +<< Tile8x8 + /PaintProc {0.5 setlinewidth pop 0 0 M 8 8 L 0 8 M 8 0 L stroke + 0 4 M 4 8 L 8 4 L 4 0 L 0 4 L stroke} +>> matrix makepattern +/Pat2 exch def +<< Tile8x8 + /PaintProc {0.5 setlinewidth pop 0 0 M 0 8 L + 8 8 L 8 0 L 0 0 L fill} +>> matrix makepattern +/Pat3 exch def +<< Tile8x8 + /PaintProc {0.5 setlinewidth pop -4 8 M 8 -4 L + 0 12 M 12 0 L stroke} +>> matrix makepattern +/Pat4 exch def +<< Tile8x8 + /PaintProc {0.5 setlinewidth pop -4 0 M 8 12 L + 0 -4 M 12 8 L stroke} +>> matrix makepattern +/Pat5 exch def +<< Tile8x8 + /PaintProc {0.5 setlinewidth pop -2 8 M 4 -4 L + 0 12 M 8 -4 L 4 12 M 10 0 L stroke} +>> matrix makepattern +/Pat6 exch def +<< Tile8x8 + /PaintProc {0.5 setlinewidth pop -2 0 M 4 12 L + 0 -4 M 8 12 L 4 -4 M 10 8 L stroke} +>> matrix makepattern +/Pat7 exch def +<< Tile8x8 + /PaintProc {0.5 setlinewidth pop 8 -2 M -4 4 L + 12 0 M -4 8 L 12 4 M 0 10 L stroke} +>> matrix makepattern +/Pat8 exch def +<< Tile8x8 + /PaintProc {0.5 setlinewidth pop 0 -2 M 12 4 L + -4 0 M 12 8 L -4 4 M 8 10 L stroke} +>> matrix makepattern +/Pat9 exch def +/Pattern1 {PatternBgnd KeepColor Pat1 setpattern} bind def +/Pattern2 {PatternBgnd KeepColor Pat2 setpattern} bind def +/Pattern3 {PatternBgnd KeepColor Pat3 setpattern} bind def +/Pattern4 {PatternBgnd KeepColor Landscape {Pat5} {Pat4} ifelse setpattern} bind def +/Pattern5 {PatternBgnd KeepColor Landscape {Pat4} {Pat5} ifelse setpattern} bind def +/Pattern6 {PatternBgnd KeepColor Landscape {Pat9} {Pat6} ifelse setpattern} bind def +/Pattern7 {PatternBgnd KeepColor Landscape {Pat8} {Pat7} ifelse setpattern} bind def +} def +% +% +%End of PostScript Level 2 code +% +/PatternBgnd { + TransparentPatterns {} {gsave 1 setgray fill grestore} ifelse +} def +% +% Substitute for Level 2 pattern fill codes with +% grayscale if Level 2 support is not selected. +% +/Level1PatternFill { +/Pattern1 {0.250 Density} bind def +/Pattern2 {0.500 Density} bind def +/Pattern3 {0.750 Density} bind def +/Pattern4 {0.125 Density} bind def +/Pattern5 {0.375 Density} bind def +/Pattern6 {0.625 Density} bind def +/Pattern7 {0.875 Density} bind def +} def +% +% Now test for support of Level 2 code +% +Level1 {Level1PatternFill} {Level2PatternFill} ifelse +% +/Symbol-Oblique /Symbol findfont [1 0 .167 1 0 0] makefont +dup length dict begin {1 index /FID eq {pop pop} {def} ifelse} forall +currentdict end definefont pop +Level1 SuppressPDFMark or +{} { +/SDict 10 dict def +systemdict /pdfmark known not { + userdict /pdfmark systemdict /cleartomark get put +} if +SDict begin [ + /Title (avg_eq.eps) + /Subject (gnuplot plot) + /Creator (gnuplot 4.6 patchlevel 0) + /Author (afanfakh) +% /Producer (gnuplot) +% /Keywords () + /CreationDate (Fri Oct 17 16:11:14 2014) + /DOCINFO pdfmark +end +} ifelse +end +%%EndProlog +%%Page: 1 1 +gnudict begin +gsave +doclip +50 50 translate +0.050 0.050 scale +0 setgray +newpath +(Helvetica) findfont 140 scalefont setfont +BackgroundColor 0 lt 3 1 roll 0 lt exch 0 lt or or not {BackgroundColor C 1.000 0 0 5400.00 3780.00 BoxColFill} if +1.000 UL +LTb +602 588 M +63 0 V +4482 0 R +-63 0 V +/Helvetica findfont 190 scalefont setfont +518 588 M +( 0) Rshow +/Helvetica findfont 140 scalefont setfont +1.000 UL +LTb +602 966 M +63 0 V +4482 0 R +-63 0 V +/Helvetica findfont 190 scalefont setfont +518 966 M +( 5) Rshow +/Helvetica findfont 140 scalefont setfont +1.000 UL +LTb +602 1344 M +63 0 V +4482 0 R +-63 0 V +/Helvetica findfont 190 scalefont setfont +-4566 0 R +( 10) Rshow +/Helvetica findfont 140 scalefont setfont +1.000 UL +LTb +602 1722 M +63 0 V +4482 0 R +-63 0 V +/Helvetica findfont 190 scalefont setfont +-4566 0 R +( 15) Rshow +/Helvetica findfont 140 scalefont setfont +1.000 UL +LTb +602 2100 M +63 0 V +4482 0 R +-63 0 V +/Helvetica findfont 190 scalefont setfont +-4566 0 R +( 20) Rshow +/Helvetica findfont 140 scalefont setfont +1.000 UL +LTb +602 2477 M +63 0 V +4482 0 R +-63 0 V +/Helvetica findfont 190 scalefont setfont +-4566 0 R +( 25) Rshow +/Helvetica findfont 140 scalefont setfont +1.000 UL +LTb +602 2855 M +63 0 V +4482 0 R +-63 0 V +/Helvetica findfont 190 scalefont setfont +-4566 0 R +( 30) Rshow +/Helvetica findfont 140 scalefont setfont +1.000 UL +LTb +602 3233 M +63 0 V +4482 0 R +-63 0 V +/Helvetica findfont 190 scalefont setfont +-4566 0 R +( 35) Rshow +/Helvetica findfont 140 scalefont setfont +1.000 UL +LTb +602 3611 M +63 0 V +4482 0 R +-63 0 V +/Helvetica findfont 190 scalefont setfont +-4566 0 R +( 40) Rshow +/Helvetica findfont 140 scalefont setfont +1.000 UL +LTb +604 588 M +0 63 V +0 2960 R +0 -63 V +/Helvetica findfont 190 scalefont setfont +604 448 M +( 0) Cshow +/Helvetica findfont 140 scalefont setfont +1.000 UL +LTb +1142 588 M +0 63 V +0 2960 R +0 -63 V +/Helvetica findfont 190 scalefont setfont +0 -3100 R +( 16) Cshow +/Helvetica findfont 140 scalefont setfont +1.000 UL +LTb +1680 588 M +0 63 V +0 2960 R +0 -63 V +/Helvetica findfont 190 scalefont setfont +0 -3100 R +( 32) Cshow +/Helvetica findfont 140 scalefont setfont +1.000 UL +LTb +2218 588 M +0 63 V +0 2960 R +0 -63 V +/Helvetica findfont 190 scalefont setfont +0 -3100 R +( 48) Cshow +/Helvetica findfont 140 scalefont setfont +1.000 UL +LTb +2757 588 M +0 63 V +0 2960 R +0 -63 V +/Helvetica findfont 190 scalefont setfont +0 -3100 R +( 64) Cshow +/Helvetica findfont 140 scalefont setfont +1.000 UL +LTb +3295 588 M +0 63 V +0 2960 R +0 -63 V +/Helvetica findfont 190 scalefont setfont +0 -3100 R +( 80) Cshow +/Helvetica findfont 140 scalefont setfont +1.000 UL +LTb +3833 588 M +0 63 V +0 2960 R +0 -63 V +/Helvetica findfont 190 scalefont setfont +0 -3100 R +( 96) Cshow +/Helvetica findfont 140 scalefont setfont +1.000 UL +LTb +4372 588 M +0 63 V +0 2960 R +0 -63 V +/Helvetica findfont 190 scalefont setfont +0 -3100 R +( 112) Cshow +/Helvetica findfont 140 scalefont setfont +1.000 UL +LTb +4910 588 M +0 63 V +0 2960 R +0 -63 V +/Helvetica findfont 190 scalefont setfont +0 -3100 R +( 128) Cshow +/Helvetica findfont 140 scalefont setfont +1.000 UL +LTb +1.000 UL +LTb +602 3611 N +602 588 L +4545 0 V +0 3023 V +-4545 0 V +Z stroke +LCb setrgbcolor +/Helvetica findfont 210 scalefont setfont +112 2099 M +currentpoint gsave translate -270 rotate 0 0 M +(The average ) Cshow +grestore +/Helvetica findfont 140 scalefont setfont +LTb +LCb setrgbcolor +/Helvetica findfont 210 scalefont setfont +2974 98 M +( Number of nodes) Cshow +/Helvetica findfont 140 scalefont setfont +LTb +1.000 UP +/Helvetica findfont 190 scalefont setfont +654 622 M +( ) Lshow +/Helvetica findfont 140 scalefont setfont +1.000 UL +LTb +% Begin plot #1 +1.500 UP +2.000 UL +LT0 +0.00 0.00 1.00 C LCb setrgbcolor +/Helvetica findfont 190 scalefont setfont +4496 3443 M +(Performance degradation) Rshow +/Helvetica findfont 140 scalefont setfont +LT0 +0.00 0.00 1.00 C 4580 3443 M +399 0 V +738 909 M +873 839 L +269 191 V +1680 883 L +1077 124 V +4910 841 L +738 909 Box +873 839 Box +1142 1030 Box +1680 883 Box +2757 1007 Box +4910 841 Box +4779 3443 Box +% End plot #1 +% Begin plot #2 +1.500 UP +2.000 UL +LT0 +1.00 0.00 0.00 C LCb setrgbcolor +/Helvetica findfont 190 scalefont setfont +4496 3233 M +(Energy saving) Rshow +/Helvetica findfont 140 scalefont setfont +LT0 +1.00 0.00 0.00 C 4580 3233 M +399 0 V +738 3096 M +873 2875 L +269 -80 V +538 -412 V +2757 2200 L +4910 1788 L +738 3096 Crs +873 2875 Crs +1142 2795 Crs +1680 2383 Crs +2757 2200 Crs +4910 1788 Crs +4779 3233 Crs +% End plot #2 +% Begin plot #3 +1.500 UP +2.000 UL +LT0 +0.00 0.39 0.00 C LCb setrgbcolor +/Helvetica findfont 190 scalefont setfont +4496 3023 M +(Distance) Rshow +/Helvetica findfont 140 scalefont setfont +LT0 +0.00 0.39 0.00 C 4580 3023 M +399 0 V +738 2775 M +873 2625 L +269 -272 V +538 -265 V +2757 1781 L +4910 1536 L +738 2775 Star +873 2625 Star +1142 2353 Star +1680 2088 Star +2757 1781 Star +4910 1536 Star +4779 3023 Star +% End plot #3 +1.000 UL +LTb +602 3611 N +602 588 L +4545 0 V +0 3023 V +-4545 0 V +Z stroke +1.000 UP +1.000 UL +LTb +stroke +grestore +end +showpage +%%Trailer +%%DocumentFonts: Helvetica diff --git a/fig/avg_neq-eps-converted-to.pdf b/fig/avg_neq-eps-converted-to.pdf new file mode 100644 index 0000000000000000000000000000000000000000..22b5196f6c1b0168aac104eca3b06a967806b018 GIT binary patch literal 7646 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 matrix makepattern +/Pat1 exch def +<< Tile8x8 + /PaintProc {0.5 setlinewidth pop 0 0 M 8 8 L 0 8 M 8 0 L stroke + 0 4 M 4 8 L 8 4 L 4 0 L 0 4 L stroke} +>> matrix makepattern +/Pat2 exch def +<< Tile8x8 + /PaintProc {0.5 setlinewidth pop 0 0 M 0 8 L + 8 8 L 8 0 L 0 0 L fill} +>> matrix makepattern +/Pat3 exch def +<< Tile8x8 + /PaintProc {0.5 setlinewidth pop -4 8 M 8 -4 L + 0 12 M 12 0 L stroke} +>> matrix makepattern +/Pat4 exch def +<< Tile8x8 + /PaintProc {0.5 setlinewidth pop -4 0 M 8 12 L + 0 -4 M 12 8 L stroke} +>> matrix makepattern +/Pat5 exch def +<< Tile8x8 + /PaintProc {0.5 setlinewidth pop -2 8 M 4 -4 L + 0 12 M 8 -4 L 4 12 M 10 0 L stroke} +>> matrix makepattern +/Pat6 exch def +<< Tile8x8 + /PaintProc {0.5 setlinewidth pop -2 0 M 4 12 L + 0 -4 M 8 12 L 4 -4 M 10 8 L stroke} +>> matrix makepattern +/Pat7 exch def +<< Tile8x8 + /PaintProc {0.5 setlinewidth pop 8 -2 M -4 4 L + 12 0 M -4 8 L 12 4 M 0 10 L stroke} +>> matrix makepattern +/Pat8 exch def +<< Tile8x8 + /PaintProc {0.5 setlinewidth pop 0 -2 M 12 4 L + -4 0 M 12 8 L -4 4 M 8 10 L stroke} +>> matrix makepattern +/Pat9 exch def +/Pattern1 {PatternBgnd KeepColor Pat1 setpattern} bind def +/Pattern2 {PatternBgnd KeepColor Pat2 setpattern} bind def +/Pattern3 {PatternBgnd KeepColor Pat3 setpattern} bind def +/Pattern4 {PatternBgnd KeepColor Landscape {Pat5} {Pat4} ifelse setpattern} bind def +/Pattern5 {PatternBgnd KeepColor Landscape {Pat4} {Pat5} ifelse setpattern} bind def +/Pattern6 {PatternBgnd KeepColor Landscape {Pat9} {Pat6} ifelse setpattern} bind def +/Pattern7 {PatternBgnd KeepColor Landscape {Pat8} {Pat7} ifelse setpattern} bind def +} def +% +% +%End of PostScript Level 2 code +% +/PatternBgnd { + TransparentPatterns {} {gsave 1 setgray fill grestore} ifelse +} def +% +% Substitute for Level 2 pattern fill codes with +% grayscale if Level 2 support is not selected. +% +/Level1PatternFill { +/Pattern1 {0.250 Density} bind def +/Pattern2 {0.500 Density} bind def +/Pattern3 {0.750 Density} bind def +/Pattern4 {0.125 Density} bind def +/Pattern5 {0.375 Density} bind def +/Pattern6 {0.625 Density} bind def +/Pattern7 {0.875 Density} bind def +} def +% +% Now test for support of Level 2 code +% +Level1 {Level1PatternFill} {Level2PatternFill} ifelse +% +/Symbol-Oblique /Symbol findfont [1 0 .167 1 0 0] makefont +dup length dict begin {1 index /FID eq {pop pop} {def} ifelse} forall +currentdict end definefont pop +Level1 SuppressPDFMark or +{} { +/SDict 10 dict def +systemdict /pdfmark known not { + userdict /pdfmark systemdict /cleartomark get put +} if +SDict begin [ + /Title (avg_neq.eps) + /Subject (gnuplot plot) + /Creator (gnuplot 4.6 patchlevel 0) + /Author (afanfakh) +% /Producer (gnuplot) +% /Keywords () + /CreationDate (Fri Oct 17 16:12:05 2014) + /DOCINFO pdfmark +end +} ifelse +end +%%EndProlog +%%Page: 1 1 +gnudict begin +gsave +doclip +50 50 translate +0.050 0.050 scale +0 setgray +newpath +(Helvetica) findfont 140 scalefont setfont +BackgroundColor 0 lt 3 1 roll 0 lt exch 0 lt or or not {BackgroundColor C 1.000 0 0 5400.00 3780.00 BoxColFill} if +1.000 UL +LTb +602 588 M +63 0 V +4482 0 R +-63 0 V +/Helvetica findfont 190 scalefont setfont +518 588 M +( 0) Rshow +/Helvetica findfont 140 scalefont setfont +1.000 UL +LTb +602 966 M +63 0 V +4482 0 R +-63 0 V +/Helvetica findfont 190 scalefont setfont +518 966 M +( 5) Rshow +/Helvetica findfont 140 scalefont setfont +1.000 UL +LTb +602 1344 M +63 0 V +4482 0 R +-63 0 V +/Helvetica findfont 190 scalefont setfont +-4566 0 R +( 10) Rshow +/Helvetica findfont 140 scalefont setfont +1.000 UL +LTb +602 1722 M +63 0 V +4482 0 R +-63 0 V +/Helvetica findfont 190 scalefont setfont +-4566 0 R +( 15) Rshow +/Helvetica findfont 140 scalefont setfont +1.000 UL +LTb +602 2100 M +63 0 V +4482 0 R +-63 0 V +/Helvetica findfont 190 scalefont setfont +-4566 0 R +( 20) Rshow +/Helvetica findfont 140 scalefont setfont +1.000 UL +LTb +602 2477 M +63 0 V +4482 0 R +-63 0 V +/Helvetica findfont 190 scalefont setfont +-4566 0 R +( 25) Rshow +/Helvetica findfont 140 scalefont setfont +1.000 UL +LTb +602 2855 M +63 0 V +4482 0 R +-63 0 V +/Helvetica findfont 190 scalefont setfont +-4566 0 R +( 30) Rshow +/Helvetica findfont 140 scalefont setfont +1.000 UL +LTb +602 3233 M +63 0 V +4482 0 R +-63 0 V +/Helvetica findfont 190 scalefont setfont +-4566 0 R +( 35) Rshow +/Helvetica findfont 140 scalefont setfont +1.000 UL +LTb +602 3611 M +63 0 V +4482 0 R +-63 0 V +/Helvetica findfont 190 scalefont setfont +-4566 0 R +( 40) Rshow +/Helvetica findfont 140 scalefont setfont +1.000 UL +LTb +603 588 M +0 63 V +0 2960 R +0 -63 V +/Helvetica findfont 190 scalefont setfont +603 448 M +( 0) Cshow +/Helvetica findfont 140 scalefont setfont +1.000 UL +LTb +1072 588 M +0 63 V +0 2960 R +0 -63 V +/Helvetica findfont 190 scalefont setfont +0 -3100 R +( 16) Cshow +/Helvetica findfont 140 scalefont setfont +1.000 UL +LTb +1541 588 M +0 63 V +0 2960 R +0 -63 V +/Helvetica findfont 190 scalefont setfont +0 -3100 R +( 32) Cshow +/Helvetica findfont 140 scalefont setfont +1.000 UL +LTb +2010 588 M +0 63 V +0 2960 R +0 -63 V +/Helvetica findfont 190 scalefont setfont +0 -3100 R +( 48) Cshow +/Helvetica findfont 140 scalefont setfont +1.000 UL +LTb +2479 588 M +0 63 V +0 2960 R +0 -63 V +/Helvetica findfont 190 scalefont setfont +0 -3100 R +( 64) Cshow +/Helvetica findfont 140 scalefont setfont +1.000 UL +LTb +2948 588 M +0 63 V +0 2960 R +0 -63 V +/Helvetica findfont 190 scalefont setfont +0 -3100 R +( 80) Cshow +/Helvetica findfont 140 scalefont setfont +1.000 UL +LTb +3417 588 M +0 63 V +0 2960 R +0 -63 V +/Helvetica findfont 190 scalefont setfont +0 -3100 R +( 96) Cshow +/Helvetica findfont 140 scalefont setfont +1.000 UL +LTb +3885 588 M +0 63 V +0 2960 R +0 -63 V +/Helvetica findfont 190 scalefont setfont +0 -3100 R +( 112) Cshow +/Helvetica findfont 140 scalefont setfont +1.000 UL +LTb +4354 588 M +0 63 V +0 2960 R +0 -63 V +/Helvetica findfont 190 scalefont setfont +0 -3100 R +( 128) Cshow +/Helvetica findfont 140 scalefont setfont +1.000 UL +LTb +4823 588 M +0 63 V +0 2960 R +0 -63 V +/Helvetica findfont 190 scalefont setfont +0 -3100 R +( 144) Cshow +/Helvetica findfont 140 scalefont setfont +1.000 UL +LTb +1.000 UL +LTb +602 3611 N +602 588 L +4545 0 V +0 3023 V +-4545 0 V +Z stroke +LCb setrgbcolor +/Helvetica findfont 210 scalefont setfont +112 2099 M +currentpoint gsave translate -270 rotate 0 0 M +(The average) Cshow +grestore +/Helvetica findfont 140 scalefont setfont +LTb +LCb setrgbcolor +/Helvetica findfont 210 scalefont setfont +2974 98 M +( Number of nodes) Cshow +/Helvetica findfont 140 scalefont setfont +LTb +1.000 UP +/Helvetica findfont 190 scalefont setfont +647 622 M +( ) Lshow +/Helvetica findfont 140 scalefont setfont +1.000 UL +LTb +% Begin plot #1 +1.500 UP +2.000 UL +LT0 +0.00 0.00 1.00 C LCb setrgbcolor +/Helvetica findfont 190 scalefont setfont +4496 3443 M +(Performance degradation) Rshow +/Helvetica findfont 140 scalefont setfont +LT0 +0.00 0.00 1.00 C 4580 3443 M +399 0 V +721 1124 M +867 992 L +205 -40 V +586 -13 V +821 115 V +4823 638 L +721 1124 Box +867 992 Box +1072 952 Box +1658 939 Box +2479 1054 Box +4823 638 Box +4779 3443 Box +% End plot #1 +% Begin plot #2 +1.500 UP +2.000 UL +LT0 +1.00 0.00 0.00 C LCb setrgbcolor +/Helvetica findfont 190 scalefont setfont +4496 3233 M +(Energy saving) Rshow +/Helvetica findfont 140 scalefont setfont +LT0 +1.00 0.00 0.00 C 4580 3233 M +399 0 V +721 3255 M +867 2744 L +205 15 V +586 -4 V +821 -18 V +4823 2474 L +721 3255 Crs +867 2744 Crs +1072 2759 Crs +1658 2755 Crs +2479 2737 Crs +4823 2474 Crs +4779 3233 Crs +% End plot #2 +% Begin plot #3 +1.500 UP +2.000 UL +LT0 +0.00 0.39 0.00 C LCb setrgbcolor +/Helvetica findfont 190 scalefont setfont +4496 3023 M +(Distance) Rshow +/Helvetica findfont 140 scalefont setfont +LT0 +0.00 0.39 0.00 C 4580 3023 M +399 0 V +721 2719 M +867 2341 L +205 54 V +586 9 V +821 -133 V +2344 153 V +721 2719 Star +867 2341 Star +1072 2395 Star +1658 2404 Star +2479 2271 Star +4823 2424 Star +4779 3023 Star +% End plot #3 +1.000 UL +LTb +602 3611 N +602 588 L +4545 0 V +0 3023 V +-4545 0 V +Z stroke +1.000 UP +1.000 UL +LTb +stroke +grestore +end +showpage diff --git a/fig/commtasks.pdf b/fig/commtasks.pdf new file mode 100644 index 0000000000000000000000000000000000000000..5c891e9f1ae6abaf3152d4bc1086576fe4a413cd GIT binary patch literal 12818 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 C;9RW$ literal 0 HcmV?d00001 diff --git a/fig/heter-eps-converted-to.pdf b/fig/heter-eps-converted-to.pdf new file mode 100644 index 0000000000000000000000000000000000000000..5cf96d4e6075498d0acd0ceb274610aeacdf7ac9 GIT binary patch literal 6697 zcmb_h2|SeB`){+2wL}ZuUPVJ1@9bm5WSJ~wC#h>`%)A(lnQ0aVEmENyEwoS+*;*uu z_6QZ%jgm@fmkN=%soX35&O0dG`u&&B=gxe1&w0-Ce9v>9<(&6CW8}`X#}UlP7^9l5 z9fvU#2oDK@!Z4PWurtCBk%U52K=Fj_xjYFXf?#_dOM);Fwt#~$7#Oicgs{RfvW(0< zE`o=6wfLUDbS(J^+{5M4S@`#*>L66x~m?;|TRp-uKI~ntKbBQ8;-hCDALJ9Ijr91BEbu&GmW@%2b z8Fk>jkG{fQL-&Nc8VsE1uySJYedUJCn^|fNZH-Gcw`I!qNz*@WJJkB8?W1YxHZ>j- z>mAg)jAzO+$?t;1;-M_j)%{Oz_T_wF{B5tsb2U_?RZqXPrRLcMe~mEHdSl~yg~cz; z6iT8z_IDQDJsM!cYAA;9(O9Y%A9@L*1RmFuHQ4hePUJ#HMM|S>weTQ z`IGCwt;!wxYjLHydedjUnpASOrgv|@cxz>OIOBX} zJ5!l_828wzz4cx8QNO4=+wXZ?JEeKq^GV3`dc6_h_bNL~_2z(p9nESQwB@L3G zF^+}>@ZxB!p=KQuF#oW+yz9yeM}F=eTaYFoOK?PjIYgrZ1CR;+=s6G~20p>SHexoK zF@Oq!oh5WcxFMk;`+mESL>*U<3|^Ltrkf~&5>(SJ8%5l87-*zvaG~rTl zZLo*2y~?)Dv0Yh5_V{cW&$U`g#LwIg(Bj4Nv*GRq9?^Ip5_W&T*G6lJ`pas*_WS z;pa2HCEh7!%Fe0z2!gy)<(<8+;+L7}f3Fq(SX`RqA4QKdE?M9JO<^wa?8|NK`V!-$ zH7Rg!dKqmYmgeSHdePj(dCI|z6kVfwU-+F+60yeLLF+klQpuh~!^4T8bK(G4KDhDN z;?~6{(}!-jrEO9?u2!X9P9am&Xx^vO3g`Q1AE;~yeq9pspd!^EclYiJqqq}Su55mL z{ANLF4V{hYF_Epkow1N+-~8t}jQ{7UU7Rm5LSAsL_-x{iA(E5o{bM_A^cay1s#g)i zPrJgXPcn~Z&6=7-)#>sgJde7NoZxeD<=hQzC(p!32+Lm4+Eq6_4lsy0R(0TGbrvmJ zDV^Uh5+!+Co3%Z1Z}9kQ&XVZll%|sjLKmcA+55RO1Q=?GSeUVhguoN&uBAzvO~o`91${kPl#Ez7ny z<;FE*X^Zf$8Tm`stPAgbHI5p&9x`eD!`k#}q)mLSX4FkzyCIpNDS6w}Fl4UY39R5l zJhm0eIdSk!M%6)E?NCc{Zw7HADeX*nScCC(UPIaBZPz09G6VL2&$$U=Hi0tenSQ^l&+_F8 z(?Qz^jZ*kx%iZ}E&GWVuwH>%}@6np*mL~N>eS+}+aC=glrq0)d^GZ}nB0F# z!DBqXvUO?X068Y7VQ)88zh9M_FyXyl`wXMcy3`#CNlgtH*8+^si|UiN0{h=-?3<Y6>2|?EHxfKP)s6iuVZhzGx)hOFSK{) za88F()v3H*Ye$jlEc>brvpZI|S6q7?u=R7PNx{=jwIfBBgmFx&d+o&ZylW56%hJi= z&E?%b1}XQ-H-32aAZ*FHzj({Ul&wbAr&PLcTPTKa9I)QdM2D8PRNmU7Fj1o3p{Hp$ zZEtQIqGaQQc<6Ne!4QAC(I|d4A(S5Vc3XbSesQ3rYRZYN*A6W?6Evgg`O+tis}su2 zLY+D$mwjU4o=R;M?|TQ#9A6qAykmA%UcnLd!W8v|*M?#xzpYn(8vp8ZT?l($ z-%9a1H+7AxY4?fKIVWzM&ykp4&p+L_X}RwsF8MHt_&)D)&90RCSzDeqU5{6#VJ{ri zHOc-MIOy-ZFN`F6bTIkIu01W&?&`;8FNj>M*0yzmcjEY`dFQTunRIztky`3T&HG2v zbYEPX$rF<}g9Y_2@dp_>&ZWO+1-uEYk>%zOgyr9x((GSwfZcJUoo;uac}CdE`oqc6 zu5JkJbi&n3O`+s{zYe0L>v$H})9Y19`{k2NNitk_2HU0if(lokx+v@`!Q;#cZCCxXV`dne!qu`cF}8g` z#lA-0pH!2(kGoCg7+1J!?tJDJtsVFkpFi35;5vIR^Fx)NO_}lwbE@CA5AUqhvfjY8 z%3F6BkzuY; zw|XF_tLm7Y&b8S0u8!~X{3dQ@U-;x?5pXR)`2Zm_|LjDK1G+kc5p@pPntCCA)k@g< zS-pSbY4&1BszDSKjm^lzvy(owQkX4k43>=cv*r$lCZ&IL9%E)C zGxmkB_QgBRuH3WDpo8?A@-u}AhCv=dt2XLcTgL9q=+Wj@(8zh9j@6yj*3x{rQU zJ+Yx>UiSQFuPSE;#x2Y;?GPJm6{IW_T!5=8DVCg6ha-dOe|^}wL{LHtv7i5ZmO_qQ z&Z1MAMXxh$+H$NNS4n#!*T#IT3(dq>|3Vcs&h34itCxKuz*p%w<@n?+3&`7r9hVPY z-`I0RR7$UVqPRIObK252L%$_G&s`o(wm83K%Y~CWF8AAtV?K4n9StOSpG?Dd>Ih!e zEia^PEb=B^AQ$^rZ?11K55Oz$GZMHd*GtFMW-#;Iw5C~Hp=jSSseKGLTt&c0RlG#_9!sc1JEbo)-2@8MZb7m?5^C9Qu zwOmIxihE-wMzMRN6QiiL<4I8FrGaG^J6mpk*8S31LEXMiWEx`q$l&e$2&(eA*sS-t z?|8pwUp)x^rS%>cd?OkC=!=Pve5{+KB3gEYG$}NqbK{!9RSb z^>(>1bcyzn%FCFyTb4WtDg1z`9(Z!Kzo@aq^+WIS4WHAhx=DTBed+J1&wV>BeVSe= z>6G5d{ZJ&xJ_kGOFMoSkpyEPJo@-iqyGHfF>=(yZ==d*7K9qU|1C{LFFx3~lZ0#_rb4yCfcbhpw`|5`A%szh`^cDR3E2{i9 zHui0N^q%(Zh0@o>dGu|PK*1BgzD-&#l7Uy*)rbTNLPEHFD{Rlj3M|CsSYek_T<|VJ zJ0z6r7%f7)qFue&(W}{X4t5a(W4VY0?#2jC#uDO!<#ik}1m4W8=Gb{U+s{E6WEQe; zVK}%hLb7lkUu+?>!pcP~KpQ2)SV+zyS#5>&b#aFz0s(I|R{{~u=w<{QfwTY$7J>Ui zq(HP9BA8LJ08+#Ww(tZu?$IEo3X5e$0~ z7s9!*aT3UzK(l}d7E}v7*}{SbS;GI|1kMMdcA$<2>U#eN(J`E3L`)#Of$$*w@T_vt5l%}O_0t#&{o6KU30++NXRC#WqhXEmSuh1`X*js4 zIx+u0LGy3>nZy37uuv-E$uoq*h7lfu>Lv!RCIF2&Y>QxlD4Yf2nv*AgG8$2$WPZm5DKg0?v!*P&cmXs&KGC~nh)FqlBLh-OacwEMC zLoNw_Ljx@~8X^MGFrXK*W)zvh3TE+xS*t_;0U>8WA-)QNHfN;N12p~-Xf%4z5c+Rm z-vRt2hU6r$?|^WEzwT-b4D>I3{ym^?TRAu&tgw;jM*YK4F{b`7y5|`GY|AkLMH19K zz^rHv8>8v(#s)=08bpw1K4=i}1Tx?Qn}nQ&X@L?5cmj<;#nUL}rg$P2kH-QIZ#006 zzlFvqxIkn)>Y;z;H(&v^kT8TT`O1Pi5s+=9l29Nx8Y3oOD~mD_5)7(jp!|dG#={?o zN}-S_P%tz~qmw~x5B)&=Q5qFb29?zBX?SyUP~rLqjYj%G7LO> matrix makepattern +/Pat1 exch def +<< Tile8x8 + /PaintProc {0.5 setlinewidth pop 0 0 M 8 8 L 0 8 M 8 0 L stroke + 0 4 M 4 8 L 8 4 L 4 0 L 0 4 L stroke} +>> matrix makepattern +/Pat2 exch def +<< Tile8x8 + /PaintProc {0.5 setlinewidth pop 0 0 M 0 8 L + 8 8 L 8 0 L 0 0 L fill} +>> matrix makepattern +/Pat3 exch def +<< Tile8x8 + /PaintProc {0.5 setlinewidth pop -4 8 M 8 -4 L + 0 12 M 12 0 L stroke} +>> matrix makepattern +/Pat4 exch def +<< Tile8x8 + /PaintProc {0.5 setlinewidth pop -4 0 M 8 12 L + 0 -4 M 12 8 L stroke} +>> matrix makepattern +/Pat5 exch def +<< Tile8x8 + /PaintProc {0.5 setlinewidth pop -2 8 M 4 -4 L + 0 12 M 8 -4 L 4 12 M 10 0 L stroke} +>> matrix makepattern +/Pat6 exch def +<< Tile8x8 + /PaintProc {0.5 setlinewidth pop -2 0 M 4 12 L + 0 -4 M 8 12 L 4 -4 M 10 8 L stroke} +>> matrix makepattern +/Pat7 exch def +<< Tile8x8 + /PaintProc {0.5 setlinewidth pop 8 -2 M -4 4 L + 12 0 M -4 8 L 12 4 M 0 10 L stroke} +>> matrix makepattern +/Pat8 exch def +<< Tile8x8 + /PaintProc {0.5 setlinewidth pop 0 -2 M 12 4 L + -4 0 M 12 8 L -4 4 M 8 10 L stroke} +>> matrix makepattern +/Pat9 exch def +/Pattern1 {PatternBgnd KeepColor Pat1 setpattern} bind def +/Pattern2 {PatternBgnd KeepColor Pat2 setpattern} bind def +/Pattern3 {PatternBgnd KeepColor Pat3 setpattern} bind def +/Pattern4 {PatternBgnd KeepColor Landscape {Pat5} {Pat4} ifelse setpattern} bind def +/Pattern5 {PatternBgnd KeepColor Landscape {Pat4} {Pat5} ifelse setpattern} bind def +/Pattern6 {PatternBgnd KeepColor Landscape {Pat9} {Pat6} ifelse setpattern} bind def +/Pattern7 {PatternBgnd KeepColor Landscape {Pat8} {Pat7} ifelse setpattern} bind def +} def +% +% +%End of PostScript Level 2 code +% +/PatternBgnd { + TransparentPatterns {} {gsave 1 setgray fill grestore} ifelse +} def +% +% Substitute for Level 2 pattern fill codes with +% grayscale if Level 2 support is not selected. +% +/Level1PatternFill { +/Pattern1 {0.250 Density} bind def +/Pattern2 {0.500 Density} bind def +/Pattern3 {0.750 Density} bind def +/Pattern4 {0.125 Density} bind def +/Pattern5 {0.375 Density} bind def +/Pattern6 {0.625 Density} bind def +/Pattern7 {0.875 Density} bind def +} def +% +% Now test for support of Level 2 code +% +Level1 {Level1PatternFill} {Level2PatternFill} ifelse +% +/Symbol-Oblique /Symbol findfont [1 0 .167 1 0 0] makefont +dup length dict begin {1 index /FID eq {pop pop} {def} ifelse} forall +currentdict end definefont pop +Level1 SuppressPDFMark or +{} { +/SDict 10 dict def +systemdict /pdfmark known not { + userdict /pdfmark systemdict /cleartomark get put +} if +SDict begin [ + /Title (heter2.eps) + /Subject (gnuplot plot) + /Creator (gnuplot 4.6 patchlevel 0) + /Author (afanfakh) +% /Producer (gnuplot) +% /Keywords () + /CreationDate (Fri Oct 17 16:04:17 2014) + /DOCINFO pdfmark +end +} ifelse +end +%%EndProlog +%%Page: 1 1 +gnudict begin +gsave +doclip +50 50 translate +0.050 0.050 scale +0 setgray +newpath +(Helvetica) findfont 140 scalefont setfont +BackgroundColor 0 lt 3 1 roll 0 lt exch 0 lt or or not {BackgroundColor C 1.000 0 0 5400.00 3780.00 BoxColFill} if +1.000 UL +LTb +686 378 M +63 0 V +4398 0 R +-63 0 V +/Helvetica findfont 220 scalefont setfont +602 378 M +( 0.3) Rshow +/Helvetica findfont 140 scalefont setfont +1.000 UL +LTb +686 1456 M +63 0 V +4398 0 R +-63 0 V +/Helvetica findfont 220 scalefont setfont +-4482 0 R +( 0.6) Rshow +/Helvetica findfont 140 scalefont setfont +1.000 UL +LTb +686 2533 M +63 0 V +4398 0 R +-63 0 V +/Helvetica findfont 220 scalefont setfont +-4482 0 R +( 0.9) Rshow +/Helvetica findfont 140 scalefont setfont +1.000 UL +LTb +686 3611 M +63 0 V +4398 0 R +-63 0 V +/Helvetica findfont 220 scalefont setfont +-4482 0 R +( 1.2) Rshow +/Helvetica findfont 140 scalefont setfont +1.000 UL +LTb +1.000 UL +LTb +686 3611 N +686 378 L +4461 0 V +0 3233 V +-4461 0 V +Z stroke +LCb setrgbcolor +/Helvetica findfont 220 scalefont setfont +112 1994 M +currentpoint gsave translate -270 rotate 0 0 M +(Normalized energy and performance) Cshow +grestore +/Helvetica findfont 140 scalefont setfont +LTb +LCb setrgbcolor +/Helvetica findfont 220 scalefont setfont +3016 98 M +(Sets of frequency scaling factors) Cshow +/Helvetica findfont 140 scalefont setfont +LTb +1.000 UP +/Helvetica findfont 220 scalefont setfont +1801 558 M +(Optimal set of scaling factors) Lshow +/Helvetica findfont 140 scalefont setfont +/Helvetica findfont 220 scalefont setfont +5147 1497 M +() Lshow +/Helvetica findfont 140 scalefont setfont +1.000 UL +LTb +1734 2688 M +0 -1265 V +stroke +LT2 +1702 517 M +32 -121 V +32 121 V +-32 2171 R +0 -2292 V +stroke +gsave [] 0 setdash +1702 517 M +32 -121 V +32 121 V +stroke +grestore +1.000 UL +LT0 +1623 2688 M +234 0 V +1623 1423 M +234 0 V +stroke +LTb +% Begin plot #1 +1.000 UL +LT2 +LC2 setrgbcolor +LCb setrgbcolor +/Helvetica findfont 220 scalefont setfont +4496 3443 M +(Normalize performance) Rshow +/Helvetica findfont 140 scalefont setfont +LT2 +LC2 setrgbcolor +4580 3443 M +399 0 V +686 2893 M +93 0 V +101 0 V +110 0 V +121 0 V +133 0 V +146 0 V +163 -32 V +183 -173 V +205 -178 V +232 -183 V +266 -190 V +306 -195 V +357 -201 V +423 -129 V +507 -79 V +619 -36 V +% End plot #1 +% Begin plot #2 +stroke +2.000 UL +LT0 +1.00 0.00 0.00 C LCb setrgbcolor +/Helvetica findfont 220 scalefont setfont +4496 3233 M +(Normalize energy) Rshow +/Helvetica findfont 140 scalefont setfont +LT0 +1.00 0.00 0.00 C 4580 3233 M +399 0 V +686 2893 M +93 -144 V +880 2494 L +990 2292 L +121 -159 V +133 -203 V +146 -177 V +163 -151 V +183 -177 V +205 -129 V +232 -89 V +266 -67 V +306 -43 V +357 -36 V +423 -33 V +507 -28 V +619 0 V +% End plot #2 +% Begin plot #3 +stroke +1.000 UL +LT0 +1.00 1.00 1.00 C 5147 641 M +% End plot #3 +stroke +LTb +686 3611 N +686 378 L +4461 0 V +0 3233 V +-4461 0 V +Z stroke +1.000 UP +1.000 UL +LTb +stroke +grestore +end +showpage +%%Trailer +%%DocumentFonts: Helvetica +%%Trailer +%%DocumentFonts: Helvetica diff --git a/fig/homo-eps-converted-to.pdf b/fig/homo-eps-converted-to.pdf new file mode 100644 index 0000000000000000000000000000000000000000..a82a1aeea64676a284e4ac456cf8ef6d0e8fd04b GIT binary patch literal 6975 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 DS4^b= literal 0 HcmV?d00001 diff --git a/fig/homo.eps b/fig/homo.eps new file mode 100755 index 0000000..93ceab5 --- /dev/null +++ b/fig/homo.eps @@ -0,0 +1,690 @@ +%!PS-Adobe-2.0 EPSF-2.0 +%%Title: file.eps +%%Creator: gnuplot 4.6 patchlevel 0 +%%CreationDate: Fri Oct 17 16:06:25 2014 +%%DocumentFonts: (atend) +%%BoundingBox: 50 50 320 239 +%%EndComments +%%BeginProlog +/gnudict 256 dict def +gnudict begin +% +% The following true/false flags may be edited by hand if desired. +% The unit line width and grayscale image gamma correction may also be changed. +% +/Color false def +/Blacktext false def +/Solid false def +/Dashlength 1 def +/Landscape false def +/Level1 false def +/Rounded false def +/ClipToBoundingBox false def +/SuppressPDFMark false def +/TransparentPatterns false def +/gnulinewidth 5.000 def +/userlinewidth gnulinewidth def +/Gamma 1.0 def +/BackgroundColor {-1.000 -1.000 -1.000} def +% +/vshift -46 def +/dl1 { + 10.0 Dashlength mul mul + Rounded { currentlinewidth 0.75 mul sub dup 0 le { pop 0.01 } if } if +} def +/dl2 { + 10.0 Dashlength mul mul + Rounded { currentlinewidth 0.75 mul add } if +} def +/hpt_ 31.5 def +/vpt_ 31.5 def +/hpt hpt_ def +/vpt vpt_ def +/doclip { + ClipToBoundingBox { + newpath 50 50 moveto 320 50 lineto 320 239 lineto 50 239 lineto closepath + clip + } if +} def +% +% Gnuplot Prolog Version 4.4 (August 2010) +% +%/SuppressPDFMark true def +% +/M {moveto} bind def +/L {lineto} bind def +/R {rmoveto} bind def +/V {rlineto} bind def +/N {newpath moveto} bind def +/Z {closepath} bind def +/C {setrgbcolor} bind def +/f {rlineto fill} bind def +/g {setgray} bind def +/Gshow {show} def % May be redefined later in the file to support UTF-8 +/vpt2 vpt 2 mul def +/hpt2 hpt 2 mul def +/Lshow {currentpoint stroke M 0 vshift R + Blacktext {gsave 0 setgray show grestore} {show} ifelse} def +/Rshow {currentpoint stroke M dup stringwidth pop neg vshift R + Blacktext {gsave 0 setgray show grestore} {show} ifelse} def +/Cshow {currentpoint stroke M dup stringwidth pop -2 div vshift R + Blacktext {gsave 0 setgray show grestore} {show} ifelse} def +/UP {dup vpt_ mul /vpt exch def hpt_ mul /hpt exch def + /hpt2 hpt 2 mul def /vpt2 vpt 2 mul def} def +/DL {Color {setrgbcolor Solid {pop []} if 0 setdash} + {pop pop pop 0 setgray Solid {pop []} if 0 setdash} ifelse} def +/BL {stroke userlinewidth 2 mul setlinewidth + Rounded {1 setlinejoin 1 setlinecap} if} def +/AL {stroke userlinewidth 2 div setlinewidth + Rounded {1 setlinejoin 1 setlinecap} if} def +/UL {dup gnulinewidth mul /userlinewidth exch def + dup 1 lt {pop 1} if 10 mul /udl exch def} def +/PL {stroke userlinewidth setlinewidth + Rounded {1 setlinejoin 1 setlinecap} if} def +3.8 setmiterlimit +% Default Line colors +/LCw {1 1 1} def +/LCb {0 0 0} def +/LCa {0 0 0} def +/LC0 {1 0 0} def +/LC1 {0 1 0} def +/LC2 {0 0 1} def +/LC3 {1 0 1} def +/LC4 {0 1 1} def +/LC5 {1 1 0} def +/LC6 {0 0 0} def +/LC7 {1 0.3 0} def +/LC8 {0.5 0.5 0.5} def +% Default Line Types +/LTw {PL [] 1 setgray} def +/LTb {BL [] LCb DL} def +/LTa {AL [1 udl mul 2 udl mul] 0 setdash LCa setrgbcolor} def +/LT0 {PL [] LC0 DL} def +/LT1 {PL [4 dl1 2 dl2] LC1 DL} def +/LT2 {PL [2 dl1 3 dl2] LC2 DL} def +/LT3 {PL [1 dl1 1.5 dl2] LC3 DL} def +/LT4 {PL [6 dl1 2 dl2 1 dl1 2 dl2] LC4 DL} def +/LT5 {PL [3 dl1 3 dl2 1 dl1 3 dl2] LC5 DL} def +/LT6 {PL [2 dl1 2 dl2 2 dl1 6 dl2] LC6 DL} def +/LT7 {PL [1 dl1 2 dl2 6 dl1 2 dl2 1 dl1 2 dl2] LC7 DL} def +/LT8 {PL [2 dl1 2 dl2 2 dl1 2 dl2 2 dl1 2 dl2 2 dl1 4 dl2] LC8 DL} def +/Pnt {stroke [] 0 setdash gsave 1 setlinecap M 0 0 V stroke grestore} def +/Dia {stroke [] 0 setdash 2 copy vpt add M + hpt neg vpt neg V hpt vpt neg V + hpt vpt V hpt neg vpt V closepath stroke + Pnt} def +/Pls {stroke [] 0 setdash vpt sub M 0 vpt2 V + currentpoint stroke M + hpt neg vpt neg R hpt2 0 V stroke + } def +/Box {stroke [] 0 setdash 2 copy exch hpt sub exch vpt add M + 0 vpt2 neg V hpt2 0 V 0 vpt2 V + hpt2 neg 0 V closepath stroke + Pnt} def +/Crs {stroke [] 0 setdash exch hpt sub exch vpt add M + hpt2 vpt2 neg V currentpoint stroke M + hpt2 neg 0 R hpt2 vpt2 V stroke} def +/TriU {stroke [] 0 setdash 2 copy vpt 1.12 mul add M + hpt neg vpt -1.62 mul V + hpt 2 mul 0 V + hpt neg vpt 1.62 mul V closepath stroke + Pnt} def +/Star {2 copy Pls Crs} def +/BoxF {stroke [] 0 setdash exch hpt sub exch vpt add M + 0 vpt2 neg V hpt2 0 V 0 vpt2 V + hpt2 neg 0 V closepath fill} def +/TriUF {stroke [] 0 setdash vpt 1.12 mul add M + hpt neg vpt -1.62 mul V + hpt 2 mul 0 V + hpt neg vpt 1.62 mul V closepath fill} def +/TriD {stroke [] 0 setdash 2 copy vpt 1.12 mul sub M + hpt neg vpt 1.62 mul V + hpt 2 mul 0 V + hpt neg vpt -1.62 mul V closepath stroke + Pnt} def +/TriDF {stroke [] 0 setdash vpt 1.12 mul sub M + hpt neg vpt 1.62 mul V + hpt 2 mul 0 V + hpt neg vpt -1.62 mul V closepath fill} def +/DiaF {stroke [] 0 setdash vpt add M + hpt neg vpt neg V hpt vpt neg V + hpt vpt V hpt neg vpt V closepath fill} def +/Pent {stroke [] 0 setdash 2 copy gsave + translate 0 hpt M 4 {72 rotate 0 hpt L} repeat + closepath stroke grestore Pnt} def +/PentF {stroke [] 0 setdash gsave + translate 0 hpt M 4 {72 rotate 0 hpt L} repeat + closepath fill grestore} def +/Circle {stroke [] 0 setdash 2 copy + hpt 0 360 arc stroke Pnt} def +/CircleF {stroke [] 0 setdash hpt 0 360 arc fill} def +/C0 {BL [] 0 setdash 2 copy moveto vpt 90 450 arc} bind def +/C1 {BL [] 0 setdash 2 copy moveto + 2 copy vpt 0 90 arc closepath fill + vpt 0 360 arc closepath} bind def +/C2 {BL [] 0 setdash 2 copy moveto + 2 copy vpt 90 180 arc closepath fill + vpt 0 360 arc closepath} bind def +/C3 {BL [] 0 setdash 2 copy moveto + 2 copy vpt 0 180 arc closepath fill + vpt 0 360 arc closepath} bind def +/C4 {BL [] 0 setdash 2 copy moveto + 2 copy vpt 180 270 arc closepath fill + vpt 0 360 arc closepath} bind def +/C5 {BL [] 0 setdash 2 copy moveto + 2 copy vpt 0 90 arc + 2 copy moveto + 2 copy vpt 180 270 arc closepath fill + vpt 0 360 arc} bind def +/C6 {BL [] 0 setdash 2 copy moveto + 2 copy vpt 90 270 arc closepath fill + vpt 0 360 arc closepath} bind def +/C7 {BL [] 0 setdash 2 copy moveto + 2 copy vpt 0 270 arc closepath fill + vpt 0 360 arc closepath} bind def +/C8 {BL [] 0 setdash 2 copy moveto + 2 copy vpt 270 360 arc closepath fill + vpt 0 360 arc closepath} bind def +/C9 {BL [] 0 setdash 2 copy moveto + 2 copy vpt 270 450 arc closepath fill + vpt 0 360 arc closepath} bind def +/C10 {BL [] 0 setdash 2 copy 2 copy moveto vpt 270 360 arc closepath fill + 2 copy moveto + 2 copy vpt 90 180 arc closepath fill + vpt 0 360 arc closepath} bind def +/C11 {BL [] 0 setdash 2 copy moveto + 2 copy vpt 0 180 arc closepath fill + 2 copy moveto + 2 copy vpt 270 360 arc closepath fill + vpt 0 360 arc closepath} bind def +/C12 {BL [] 0 setdash 2 copy moveto + 2 copy vpt 180 360 arc closepath fill + vpt 0 360 arc closepath} bind def +/C13 {BL [] 0 setdash 2 copy moveto + 2 copy vpt 0 90 arc closepath fill + 2 copy moveto + 2 copy vpt 180 360 arc closepath fill + vpt 0 360 arc closepath} bind def +/C14 {BL [] 0 setdash 2 copy moveto + 2 copy vpt 90 360 arc closepath fill + vpt 0 360 arc} bind def +/C15 {BL [] 0 setdash 2 copy vpt 0 360 arc closepath fill + vpt 0 360 arc closepath} bind def +/Rec {newpath 4 2 roll moveto 1 index 0 rlineto 0 exch rlineto + neg 0 rlineto closepath} bind def +/Square {dup Rec} bind def +/Bsquare {vpt sub exch vpt sub exch vpt2 Square} bind def +/S0 {BL [] 0 setdash 2 copy moveto 0 vpt rlineto BL Bsquare} bind def +/S1 {BL [] 0 setdash 2 copy vpt Square fill Bsquare} bind def +/S2 {BL [] 0 setdash 2 copy exch vpt sub exch vpt Square fill Bsquare} bind def +/S3 {BL [] 0 setdash 2 copy exch vpt sub exch vpt2 vpt Rec fill Bsquare} bind def +/S4 {BL [] 0 setdash 2 copy exch vpt sub exch vpt sub vpt Square fill Bsquare} bind def +/S5 {BL [] 0 setdash 2 copy 2 copy vpt Square fill + exch vpt sub exch vpt sub vpt Square fill Bsquare} bind def +/S6 {BL [] 0 setdash 2 copy exch vpt sub exch vpt sub vpt vpt2 Rec fill Bsquare} bind def +/S7 {BL [] 0 setdash 2 copy exch vpt sub exch vpt sub vpt vpt2 Rec fill + 2 copy vpt Square fill Bsquare} bind def +/S8 {BL [] 0 setdash 2 copy vpt sub vpt Square fill Bsquare} bind def +/S9 {BL [] 0 setdash 2 copy vpt sub vpt vpt2 Rec fill Bsquare} bind def +/S10 {BL [] 0 setdash 2 copy vpt sub vpt Square fill 2 copy exch vpt sub exch vpt Square fill + Bsquare} bind def +/S11 {BL [] 0 setdash 2 copy vpt sub vpt Square fill 2 copy exch vpt sub exch vpt2 vpt Rec fill + Bsquare} bind def +/S12 {BL [] 0 setdash 2 copy exch vpt sub exch vpt sub vpt2 vpt Rec fill Bsquare} bind def +/S13 {BL [] 0 setdash 2 copy exch vpt sub exch vpt sub vpt2 vpt Rec fill + 2 copy vpt Square fill Bsquare} bind def +/S14 {BL [] 0 setdash 2 copy exch vpt sub exch vpt sub vpt2 vpt Rec fill + 2 copy exch vpt sub exch vpt Square fill Bsquare} bind def +/S15 {BL [] 0 setdash 2 copy Bsquare fill Bsquare} bind def +/D0 {gsave translate 45 rotate 0 0 S0 stroke grestore} bind def +/D1 {gsave translate 45 rotate 0 0 S1 stroke grestore} bind def +/D2 {gsave translate 45 rotate 0 0 S2 stroke grestore} bind def +/D3 {gsave translate 45 rotate 0 0 S3 stroke grestore} bind def +/D4 {gsave translate 45 rotate 0 0 S4 stroke grestore} bind def +/D5 {gsave translate 45 rotate 0 0 S5 stroke grestore} bind def +/D6 {gsave translate 45 rotate 0 0 S6 stroke grestore} bind def +/D7 {gsave translate 45 rotate 0 0 S7 stroke grestore} bind def +/D8 {gsave translate 45 rotate 0 0 S8 stroke grestore} bind def +/D9 {gsave translate 45 rotate 0 0 S9 stroke grestore} bind def +/D10 {gsave translate 45 rotate 0 0 S10 stroke grestore} bind def +/D11 {gsave translate 45 rotate 0 0 S11 stroke grestore} bind def +/D12 {gsave translate 45 rotate 0 0 S12 stroke grestore} bind def +/D13 {gsave translate 45 rotate 0 0 S13 stroke grestore} bind def +/D14 {gsave translate 45 rotate 0 0 S14 stroke grestore} bind def +/D15 {gsave translate 45 rotate 0 0 S15 stroke grestore} bind def +/DiaE {stroke [] 0 setdash vpt add M + hpt neg vpt neg V hpt vpt neg V + hpt vpt V hpt neg vpt V closepath stroke} def +/BoxE {stroke [] 0 setdash exch hpt sub exch vpt add M + 0 vpt2 neg V hpt2 0 V 0 vpt2 V + hpt2 neg 0 V closepath stroke} def +/TriUE {stroke [] 0 setdash vpt 1.12 mul add M + hpt neg vpt -1.62 mul V + hpt 2 mul 0 V + hpt neg vpt 1.62 mul V closepath stroke} def +/TriDE {stroke [] 0 setdash vpt 1.12 mul sub M + hpt neg vpt 1.62 mul V + hpt 2 mul 0 V + hpt neg vpt -1.62 mul V closepath stroke} def +/PentE {stroke [] 0 setdash gsave + translate 0 hpt M 4 {72 rotate 0 hpt L} repeat + closepath stroke grestore} def +/CircE {stroke [] 0 setdash + hpt 0 360 arc stroke} def +/Opaque {gsave closepath 1 setgray fill grestore 0 setgray closepath} def +/DiaW {stroke [] 0 setdash vpt add M + hpt neg vpt neg V hpt vpt neg V + hpt vpt V hpt neg vpt V Opaque stroke} def +/BoxW {stroke [] 0 setdash exch hpt sub exch vpt add M + 0 vpt2 neg V hpt2 0 V 0 vpt2 V + hpt2 neg 0 V Opaque stroke} def +/TriUW {stroke [] 0 setdash vpt 1.12 mul add M + hpt neg vpt -1.62 mul V + hpt 2 mul 0 V + hpt neg vpt 1.62 mul V Opaque stroke} def +/TriDW {stroke [] 0 setdash vpt 1.12 mul sub M + hpt neg vpt 1.62 mul V + hpt 2 mul 0 V + hpt neg vpt -1.62 mul V Opaque stroke} def +/PentW {stroke [] 0 setdash gsave + translate 0 hpt M 4 {72 rotate 0 hpt L} repeat + Opaque stroke grestore} def +/CircW {stroke [] 0 setdash + hpt 0 360 arc Opaque stroke} def +/BoxFill {gsave Rec 1 setgray fill grestore} def +/Density { + /Fillden exch def + currentrgbcolor + /ColB exch def /ColG exch def /ColR exch def + /ColR ColR Fillden mul Fillden sub 1 add def + /ColG ColG Fillden mul Fillden sub 1 add def + /ColB ColB Fillden mul Fillden sub 1 add def + ColR ColG ColB setrgbcolor} def +/BoxColFill {gsave Rec PolyFill} def +/PolyFill {gsave Density fill grestore grestore} def +/h {rlineto rlineto rlineto gsave closepath fill grestore} bind def +% +% PostScript Level 1 Pattern Fill routine for rectangles +% Usage: x y w h s a XX PatternFill +% x,y = lower left corner of box to be filled +% w,h = width and height of box +% a = angle in degrees between lines and x-axis +% XX = 0/1 for no/yes cross-hatch +% +/PatternFill {gsave /PFa [ 9 2 roll ] def + PFa 0 get PFa 2 get 2 div add PFa 1 get PFa 3 get 2 div add translate + PFa 2 get -2 div PFa 3 get -2 div PFa 2 get PFa 3 get Rec + gsave 1 setgray fill grestore clip + currentlinewidth 0.5 mul setlinewidth + /PFs PFa 2 get dup mul PFa 3 get dup mul add sqrt def + 0 0 M PFa 5 get rotate PFs -2 div dup translate + 0 1 PFs PFa 4 get div 1 add floor cvi + {PFa 4 get mul 0 M 0 PFs V} for + 0 PFa 6 get ne { + 0 1 PFs PFa 4 get div 1 add floor cvi + {PFa 4 get mul 0 2 1 roll M PFs 0 V} for + } if + stroke grestore} def +% +/languagelevel where + {pop languagelevel} {1} ifelse + 2 lt + {/InterpretLevel1 true def} + {/InterpretLevel1 Level1 def} + ifelse +% +% PostScript level 2 pattern fill definitions +% +/Level2PatternFill { +/Tile8x8 {/PaintType 2 /PatternType 1 /TilingType 1 /BBox [0 0 8 8] /XStep 8 /YStep 8} + bind def +/KeepColor {currentrgbcolor [/Pattern /DeviceRGB] setcolorspace} bind def +<< Tile8x8 + /PaintProc {0.5 setlinewidth pop 0 0 M 8 8 L 0 8 M 8 0 L stroke} +>> matrix makepattern +/Pat1 exch def +<< Tile8x8 + /PaintProc {0.5 setlinewidth pop 0 0 M 8 8 L 0 8 M 8 0 L stroke + 0 4 M 4 8 L 8 4 L 4 0 L 0 4 L stroke} +>> matrix makepattern +/Pat2 exch def +<< Tile8x8 + /PaintProc {0.5 setlinewidth pop 0 0 M 0 8 L + 8 8 L 8 0 L 0 0 L fill} +>> matrix makepattern +/Pat3 exch def +<< Tile8x8 + /PaintProc {0.5 setlinewidth pop -4 8 M 8 -4 L + 0 12 M 12 0 L stroke} +>> matrix makepattern +/Pat4 exch def +<< Tile8x8 + /PaintProc {0.5 setlinewidth pop -4 0 M 8 12 L + 0 -4 M 12 8 L stroke} +>> matrix makepattern +/Pat5 exch def +<< Tile8x8 + /PaintProc {0.5 setlinewidth pop -2 8 M 4 -4 L + 0 12 M 8 -4 L 4 12 M 10 0 L stroke} +>> matrix makepattern +/Pat6 exch def +<< Tile8x8 + /PaintProc {0.5 setlinewidth pop -2 0 M 4 12 L + 0 -4 M 8 12 L 4 -4 M 10 8 L stroke} +>> matrix makepattern +/Pat7 exch def +<< Tile8x8 + /PaintProc {0.5 setlinewidth pop 8 -2 M -4 4 L + 12 0 M -4 8 L 12 4 M 0 10 L stroke} +>> matrix makepattern +/Pat8 exch def +<< Tile8x8 + /PaintProc {0.5 setlinewidth pop 0 -2 M 12 4 L + -4 0 M 12 8 L -4 4 M 8 10 L stroke} +>> matrix makepattern +/Pat9 exch def +/Pattern1 {PatternBgnd KeepColor Pat1 setpattern} bind def +/Pattern2 {PatternBgnd KeepColor Pat2 setpattern} bind def +/Pattern3 {PatternBgnd KeepColor Pat3 setpattern} bind def +/Pattern4 {PatternBgnd KeepColor Landscape {Pat5} {Pat4} ifelse setpattern} bind def +/Pattern5 {PatternBgnd KeepColor Landscape {Pat4} {Pat5} ifelse setpattern} bind def +/Pattern6 {PatternBgnd KeepColor Landscape {Pat9} {Pat6} ifelse setpattern} bind def +/Pattern7 {PatternBgnd KeepColor Landscape {Pat8} {Pat7} ifelse setpattern} bind def +} def +% +% +%End of PostScript Level 2 code +% +/PatternBgnd { + TransparentPatterns {} {gsave 1 setgray fill grestore} ifelse +} def +% +% Substitute for Level 2 pattern fill codes with +% grayscale if Level 2 support is not selected. +% +/Level1PatternFill { +/Pattern1 {0.250 Density} bind def +/Pattern2 {0.500 Density} bind def +/Pattern3 {0.750 Density} bind def +/Pattern4 {0.125 Density} bind def +/Pattern5 {0.375 Density} bind def +/Pattern6 {0.625 Density} bind def +/Pattern7 {0.875 Density} bind def +} def +% +% Now test for support of Level 2 code +% +Level1 {Level1PatternFill} {Level2PatternFill} ifelse +% +/Symbol-Oblique /Symbol findfont [1 0 .167 1 0 0] makefont +dup length dict begin {1 index /FID eq {pop pop} {def} ifelse} forall +currentdict end definefont pop +Level1 SuppressPDFMark or +{} { +/SDict 10 dict def +systemdict /pdfmark known not { + userdict /pdfmark systemdict /cleartomark get put +} if +SDict begin [ + /Title (file.eps) + /Subject (gnuplot plot) + /Creator (gnuplot 4.6 patchlevel 0) + /Author (afanfakh) +% /Producer (gnuplot) +% /Keywords () + /CreationDate (Fri Oct 17 16:06:25 2014) + /DOCINFO pdfmark +end +} ifelse +end +%%EndProlog +%%Page: 1 1 +gnudict begin +gsave +doclip +50 50 translate +0.050 0.050 scale +0 setgray +newpath +(Helvetica) findfont 140 scalefont setfont +BackgroundColor 0 lt 3 1 roll 0 lt exch 0 lt or or not {BackgroundColor C 1.000 0 0 5400.00 3780.00 BoxColFill} if +1.000 UL +LTb +686 588 M +63 0 V +4398 0 R +-63 0 V +/Helvetica findfont 220 scalefont setfont +602 588 M +( 0.4) Rshow +/Helvetica findfont 140 scalefont setfont +1.000 UL +LTb +686 1344 M +63 0 V +4398 0 R +-63 0 V +/Helvetica findfont 220 scalefont setfont +-4482 0 R +( 0.6) Rshow +/Helvetica findfont 140 scalefont setfont +1.000 UL +LTb +686 2100 M +63 0 V +4398 0 R +-63 0 V +/Helvetica findfont 220 scalefont setfont +-4482 0 R +( 0.8) Rshow +/Helvetica findfont 140 scalefont setfont +1.000 UL +LTb +686 2855 M +63 0 V +4398 0 R +-63 0 V +/Helvetica findfont 220 scalefont setfont +-4482 0 R +( 1) Rshow +/Helvetica findfont 140 scalefont setfont +1.000 UL +LTb +686 3611 M +63 0 V +4398 0 R +-63 0 V +/Helvetica findfont 220 scalefont setfont +-4482 0 R +( 1.2) Rshow +/Helvetica findfont 140 scalefont setfont +1.000 UL +LTb +686 588 M +0 63 V +0 2960 R +0 -63 V +/Helvetica findfont 220 scalefont setfont +686 448 M +( 1) Cshow +/Helvetica findfont 140 scalefont setfont +1.000 UL +LTb +1656 588 M +0 63 V +0 2960 R +0 -63 V +/Helvetica findfont 220 scalefont setfont +0 -3100 R +( 1.5) Cshow +/Helvetica findfont 140 scalefont setfont +1.000 UL +LTb +2626 588 M +0 63 V +0 2960 R +0 -63 V +/Helvetica findfont 220 scalefont setfont +0 -3100 R +( 2) Cshow +/Helvetica findfont 140 scalefont setfont +1.000 UL +LTb +3595 588 M +0 63 V +0 2960 R +0 -63 V +/Helvetica findfont 220 scalefont setfont +0 -3100 R +( 2.5) Cshow +/Helvetica findfont 140 scalefont setfont +1.000 UL +LTb +4565 588 M +0 63 V +0 2960 R +0 -63 V +/Helvetica findfont 220 scalefont setfont +0 -3100 R +( 3) Cshow +/Helvetica findfont 140 scalefont setfont +1.000 UL +LTb +1.000 UL +LTb +686 3611 N +686 588 L +4461 0 V +0 3023 V +-4461 0 V +Z stroke +LCb setrgbcolor +/Helvetica findfont 210 scalefont setfont +112 2099 M +currentpoint gsave translate -270 rotate 0 0 M +(Normalized energy and performance) Cshow +grestore +/Helvetica findfont 140 scalefont setfont +LTb +LCb setrgbcolor +/Helvetica findfont 220 scalefont setfont +3016 98 M +(Frequency scaling factors) Cshow +/Helvetica findfont 140 scalefont setfont +LTb +1.000 UP +/Helvetica findfont 220 scalefont setfont +1656 777 M +(Optimal scaling factor) Lshow +/Helvetica findfont 140 scalefont setfont +/Helvetica findfont 220 scalefont setfont +880 3460 M +( ) Lshow +/Helvetica findfont 140 scalefont setfont +1.000 UL +LTb +1598 1442 M +0 559 V +0 4 R +0 -567 V +stroke +LT1 +0.00 0.00 0.00 C 1566 747 M +32 -121 V +32 121 V +-32 695 R +0 -816 V +stroke +gsave [] 0 setdash +1566 747 M +32 -121 V +32 121 V +stroke +grestore +1.000 UL +LT0 +1501 2005 M +203 0 V +1501 1442 M +203 0 V +stroke +LTb +% Begin plot #1 +1.000 UL +LT2 +0.00 0.00 1.00 C LCb setrgbcolor +/Helvetica findfont 220 scalefont setfont +4496 3443 M +(Normalized performance) Rshow +/Helvetica findfont 140 scalefont setfont +LT2 +0.00 0.00 1.00 C 4580 3443 M +399 0 V +686 2855 M +81 -94 V +88 -98 V +95 -101 V +105 -104 V +116 -108 V +127 -111 V +142 -115 V +159 -119 V +178 -123 V +202 -128 V +231 -132 V +266 -138 V +311 -143 V +368 -148 V +440 -154 V +4134 879 L +4808 712 L +% End plot #1 +% Begin plot #2 +stroke +2.000 UL +LT0 +1.00 0.00 0.00 C LCb setrgbcolor +/Helvetica findfont 220 scalefont setfont +4496 3233 M +(Normalized energy) Rshow +/Helvetica findfont 140 scalefont setfont +LT0 +1.00 0.00 0.00 C 4580 3233 M +399 0 V +686 2855 M +81 -280 V +88 -202 V +95 -189 V +105 -176 V +116 -163 V +127 -149 V +142 -135 V +159 -119 V +178 -103 V +202 -85 V +231 -66 V +266 -44 V +311 -20 V +368 9 V +440 43 V +539 86 V +674 140 V +% End plot #2 +stroke +1.000 UL +LTb +686 3611 N +686 588 L +4461 0 V +0 3023 V +-4461 0 V +Z stroke +1.000 UP +1.000 UL +LTb +stroke +grestore +end +showpage +%%Trailer +%%DocumentFonts: Helvetica diff --git a/fig/sen_comp.pdf b/fig/sen_comp.pdf new file mode 100644 index 0000000000000000000000000000000000000000..554f405a21f2ed3be7fb5c4021c2e24950bab5b5 GIT binary patch literal 17617 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⪙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 Y&MrnyE`PZc2!h87Djl7Kk|gT?2Y46~$p8QV literal 0 HcmV?d00001 diff --git a/my_reference.bib b/my_reference.bib new file mode 100644 index 0000000..88afb97 --- /dev/null +++ b/my_reference.bib @@ -0,0 +1,671 @@ +@inproceedings{1, + author = {Lim, Min Yeol and Freeh, Vincent W. and Lowenthal, David K.}, + title = {Adaptive, Transparent Frequency and Voltage Scaling of Communication Phases in {MPI} Programs}, + booktitle = {Proceedings of the 2006 ACM/IEEE Conference on Supercomputing}, + series = {SC '06}, + year = {2006}, + isbn = {0-7695-2700-0}, + location = {Tampa, Florida}, + articleno = {107}, + doi = {10.1145/1188455.1188567}, + acmid = {1188567}, + publisher = {ACM}, + address = {New York, NY, USA} +} + +@article{2, + author = {Peraza , J. and Tiwari , A. and Laurenzano , M. and Carrington L. and Snavely}, + title = {{PMaC}'s green queue: a framework for selecting energy optimal {DVFS} configurations in large scale {MPI} applications}, + journal = {Concurrency Computat.: Pract. Exper.DOI: 10.1002/cpe}, + pages = {1-20}, + year = {2012} + + } + + +@inproceedings{3, + author = {Rauber, Thomas and R\"{u}nger, Gudula}, + title = {Analytical Modeling and Simulation of the Energy Consumption of Independent Tasks}, + booktitle = {Proceedings of the Winter Simulation Conference}, + series = {WSC '12}, + year = {2012}, + location = {Berlin, Germany}, + pages = {245:1--245:13}, + articleno = {245}, + numpages = {13}, + acmid = {2430090}, + publisher = {Winter Simulation Conference} +} + +@inproceedings{4, + author = {Jejurikar, Ravindra and Pereira, Cristiano and Gupta, Rajesh}, + title = {Leakage Aware Dynamic Voltage Scaling for Real-time Embedded Systems}, + booktitle = {Proceedings of the 41 st Annual Design Automation Conference}, + series = {DAC '04}, + year = {2004}, + isbn = {1-58113-828-8}, + location = {San Diego, CA, USA}, + pages = {275--280}, + numpages = {6}, + doi = {10.1145/996566.996650}, + acmid = {996650}, + publisher = {ACM}, + address = {New York, NY, USA}, + keywords = {EDF scheduling, critical speed, leakage power, low power scheduling, procrastication, real-time systems} +} + + + +@MISC{5, + author = {Vishal Gupta and Hyesoon Kim and Karsten Schwan and Memory B}, + title = {A Power-Performance Analysis of Memory-intensive Parallel Applications on a Manycore Platform}, +year = {2013} +} + +@article{6, + author = {Nikzad Babaii Rizvandi and + Albert Y. Zomaya}, + title = {A Primarily Survey on Energy Efficiency in Cloud and Distributed + Computing Systems}, + journal = {CoRR}, + volume = {abs/1210.4690}, + year = {2012} +} + +@techreport{7, + author = "Jee Whan Choi and Richard Vuduc", + title = "A roofline model of energy", + institution = "Georgia Institute of Technology", + TTtype = "", + TTnumber = "", + TTaddress = "", + year = {2012} + +} + +@INPROCEEDINGS{8, +author={Rountree, B. and Lowenthal, D.K. and Funk, S. and Freeh, Vincent W. and De Supinski, B.R. and Schulz, M.}, +booktitle={Supercomputing, 2007. SC '07. Proceedings of the 2007 ACM/IEEE Conference on}, +title={Bounding energy consumption in large-scale {MPI} programs}, +year={2007}, +month={November}, +pages={1-9}, +keywords={Clustering algorithms;Delay effects;Dynamic voltage scaling;Energy consumption;Frequency;Government;Laboratories;Large-scale systems;Linear programming;Processor scheduling}, +doi={10.1145/1362622.1362688} +} + +@phdthesis {9, + author = "Malkowski, Konrad", + title = "Co-adapting scientific applications and architectures toward energy-efficient high performance computing", + school = "The Pennsylvania State University", + address = "USA", + year = "2009", + pages = "227", + + +} + +@INPROCEEDINGS{10, +author={Kessler, C.W. and Melot, N. and Eitschberger, P. and Keller, J.}, +booktitle={Power and Timing Modeling, Optimization and Simulation (PATMOS), 2013 23rd International Workshop on}, +title={Crown scheduling: Energy-efficient resource allocation, mapping and discrete frequency scaling for collections of malleable streaming tasks}, +year={2013}, +month={Sept}, +pages={215-222}, +keywords={cores;microprocessor chips;optimisation;power consumption;resource allocation;scaling circuits;scheduling;ILP;crown scheduling;data flows;discrete voltage-frequency scaling;dynamic discrete frequency scaling;dynamic rescaling;energy-efficient resource allocation;energy-optimal code;integer linear programming;malleable streaming tasks;many-core processor;mapping;optimization;pipelined task graph;power consumption;processor cores;streaming task collections;Dynamic scheduling;Optimization;Processor scheduling;Radio spectrum management;Resource management;Schedules}, +doi={10.1109/PATMOS.2013.6662176} +} + +@INPROCEEDINGS{11, +author={Kimura, H. and Sato, M. and Hotta, Y. and Boku, T. and Takahashi, D.}, +booktitle={IEEE Cluster Computing, 2006}, +title={Emprical study on Reducing Energy of Parallel Programs using Slack Reclamation by {DVFS} in a Power-scalable High Performance Cluster}, +year={2006}, +month={Sept}, +pages={1-10}, +keywords={directed graphs;parallel programming;power aware computing;AMD Turion;PC clusters;PowerWatch;Transmeta Crusoe;control library;directed acyclic task graph;dynamic voltage scaling;energy consumption;energy reduction;frequency scaling;high performance computing;microprocessors;parallel programs;power consumption;power monitoring tools;slack reclamation;Clustering algorithms;Concurrent computing;Dynamic voltage scaling;Energy consumption;Energy efficiency;Frequency synchronization;Gears;Libraries;Microprocessors;Monitoring}, +doi={10.1109/CLUSTR.2006.311839}, +ISSN={1552-5244} +} + +@article{12, + author = {Lively, Charles and Xingfu Wu and Taylor, Valerie and Moore, Shirley and Chang, Hung-Ching and Cameron, Kirk}, + title = {Energy and Performance Characteristics of Different Parallel Implementations of Scientific Applications on Multicore Systems}, + journal = {Int. J. High Perform. Comput. Appl.}, + issue_date = {August 2011}, + volume = {25}, + number = {3}, + month = aug, + year = {2011}, + issn = {1094-3420}, + pages = {342--350}, + numpages = {9}, + doi = {10.1177/1094342011414749}, + acmid = {2020813}, + publisher = {Sage Publications, Inc.}, + address = {Thousand Oaks, CA, USA}, + keywords = {MPI, energy consumption, frequency scaling, hybrid MPI/OpenMP, multicore system, performance characteristics, scientific applications} +} + +@ARTICLE{13, + author = {Lizhe Wang a,b, Samee U. Khan c , Dan Chen a , Joanna Kołodziej d , Rajiv Ranjan e , Cheng-zhong Xu f ,Albert Zomaya}, + title = {Energy-aware parallel task scheduling in a cluster}, + journal = {Future Generation Computer Systems}, + volume = {29}, + number = {7}, + pages = {1661–1670}, + year = {2013} + + } + +@INPROCEEDINGS{14, +author={Huang, S. and Feng, W.}, +booktitle={Cluster Computing and the Grid, 2009. CCGRID '09. 9th IEEE/ACM International Symposium on}, +title={Energy-Efficient Cluster Computing via Accurate Workload Characterization}, +year={2009}, +month={May}, +pages={68-75}, +keywords={parallel processing;power aware computing;workstation clusters;cluster computer;eco-friendly daemon;energy consumption reduction;energy-efficient cluster computing;power consumption reduction;processor stall cycles;workload characterization;Application software;Clustering algorithms;Energy consumption;Energy efficiency;Frequency;Grid computing;Hardware;High performance computing;Runtime;Voltage}, +doi={10.1109/CCGRID.2009.88} +} + +@article{15, + author = {Zhuo, Jianli and Chakrabarti, Chaitali}, + title = {Energy-efficient Dynamic Task Scheduling Algorithms for DVS Systems}, + journal = {ACM Trans. Embed. Comput. Syst.}, + issue_date = {February 2008}, + volume = {7}, + number = {2}, + month = jan, + year = {2008}, + issn = {1539-9087}, + pages = {17:1--17:25}, + articleno = {17}, + numpages = {25}, + doi = {10.1145/1331331.1331341}, + acmid = {1331341}, + publisher = {ACM}, + address = {New York, NY, USA}, + keywords = {DVS system, Dynamic task scheduling, energy minimization, optimal scaling factor, real time} +} + +@inproceedings{16, + author = {Zong, Ziliang and Qin, Xiao and Ruan, Xiaojun and Bellam, Kiranmai and Nijim, Mais and Alghamdi, Mohamed}, + title = {Energy-Efficient Scheduling for Parallel Applications Running on Heterogeneous Clusters}, + booktitle = {Proceedings of the 2007 International Conference on Parallel Processing}, + series = {ICPP '07}, + year = {2007}, + isbn = {0-7695-2933-X}, + pages = {19--}, + doi = {10.1109/ICPP.2007.39}, + acmid = {1306033}, + publisher = {IEEE Computer Society}, + address = {Washington, DC, USA} +} + +@inproceedings{17, + author = {Freeh, Vincent W. and Pan, Feng and Kappiah, Nandini and Lowenthal, David K. and Springer, Rob}, + title = {Exploring the Energy-Time Tradeoff in {MPI} Programs on a Power-Scalable Cluster}, + booktitle = {Proceedings of the 19th IEEE International Parallel and Distributed Processing Symposium (IPDPS'05) - Papers - Volume 01}, + series = {IPDPS '05}, + year = {2005}, + isbn = {0-7695-2312-9}, + pages = {4.1--}, + doi = {10.1109/IPDPS.2005.214}, + acmid = {1054466}, + publisher = {IEEE Computer Society}, + address = {Washington, DC, USA} +} + +@INPROCEEDINGS{18, +author={Dong Li and De Supinski, B.R. and Schulz, M. and Cameron, K. and Nikolopoulos, D.S.}, +booktitle={Parallel Distributed Processing (IPDPS), 2010 IEEE International Symposium on}, +title={Hybrid MPI/OpenMP power-aware computing}, +year={2010}, +month={April}, +pages={1-12}, +keywords={message passing;parallel algorithms;power aware computing;HPC environment;dynamic concurrency throttling;dynamic voltage-and-frequency scaling;high performance computing;hybrid MPI-OpenMP computing;hybrid programming models;large-scale distributed systems;message passing interface;parallel programs;power-aware computing;power-aware performance prediction model;Concurrent computing;Discrete cosine transforms;Dynamic programming;Dynamic voltage scaling;Frequency;Heuristic algorithms;Large-scale systems;Multicore processing;Power system modeling;Predictive models;MPI;OpenMP;performance modeling;power-aware high -performance computing}, +doi={10.1109/IPDPS.2010.5470463}, +ISSN={1530-2075} +} + + +@inproceedings{19, + author = {Hao Shen and + Jun Lu and + Qinru Qiu}, + title = {Learning based {DVFS} for simultaneous temperature, performance + and energy management}, + booktitle = {ISQED}, + year = {2012}, + pages = {747-754}, + ee = {http://dx.doi.org/10.1109/ISQED.2012.6187575}, + CCcrossref = {DBLP:conf/isqed/2012}, + CCbibsource = {DBLP, http://dblp.uni-trier.de} +} + + +@inproceedings{20, + author = {Springer, Robert and Lowenthal, David K. and Rountree, Barry and Freeh, Vincent W.}, + title = {Minimizing Execution Time in {MPI} Programs on an Energy-constrained, Power-scalable Cluster}, + booktitle = {Proceedings of the Eleventh ACM SIGPLAN Symposium on Principles and Practice of Parallel Programming}, + series = {PPoPP '06}, + year = {2006}, + isbn = {1-59593-189-9}, + location = {New York, New York, USA}, + pages = {230--238}, + numpages = {9}, + doi = {10.1145/1122971.1123006}, + acmid = {1123006}, + publisher = {ACM}, + address = {New York, NY, USA}, + keywords = {MPI, energy, modeling, power, prediction} +} + +@inproceedings{21, + added-at = {2011-12-01T00:00:00.000+0100}, + author = {Rauber, and Rünger, Gudula}, + booktitle = {SpringSim (CNS)}, + crossref = {conf/springsim/2011-3}, + editor = {Abhari, Abdolreza}, + ee = {http://dl.acm.org/citation.cfm?id=2048418}, + interhash = {6276d16bd7969248c4e77f8f64830d50}, + intrahash = {1cd7e6aa9e6f55f1185c3157b9cde5c1}, + keywords = {dblp}, + pages = {11-18}, + publisher = {SCS/ACM}, + timestamp = {2011-12-01T00:00:00.000+0100}, + title = {Modeling the energy consumption for concurrent executions of parallel tasks.}, + year = {2011} +} + +@inproceedings{22, + author = {Ge, Rong and Feng, Xizhou and Cameron, Kirk W.}, + title = {Performance-constrained Distributed DVS Scheduling for Scientific Applications on Power-aware Clusters}, + booktitle = {Proceedings of the 2005 ACM/IEEE Conference on Supercomputing}, + series = {SC '05}, + year = {2005}, + isbn = {1-59593-061-2}, + pages = {34--}, + doi = {10.1109/SC.2005.57}, + acmid = {1105799}, + publisher = {IEEE Computer Society}, + address = {Washington, DC, USA} +} + + +@inproceedings{23, + author = {Feng, Xizhou and Ge, Rong and Cameron, Kirk W.}, + title = {Power and Energy Profiling of Scientific Applications on Distributed Systems}, + booktitle = {Proceedings of the 19th IEEE International Parallel and Distributed Processing Symposium (IPDPS'05) - Papers - Volume 01}, + series = {IPDPS '05}, + year = {2005}, + isbn = {0-7695-2312-9}, + pages = {34--}, + doi = {10.1109/IPDPS.2005.346}, + acmid = {1054376}, + publisher = {IEEE Computer Society}, + address = {Washington, DC, USA} +} + +@inproceedings{24, + added-at = {2009-11-27T00:00:00.000+0100}, + author = {Chen, Yen-Jun and Hsu, Ching-Hsien and Li, Kuan-Ching and Chang, Hsi-Ya and Wang, Shuen-Tai}, + booktitle = {Infoscale}, + crossref = {conf/infoscale/2009}, + date = {2009-11-27}, + description = {dblp}, + editor = {Mueller, Peter and Cao, Jian-Nong and Wang, Cho-Li}, + ee = {http://dx.doi.org/10.1007/978-3-642-10485-5_8}, + interhash = {d191ac30e6c4bd27288ffdf9e6d0e815}, + intrahash = {4601b8a777bdf956bb48fa611b7556f5}, + isbn = {978-3-642-10484-8}, + keywords = {dblp}, + pages = {108-120}, + publisher = {Springer}, + series = {Lecture Notes of the Institute for Computer Sciences, Social Informatics and Telecommunications Engineering}, + timestamp = {2009-11-27T00:00:00.000+0100}, + title = {Power Consumption Optimization of {MPI} Programs on Multi-core Clusters.}, + volume = {18}, + year = {2009} +} + +@inproceedings{25, + author = {Laurenzano, Michael A. and Meswani, Mitesh and Carrington, Laura and Snavely, Allan and Tikir, Mustafa M. and Poole, Stephen}, + title = {Reducing Energy Usage with Memory and Computation-aware Dynamic Frequency Scaling}, + booktitle = {Proceedings of the 17th International Conference on Parallel Processing - Volume Part I}, + series = {Euro-Par'11}, + year = {2011}, + isbn = {978-3-642-23399-9}, + location = {Bordeaux, France}, + pages = {79--90}, + numpages = {12}, + acmid = {2033356}, + publisher = {Springer-Verlag}, + address = {Berlin, Heidelberg}, + keywords = {benchmarking, dynamic voltage frequency scaling, energy optimization, high performance computing, memory latency} +} + +@article{26, + author = {Rizvandi, Nikzad Babaii and Taheri, Javid and Zomaya, Albert Y.}, + title = {Some Observations on Optimal Frequency Selection in {DVFS}-based Energy Consumption Minimization}, + journal = {J. Parallel Distrib. Comput.}, + issue_date = {August, 2011}, + volume = {71}, + number = {8}, + month = aug, + year = {2011}, + issn = {0743-7315}, + pages = {1154--1164}, + numpages = {11}, + doi = {10.1016/j.jpdc.2011.01.004}, + acmid = {1998949}, + publisher = {Academic Press, Inc.}, + address = {Orlando, FL, USA}, + keywords = {DVFS, Energy efficiency, HPCS, Scheduling} +} + +@article{27, + author = {Dhiman, Gaurav and Rosing, Tajana \v{S}imunic}, + title = {System-level Power Management Using Online Learning}, + journal = {Trans. Comp.-Aided Des. Integ. Cir. Sys.}, + issue_date = {May 2009}, + volume = {28}, + number = {5}, + month = may, + year = {2009}, + issn = {0278-0070}, + pages = {676--689}, + numpages = {14}, + doi = {10.1109/TCAD.2009.2015740}, + acmid = {1656937}, + publisher = {IEEE Press}, + address = {Piscataway, NJ, USA}, + keywords = {Dynamic voltage frequency scaling, dynamic voltage frequency scaling, energy-performance trade-off, online learning, power management} +} + +@INPROCEEDINGS{28, +author={Yongpan Liu and Huazhong Yang and Dick, R.P. and Hui Wang and Li Shang}, +booktitle={Quality Electronic Design, 2007. ISQED '07. 8th International Symposium on}, +title={Thermal vs Energy Optimization for {DVFS}-Enabled Processors in Embedded Systems}, +year={2007}, +month={March}, +pages={204-209}, +keywords={circuit optimisation;embedded systems;integrated circuit design;low-power electronics;microprocessor chips;nonlinear programming;thermal management (packaging);DVFS-enabled processors;application peak temperature;cooling costs;dynamic voltage voltage;embedded systems;energy consumption;frequency scaling;nonlinear programming;power optimization;run-time thermal emergencies;system thermal profile;thermal optimization;thermal-constrained energy optimization;Cooling;Cost function;Design optimization;Dynamic voltage scaling;Embedded system;Energy consumption;Frequency;Power system planning;Runtime;Temperature}, +doi={10.1109/ISQED.2007.158} +} + +@INPROCEEDINGS{29, +author={Fen Xie and Martonosi, M. and Malik, S.}, +booktitle={Low Power Electronics and Design, 2005. ISLPED '05. Proceedings of the 2005 International Symposium on}, +title={Bounds on power savings using runtime dynamic voltage scaling: an exact algorithm and a linear-time heuristic approximation}, +year={2005}, +month={Aug}, +pages={287-292}, +keywords={approximation theory;energy conservation;low-power electronics;power consumption;power supply circuits;DVFS policy;discrete voltage/frequency voltage level;dynamic voltage scaling;dynamic voltage/frequency scaling;energy reduction technique;exponential algorithm;linear-time heuristic approximation;power reduction technique;switching cost;Approximation algorithms;Costs;Dynamic voltage scaling;Energy consumption;Frequency;Linear approximation;Power system modeling;Runtime;Semiconductor device modeling;Upper bound}, +doi={10.1109/LPE.2005.195529} +} + +@INPROCEEDINGS{30, +author={Lizhe Wang and von Laszewski, G. and Dayal, J. and Fugang Wang}, +booktitle={Cluster, Cloud and Grid Computing (CCGrid), 2010 10th IEEE/ACM International Conference on}, +title={Towards Energy Aware Scheduling for Precedence Constrained Parallel Tasks in a Cluster with {DVFS}}, +year={2010}, +month={May}, +pages={368-377}, +keywords={environmental factors;parallel processing;power aware computing;scheduling;workstation clusters;dynamic voltage frequency scaling technique;energy aware scheduling heuristics;green service level agreement;high end computing;precedence constrained parallel tasks;Computational modeling;Concurrent computing;Costs;Dynamic voltage scaling;Energy consumption;Frequency;Grid computing;High performance computing;Power engineering computing;Processor scheduling;Cluster Computing;Green Computing;Task Scheduling}, +doi={10.1109/CCGRID.2010.19} +} + +@article{31, +author = {Yu-Liang Chou and Shaoshan Liu and Eui-Young Chung and Jean-Luc Gaudiot}, +title = {An Energy and Performance Efficient {DVFS} Scheme for Irregular Parallel Divide-and-Conquer Algorithms on the {Intel SCC}}, +journal ={IEEE Computer Architecture Letters}, +volume = {99}, +number = {RapidPosts}, +issn = {1556-6056}, +year = {2013}, +pages = {1}, +doi = {http://doi.ieeecomputersociety.org/10.1109/L-CA.2013.1}, +publisher = {IEEE Computer Society}, +address = {Los Alamitos, CA, USA} +} + +@article{32, +title = "Energy-aware simulation with \{DVFS\} ", +journal = "Simulation Modelling Practice and Theory ", +volume = "39", +number = "0", +pages = "76 - 91", +year = "2013", +note = "S.I.Energy efficiency in grids and clouds ", +issn = "1569-190X", +doi = "http://dx.doi.org/10.1016/j.simpat.2013.04.007", +author = {Tom Guérout and Thierry Monteil and Georges Da Costa and Rodrigo Neves Calheiros and Rajkumar Buyya and Mihai Alexandru} + +} + +@INPROCEEDINGS{33, +author={Kappiah, N. and Freeh, Vincent W. and Lowenthal, D.K.}, +booktitle={Supercomputing, 2005. Proceedings of the ACM/IEEE SC 2005 Conference}, +title={Just In Time Dynamic Voltage Scaling: Exploiting Inter-Node Slack to Save Energy in {MPI} Programs}, +year={2005}, +month={Nov}, +pages={33-33}, +keywords={Computer science;Dynamic voltage scaling;Energy consumption;Energy efficiency;Frequency;Gears;Jitter;Microprocessors;Performance loss;Permission}, +doi={10.1109/SC.2005.39} +} + +@inproceedings{34, + author = {Cochran, Ryan and Hankendi, Can and Coskun, Ayse and Reda, Sherief}, + title = {Identifying the Optimal Energy-efficient Operating Points of Parallel Workloads}, + booktitle = {Proceedings of the International Conference on Computer-Aided Design}, + series = {ICCAD '11}, + year = {2011}, + isbn = {978-1-4577-1398-9}, + location = {San Jose, California}, + pages = {608--615}, + numpages = {8}, + acmid = {2132464}, + publisher = {IEEE Press}, + address = {NJ, USA} +} + +@article{35, +title = "Adaptive energy-efficient scheduling algorithm for parallel tasks on homogeneous clusters ", +journal = "Journal of Network and Computer Applications ", +volume = "", +number = "0", +pages = " - ", +year = "2013", +note = "", +issn = "1084-8045", +doi = "http://dx.doi.org/10.1016/j.jnca.2013.10.009", +author = {Wei Liu and Wei Du and Jing Chen and Wei Wang and GuoSun Zeng} + +} + +@article{36, + author = {Kim, Nam Sung and Austin, Todd and Blaauw, David and Mudge, Trevor and Flautner, Kriszti\'{a}n and Hu, Jie S. and Irwin, Mary Jane and Kandemir, Mahmut and Narayanan, Vijaykrishnan}, + title = {Leakage Current: Moore's Law Meets Static Power}, + journal = {Computer}, + issue_date = {December 2003}, + volume = {36}, + number = {12}, + month = dec, + year = {2003}, + issn = {0018-9162}, + pages = {68--75}, + numpages = {8}, + doi = {10.1109/MC.2003.1250885}, + acmid = {957974}, + publisher = {IEEE Computer Society Press}, + address = {Los Alamitos, CA, USA} +} + +@inproceedings{37, + author = {Le Sueur, Etienne and Gernot Heiser}, + month = {October}, + year = {2010}, + title = {Dynamic Voltage and Frequency Scaling: The Laws of Diminishing Returns}, + booktitle = {Proceedings of the 2010 Workshop on Power Aware Computing and Systems (HotPower'10)}, + address = {Vancouver, Canada} + } + +@inproceedings{38, + author = {Cochran, Ryan and Hankendi, Can and Coskun, Ayse K. and Reda, Sherief}, + title = {Pack \& Cap: Adaptive {DVFS} and Thread Packing Under Power Caps}, + booktitle = {Proceedings of the 44th Annual IEEE/ACM International Symposium on Microarchitecture}, + series = {MICRO-44}, + year = {2011}, + isbn = {978-1-4503-1053-6}, + location = {Porto Alegre, Brazil}, + pages = {175--185}, + numpages = {11}, + doi = {10.1145/2155620.2155641}, + acmid = {2155641}, + publisher = {ACM}, + address = {NY, USA} +} + +@INPROCEEDINGS{39, +author={Dhiman, G. and Rosing, T.S.}, +booktitle={Low Power Electronics and Design (ISLPED), 2007 ACM/IEEE International Symposium on}, +title={Dynamic voltage frequency scaling for multi-tasking systems using online learning}, +year={2007}, +month={Aug}, +pages={207-212}, +keywords={Linux;computer aided instruction;multiprogramming;power aware computing;program compilers;system monitoring;Intel PXA27x;Linux 2.6.9;dynamic voltage frequency scaling;multitasking systems;online learning;processors runtime statistics;Batteries;Computer applications;Delay;Dynamic voltage scaling;Embedded system;Energy consumption;Frequency estimation;Linux;Power engineering computing;Statistics;dynamic voltage frequency scaling;online learning}, +doi={10.1145/1283780.1283825} +} + +@inproceedings{40, + author = {Azevedo, A. and Issenin, I. and Cornea, R. and Gupta, R. and Dutt, N. and Veidenbaum, A. and Nicolau, A.}, + title = {Profile-Based Dynamic Voltage Scheduling Using Program Checkpoints}, + booktitle = {Proceedings of the Conference on Design, Automation and Test in Europe}, + series = {DATE '02}, + year = {2002}, + isbn = {0-7695-1471-5}, + pages = {168-175}, + acmid = {874373}, + publisher = {IEEE Computer Society}, + address = {Washington, DC, USA} +} + +@inproceedings{41, + author = {Miftakhutdinov, Rustam and Ebrahimi, Eiman and Patt, Yale N.}, + title = {Predicting Performance Impact of {DVFS} for Realistic Memory Systems}, + booktitle = {Proceedings of the 2012 45th Annual IEEE/ACM International Symposium on Microarchitecture}, + series = {MICRO-45}, + year = {2012}, + isbn = {978-0-7695-4924-8}, + location = {Vancouver, B.C., CANADA}, + pages = {155--165}, + numpages = {11}, + doi = {10.1109/MICRO.2012.23}, + acmid = {2457493}, + publisher = {IEEE Computer Society}, + address = {Washington, DC, USA} +} + +@ARTICLE{42, +author={Dhiman, G. and Rosing, T.S.}, +journal={Computer-Aided Design of Integrated Circuits and Systems, IEEE Transactions on}, +title={System-Level Power Management Using Online Learning}, +year={2009}, +month={May}, +volume={28}, +number={5}, +pages={676-689}, +keywords={power aware computing;DPM policies;Intel PXA27x core;device leakage characteristics;dynamic power management;dynamic voltage-frequency scaling problems;hard disk drive;online learning;system-level power management;workload characterization;Dynamic voltage frequency scaling;energy-performance trade-off;online learning;power management}, +doi={10.1109/TCAD.2009.2015740}, +ISSN={0278-0070} +} + +@MISC{43, + title = {{TOP500 Supercomputers Sites}}, + url = {http://www.top500.org} +} + +@MISC{SimGrid.org, + title = {{SimGrid: Versatile Simulation of Distributed Systems}}, + url = {http://simgrid.org} +} + +@MISC{44, + author = {{NASA Advanced Supercomputing Division}}, + title = {{NAS} Parallel Benchmarks}, + url = {http://www.nas.nasa.gov/publications/npb.html}, + month = mar, + year = 2012, + publisher = {https://www.nas.nasa.gov/publications/npb.html} +} + + +@INPROCEEDINGS{45, +author={J. Charr, R. Couturier, A. and Fanfakh, A. and Giersch}, + +title={Dynamic Frequency Scaling for Energy Consumption +Reduction in Distributed MPI Programs}, +booktitle = {The 12th IEEE International Symposium on Parallel and Distributed Processing with Applications}, +year={2014}, +month={Aug}, +pages={1-6}, +publisher = {IEEE Computer Society}, +address = {Milan, Italy} + +} + +@InProceedings{Casanova:2008:SGF:1397760.1398183, + author = {Casanova, Henri and Legrand, Arnaud and Quinson, + Martin}, + title = {{SimGrid}: a Generic Framework for Large-Scale + Distributed Experiments}, + booktitle = {Proceedings of the Tenth International Conference on + Computer Modeling and Simulation}, + series = {UKSIM '08}, + year = {2008}, + isbn = {978-0-7695-3114-4}, + pages = {126--131}, + numpages = {6}, + doi = {10.1109/UKSIM.2008.28}, + acmid = {1398183}, + publisher = {IEEE Computer Society}, + address = {Washington, DC, USA} +} + +@article{46, + author = {Zhuo, Jianli and Chakrabarti, Chaitali}, + title = {Energy-efficient Dynamic Task Scheduling Algorithms for DVS Systems}, + journal = {ACM Trans. Embed. Comput. Syst.}, + issue_date = {February 2008}, + volume = {7}, + number = {2}, + month = jan, + year = {2008}, + issn = {1539-9087}, + pages = {17:1--17:25}, + articleno = {17}, + numpages = {25}, + url = {http://doi.acm.org/10.1145/1331331.1331341}, + doi = {10.1145/1331331.1331341}, + acmid = {1331341}, + publisher = {ACM}, + address = {New York, NY, USA}, + keywords = {DVS system, Dynamic task scheduling, energy minimization, optimal scaling factor, real time} +} + +@MISC{47, + title = {Intel microprocessor export compliance metrics}, + url = {http://www.intel.com/support/processors/sb/CS-017346.htm} +} + +@techreport{48, + title = {Energy efficiency evaluation and benchmarking of {AFRL}'s Condor high performance computer}, + url = {http://oai.dtic.mil/oai/oai?verb=getRecord&metadataPrefix=html&identifier=ADA548738}, + urldate = {2014-10-16}, + institution = {{DTIC} Document}, + author = {Luley, Ryan and Usmail, Courtney and Barnell, Mark}, + year = {2011}, + file = {a548738.pdf:files/30/a548738.pdf:application/pdf} +} \ No newline at end of file -- 2.39.5