From d815672ced11d2f4cb546a7587c34860c26e2864 Mon Sep 17 00:00:00 2001 From: Christian Pape Date: Fri, 21 Apr 2017 17:20:33 +0200 Subject: [PATCH] Layout auf IEEE angepasst --- .gitignore | 1 + 2-environment.tex | 14 +- 3-requirements.tex | 1 - 4-1-update_mechanism.tex | 12 +- 4-3-automatic-deployment.tex | 2 +- IEEEtran.bst | 2432 +++++++++++++++++ IEEEtran.cls | 4737 ++++++++++++++++++++++++++++++++++ Makefile | 6 + index.bib => esper-ota.bib | 2 +- esper-ota.tex | 473 ++++ index.pdf | Bin 240743 -> 0 bytes index.tex | 43 - 12 files changed, 7664 insertions(+), 59 deletions(-) create mode 100755 IEEEtran.bst create mode 100755 IEEEtran.cls create mode 100755 Makefile rename index.bib => esper-ota.bib (98%) mode change 100644 => 100755 create mode 100755 esper-ota.tex delete mode 100644 index.pdf delete mode 100644 index.tex diff --git a/.gitignore b/.gitignore index 7451ee9..e3f4458 100644 --- a/.gitignore +++ b/.gitignore @@ -11,3 +11,4 @@ *.snm *.toc *.vrb +esper-ota.pdf diff --git a/2-environment.tex b/2-environment.tex index bb9fafa..bba769f 100644 --- a/2-environment.tex +++ b/2-environment.tex @@ -1,20 +1,20 @@ \section{Environment} -The home-automation projects developed by \textit{Magrathea Laboratories e.V.}\autocite{maglab}, the local hackerspace in Fulda, are used to provide control over the different actors and sensors in the foundations rooms to visitors and members locally and remotely. +The home-automation projects developed by \textit{Magrathea Laboratories e.V.}\cite{maglab}, the local hackerspace in Fulda, are used to provide control over the different actors and sensors in the foundations rooms to visitors and members locally and remotely. -The different components available (like the door status, power sockets, projectors and screens, temperature sensors, etc.) are all managed by the home-automation controller driven by the software \textit{home-assistant}\autocite{HASS}. +The different components available (like the door status, power sockets, projectors and screens, temperature sensors, etc.) are all managed by the home-automation controller driven by the software \textit{home-assistant}\cite{HASS}. It provides direct control over all existing components using a web UI and allows to define rules and automations on how these components interact. \begin{sloppypar} -The hackerspace has developed a common software and hardware platform for its home-automation projects called \textit{ESPer}\autocite{ESPer}. -For the hardware, boards based on the \textit{ESP8266} micro-controllers, mostly \textit{ESP-01s}\autocite{ESP-01s} boards, are used in combination with self-developed power supplies and use-case specific hardware components. +The hackerspace has developed a common software and hardware platform for its home-automation projects called \textit{ESPer}\cite{ESPer}. +For the hardware, boards based on the \textit{ESP8266} micro-controllers, mostly \textit{ESP-01s}\cite{ESP-01s} boards, are used in combination with self-developed power supplies and use-case specific hardware components. \end{sloppypar} These boards provide a Microcontroller Unit (MCU) fast enough for all required scenarios and integrate WiFi without requiring any extra components. -The software is based on the \textit{Sming}\autocite{Sming} library, which in turn is based on the open source SDK for \textit{ESP8266} and integrates a lot of other software components for easy use. -To build the software, a \textit{Makefile}\autocite{make} is used, which provides a simple way for reproducible builds. +The software is based on the \textit{Sming}\cite{Sming} library, which in turn is based on the open source SDK for \textit{ESP8266} and integrates a lot of other software components for easy use. +To build the software, a \textit{Makefile}\cite{make} is used, which provides a simple way for reproducible builds. -For communication with the controller, the \textit{MQTT}\autocite{MQTT} protocol is used. +For communication with the controller, the \textit{MQTT}\cite{MQTT} protocol is used. It provides a lightweight messaging mechanism implementing the publish-subscribe pattern that allows devices to listen for commands and publish their current state to the controller and other interested parties. The controller software has out-of-the-box support for this protocol, which allows easy integration of all different device types using the same patterns. diff --git a/3-requirements.tex b/3-requirements.tex index 6c8bec5..de3b358 100644 --- a/3-requirements.tex +++ b/3-requirements.tex @@ -3,7 +3,6 @@ The following requirements are defined as global project goals and have been refined during the work on the project multiple times. \begin{itemize} - \item The systems should be able to perform updates on the release of new software without administrative interaction. If a new version of the firmware is published, it should be prepared automatically for installation to the target devices. All these devices should then download and install the new software version and start using it subsequently, if no errors have occurred during the process. diff --git a/4-1-update_mechanism.tex b/4-1-update_mechanism.tex index 8189dd1..14211fe 100644 --- a/4-1-update_mechanism.tex +++ b/4-1-update_mechanism.tex @@ -12,7 +12,7 @@ If the option is skipped, the code for update management is excluded during the Initially, each device queries the update server regularly for the current firmware version and initializes the update process if remote and local versions differ. To do so, the update server provides a file for each device type containing the available version identifier, which is stored beside the firmware binary files. -These version identifier files are provided by the update server using \textit{HTTP 1.1}\autocite{HTTP_1.1} under the following path pattern: \texttt{\${DEVICE}.version} (whereas \texttt{\${DEVICE}} is the device type name). +These version identifier files are provided by the update server using \textit{HTTP 1.1}\cite{HTTP_1.1} under the following path pattern: \texttt{\${DEVICE}.version} (whereas \texttt{\${DEVICE}} is the device type name). The version identifier can be an arbitrary string as the content is not interpreted semantically but only compared to the version identifier used during build time. Each device tries to fetch the version identifier file once every hour. @@ -43,14 +43,14 @@ irom0_0_seg : org = ( 0x40200000 // The memory mapping address len = ( 1M / 2 - 0x2010 ) // Half ROM size excl. bootloader \end{lstlisting} -\begin{wrapfigure}{r}{0.3\textwidth} -\centerline{\includegraphics[scale=0.6]{flash_layout.pdf}} +\begin{figure}[htbp] +\centering\includegraphics[scale=0.6]{flash_layout.pdf} \caption{The flash layout used for two ROMs.} \label{fig:memory_layout} -\end{wrapfigure} +\end{figure} Microcontroller boards based on the \textit{ESP8266} MCU are mostly following the same layout: the MCU is attached to a flash chip which contains the bootloader, firmware and other application data. -The memory mapping mechanism of the MCU allows only a single page of 1 MB of flash to be mapped at the same time\autocite{ESP8266_Memory_Map} and the selected range must be aligned to 1 MB blocks. +The memory mapping mechanism of the MCU allows only a single page of 1 MB of flash to be mapped at the same time\cite{ESP8266_Memory_Map} and the selected range must be aligned to 1 MB blocks. As the \textit{ESP-01s} is only equipped with 1 MB of flash, this means that the whole memory is mapped to a contiguous address space. Therefore, the second ROM can not be re-mapped to have the same start address as the first ROM. While the firmware is executed without any dynamic linking mechanism and the chip does not support position independent code, the addresses used in the ROMs are dependent to the offset at which the firmware is stored. @@ -60,7 +60,7 @@ The two resulting firmware binary files are both provided for download via HTTP Listing~\ref{lst:linker_script} shows the only difference between the two linker scripts, where \texttt{\${SLOT}} must be replaced with the slot number according to the current build. In addition to the two ROMs, the flash must provide room for the bootloader and its configuration. -\textit{rBoot}\autocite{rBoot} has been choosen as it is integrated within the \textit{Sming} framework and allows to boot to multiple ROMs. +\textit{rBoot}\cite{rBoot} has been choosen as it is integrated within the \textit{Sming} framework and allows to boot to multiple ROMs. For configuration, an \textit{rBoot} specific structure is placed in the flash at a well-known location directly after the space reserved for the bootloader code. This structure contains, among other things, the target offsets for all known ROMs and the number of the ROM to boot from on next reboot. diff --git a/4-3-automatic-deployment.tex b/4-3-automatic-deployment.tex index fa9ea69..1fbb8e2 100644 --- a/4-3-automatic-deployment.tex +++ b/4-3-automatic-deployment.tex @@ -2,7 +2,7 @@ The source code of the \textit{ESPer} project is published into a \textit{GIT} source code repository which is provided by the hackerspace. To avoid interferences between different build environments on developers computers and roll out new versions as early as possible, the code has been integrated into a continuous integration (CI) system. -The CI, which is based on \textit{drone}\autocite{drone} and provided as part of the hackerspace infrastructure, allows to execute commands on each version published into the \textit{GIT} repository. +The CI, which is based on \textit{drone}\cite{drone} and provided as part of the hackerspace infrastructure, allows to execute commands on each version published into the \textit{GIT} repository. Therefore a \textit{drone} configuration file as shown in Listing~\ref{lst:drone} has been added to the source code as \texttt{.drone.yml}. \begin{sloppypar} diff --git a/IEEEtran.bst b/IEEEtran.bst new file mode 100755 index 0000000..1c7ceac --- /dev/null +++ b/IEEEtran.bst @@ -0,0 +1,2432 @@ +%% +%% IEEEtran.bst +%% BibTeX Bibliography Style file for IEEE Journals and Conferences (unsorted) +%% Version 1.13 (2008/09/30) +%% +%% Copyright (c) 2003-2008 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. +% +% 1.13 (2008/09/30) +% 1. Fixed bug with edition number to ordinal conversion. Thanks to +% Michael Roland for reporting this and correcting the algorithm. + + +%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% +%% 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.13" } +FUNCTION{bst.file.date} { "2008/09/30" } +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$ "" } +%% Turned off for MESH2013 +% { "\emph{" swap$ * "}" * } + { skip$ } +%% + 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 +% two least significant digits determine the ordinal form. +FUNCTION {num.to.ordinal} +{ duplicate$ #-2 #1 substring$ "1" = + { bbl.th * } + { 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$ +} + +% 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$ +} + +% WARNING: This function was modified to adhere to the formatting rules +% of MESH2013 conference for entries with both month and year specified. +% It will not work properly otherwise. +FUNCTION {format.date.electronic} +{ year "year" bibinfo.check duplicate$ empty$ + month "month" 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$ * } + { "[retrieved: " 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.date "year" output.warn + format.pages output + 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.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 + format.date.electronic 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 100755 index 0000000..4da8342 --- /dev/null +++ b/IEEEtran.cls @@ -0,0 +1,4737 @@ +%% +%% 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{Figure} +\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 + +%ADDED TODO if no conference option: +%%\renewcommand{\and}[1][\hfill]{\end{@IEEEauthorhalign}#1\begin{@IEEEauthorhalign}}% +%TODO \renewcommand{\and}[1][\hfill]{\end{@IEEEauthorhalign}#1\begin{@IEEEauthorhalign}}% + +% 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\noindent\@IEEEabskeysecsize\bfseries\leavevmode\kern-0pt\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/Makefile b/Makefile new file mode 100755 index 0000000..e15d61b --- /dev/null +++ b/Makefile @@ -0,0 +1,6 @@ +all: + - pdflatex esper-ota + - pdflatex esper-ota + - bibtex esper-ota + - pdflatex esper-ota + - pdflatex esper-ota diff --git a/index.bib b/esper-ota.bib old mode 100644 new mode 100755 similarity index 98% rename from index.bib rename to esper-ota.bib index 352ca24..52bd1a5 --- a/index.bib +++ b/esper-ota.bib @@ -74,7 +74,7 @@ author="ESP8266 community wiki", title="ESP8266 Memory Map", year=2016, - url="http://web.archive.org/web/20161118224802/http://www.esp8266.com/wiki/doku.php?id=esp8266_memory_map", + url="http://web.archive.org/web/20161118224802/http://www.esp8266.com/wiki/doku.php?id=esp8266\_memory\_map", urldate="2017-01-30" ) diff --git a/esper-ota.tex b/esper-ota.tex new file mode 100755 index 0000000..c505035 --- /dev/null +++ b/esper-ota.tex @@ -0,0 +1,473 @@ +%% 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[10pt,conference,compsocconf]{IEEEtran} +%\documentclass[10pt]{IEEEtran} +\usepackage{times} + +\usepackage{caption} +\captionsetup{font=footnotesize,justification=centering,labelsep=period} + +% 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} + +\usepackage{multirow} + +% 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. ) + +\usepackage{listings} +\usepackage{color} +\lstset{ + language=c++, + columns=flexible, + basicstyle={\small\ttfamily}, + frame=tb, + keepspaces=true, + breaklines=true, + breakatwhitespace=true, +} + +% correct bad hyphenation here +\hyphenation{op-tical net-works semi-conduc-tor} + +%\parskip 6pt plus 2pt minus 1pt +\parskip 3pt plus 2pt minus 1pt + +\pagestyle{empty} +\begin{document} +\pagenumbering{gobble} +% +% paper title +% can use linebreaks \\ within to get better formatting as desired +\title{\textbf{\Large Implement Updates \textit{Over the Air} for \textit{ESP8266} microcontrollers}\\[0.2ex]} +% \\[-1.5ex] + + + +% author names and affiliations +% use a multiple column layout for up to three different +% affiliations +%\author{\IEEEauthorblockN{~\\[-0.4ex]\large Ngoc Khanh Truong\\[0.3ex]\normalsize} +%\IEEEauthorblockA{Department of Applied Computer Science\\ +%Fulda University of Applied Sciences\\ +%Fulda, Germany\\ +%Email: {\tt Ngoc.K.Truong@cs.hs-fulda.de}} +%\and +%\IEEEauthorblockN{~\\[-0.4ex]\large Christian Pape\\[0.3ex]\normalsize} +%\IEEEauthorblockA{Department of Applied Computer Science\\ +%Fulda University of Applied Sciences\\ +%Fulda, Germany\\ +%Email: {\tt christian.pape@cs.hs-fulda.de}} +%\and +%\IEEEauthorblockN{~\\[-0.4ex]\large Sebastian Rieger\\[0.3ex]\normalsize} +%\IEEEauthorblockA{Department of Applied Computer Science\\ +%Fulda University of Applied Sciences\\ +%Fulda, Germany\\ +%Email: {\tt sebastian.rieger@cs.hs-fulda.de} +%}} + +% 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{Dustin Frisch\IEEEauthorrefmark{1}, +%Christian Pape\IEEEauthorrefmark{2}, +%Sebastian Rieger\IEEEauthorrefmark{2} +} +\IEEEauthorblockA{\IEEEauthorrefmark{1}Department of Applied Computer Science\\ +Fulda University of Applied Sciences, +Fulda, Germany\\ Email: Dustin.Frisch@cs.hs-fulda.de} +%\IEEEauthorblockA{\IEEEauthorrefmark{2}Department of Applied Computer Science\\ +%Fulda University of Applied Sciences, +%Fulda, Germany\\ Email: \{christian.pape, sebastian.rieger\} @cs.hs-fulda.de} +} + + + +% use for special paper notices +%\IEEEspecialpapernotice{(Invited Paper)} + + + + +% make the title area +\maketitle + + +\begin{abstract} + This article describes the implementation of durable and stable system for building firmware updates for embedded systems based on \textit{ESP8266}\cite{ESP8266} microcontrollers. This includes the mechanisms used to build the updates, distribute and install them on the device. +\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 + +\begin{IEEEkeywords} +Anything; Something; Everything else.% +\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 + +\input{1-introduction} +\input{2-environment} +\input{3-requirements} +\input{4-implementation} +\input{5-conclusion} + +% ************************************ + +\bibliographystyle{IEEEtran} +\bibliography{esper-ota} + +% that's all folks +\end{document} diff --git a/index.pdf b/index.pdf deleted file mode 100644 index b1267fb0b189dda8df0a7daa30ee04b23823fcf6..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 240743 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

M7Zgu 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%0D;0Y~5bn^9R$& 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%0D=*F^zYs#`Zgpksz5G=zU93 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�Ftp-{r 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≺g&g2SX9;H(C#TT%?;EBmC<7@g1shwGJ5 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 x+_11G4W6{T@9BJDb%)FNal7(g*R+3ty