Bare Demo of Immersive Articles for the IEEE Computational Intelligence Magazine

II. Ease of Use

Maintaining the Integrity of the Specifications

The index.html file is used to format your interactive paper and style the text. All margins, column widths, line spaces, and text fonts are prescribed; please do not alter them. You may note peculiarities. For example, the limited width of the article. This measurement and others are deliberate, using specifications that anticipate your paper as one part of the entire computational intelligence magazine and its online pendant on IEEE Xplore, and not as an independent document. Please do not revise any of the current designations.

Prepare Your Paper Before Styling

Before you begin to format your paper, first write and save the content as a separate text file. Complete all content and organizational editing before formatting. Please note subsections Abbrevations and Acronyms to Some Common Mistakes below for more information on proofreading, spelling and grammar.

Keep your text and graphic files separate until after the text has been formatted and styled. Do not number text heads, this will be done during the transfer to IEEEXplore for you.

Abbreviations and Acronyms

Define abbreviations and acronyms the first time they are used in the text, even after they have been defined in the abstract. Abbreviations such as IEEE, SI, MKS, CGS, ac, dc, and rms do not have to be defined. Do not use abbreviations in the title or heads unless they are unavoidable.

Units

• Use either SI (MKS) or CGS as primary units. (SI units are encouraged.) English units may be used as secondary units (in parentheses). An exception would be the use of English units as identifiers in trade, such as "3.5-inch disk drive".
• Avoid combining SI and CGS units, such as current in amperes and magnetic field in oersteds. This often leads to confusion because equations do not balance dimensionally. If you must use mixed units, clearly state the units for each quantity that you use in an equation.
• Do not mix complete spellings and abbreviations of units: $$Wb/m^2$$ or "webers per square meter", not $$webers/m^2$$. Spell out units when they appear in text: ". . . a few henries", not ". . . a few H".
• Use a zero before decimal points: "0.25", not ".25".
• Use $$cm^3$$, not $$cc$$.

Equations

The interactive article does not require to number equations, however they can be linked using the tag <a href="#id"> </a> and a corresponding id of the element to be linked. To make your equations more compact, you may use the solidus (~/~), the exp function, or appropriate exponents. Italicize Roman symbols for quantities and variables, but not Greek symbols. Use a long dash rather than a hyphen for a minus sign. Punctuate equations with commas or periods when they are part of a sentence, as in: $$a+b=\gamma$$.

Be sure that the symbols in your equation have been defined before or immediately following the equation. To define inline equations you can surround them with double-$ symbol as in $$1+1=2$$ and add the 'class="inline-math' to the surrounding tags.

Figures and Tables

Place figures and tables close to the paragraph in which they are discussed. Captions should be below the figures and tables. Insert figures and tables after they are cited in the text. Use the abbreviation "Fig. 1", even at the beginning of a sentence.

Column 1	Column 2 of fixed width	Column 3 aligned left
Data 1,1	Data 1,2	a very very very very very long centered text
$$1\times 1 = 1$$	$$\pi$$	$$\binom{n}{k} =\prod _{j=1}^{k}{\frac {n+1-j}{j}}$$

Table 1: This is an example of a table caption.

Figure 1: Example of a figure caption.

Figure Labels: Use words rather than symbols or abbreviations when writing Figure axis labels to avoid confusing the reader. As an example, write the quantity "Magnetization", or "Magnetization, $$M$$", not just "$$M$$". If including units in the label, present them within parentheses. Do not label axes only with units. In the example, write "Magnetization ($$A/m$$)" or "Magnetization $$\{A[m(1)]\}$$", not just "$$A/m$$". Do not label axes with a ratio of quantities and units. For example, write "Temperature ($$K$$)", not "Temperature/$$K$$".

Interactive Figures and Code

Note, that in contrast to classical papers, the web article can include animations, videos, sounds, etc.. Due to technical constraints, it will not be possible to embed iframes!

Finally, you can freely use javascript libraries as long as they can be included self-contained in the files you submit. Meaning, scripts cannot be imported using an url. This should ensure a consistent presentation of the article. Interactive components can be embedded as figure. and should be formatted as such. Libraries such as d3.js [1] and three.js[2] may be helpful in producing interactive visualizations, but do not let your own creativity be limited by these recommendations.

You can add an introductory text for interactive elements to motivate users to check out the following block.

Figure 2:
Example of an interactive figure: Introducing the 8-Queens problem. Drag and drop queens to change their position. Try to position all queens such that no two queens share the same row, column, or diagonal. Queens that threaten each other will be highlighted in red. In case you found a solution all queens will be highlighted in green.

Note, that we recommend to place the script import just behind the corresponding interactive figure, such that we can easily match them later on.

Some Common Mistakes

• The word "data" is plural, not singular.
• The subscript for the permeability of vacuum $$\mu_{0}$$, and other common scientific constants, is zero with subscript formatting, not a lowercase letter "o".
• In American English, commas, semicolons, periods, question and exclamation marks are located within quotation marks only when a complete thought or name is cited, such as a title or full quotation. When quotation marks are used, instead of a bold or italic typeface, to highlight a word or phrase, punctuation should appear outside of the quotation marks. A parenthetical phrase or statement at the end of a sentence is punctuated outside of the closing parenthesis (like this). (A parenthetical sentence is punctuated within the parentheses.)
• A graph within a graph is an "inset", not an "insert". The word alternatively is preferred to the word "alternately" (unless you really mean something that alternates).
• Do not use the word "essentially" to mean "approximately" or "effectively".
• In your paper title, if the words "that uses" can accurately replace the word "using", capitalize the "u"; if not, keep using lower-cased.
• Be aware of the different meanings of the homophones "affect" and "effect", "complement" and "compliment", "discreet" and "discrete", "principal" and "principle".
• Do not confuse "imply" and "infer".
• The prefix "non" is not a word; it should be joined to the word it modifies, usually without a hyphen.
• There is no period after the "et" in the Latin abbreviation "et al.".
• The abbreviation "i.e." means "that is", and the abbreviation "e.g." means "for example".

An excellent style manual for science writers is [3].

Authors and Affiliations

A minimum of one author is required for all articles. Author names should be listed from top to bottom. This is the author sequence that will be used in future citations and by indexing services. Names should not be listed in groups by affiliation. Please keep your affiliations as succinct as possible (for example, do not differentiate among departments of the same organization).

Hints and General Advice

Identify the Headings

Headings, or heads, are organizational devices that guide the reader through your paper. There are two types: component heads and text heads.

Component heads identify the different components of your paper and are not topically subordinate to each other. Examples include Acknowledgments and References and, for these, the correct style has been implemented and this template and is defined by the IEEE. Do not make any adjustments. Use "figure caption" for your Figure captions, and "table head" for your table title. Run-in heads, such as "Abstract", will require you to apply a style (in this case, italic) in addition to the styles provided to differentiate the head from the text.

Text heads organize the topics on a relational, hierarchical basis. For example, the paper title is the primary text head because all subsequent material relates and elaborates on this one topic. If there are two or more sub-topics, the next level head (uppercase Roman numerals) should be used and, conversely, if there are not at least two sub-topics, then no subheads should be introduced.

HTML-Specific Advice

• < h1> : Page title
• < p class="subhead"> : Subheading
• < div class="header-authors"> : Authors grid
• < div class="header-published"> : Published date information
• < div class="contents box"> : Table of contents
• < section id="introduction"> : Sections from table of contents. Allows for inclusion of in-line references
• < figure class="text-center"> : Tagging for images with caption
• < p class="inline-math"> : Allows for handling of MathJax expressions. Use $$ – some equation here – $$ to add an expression
• < p class="math-left"> and < p class="math-right"> : Enables left/right alignment of an expression
• < div class="static"> : Supports static illustrations with caption
• < div class="framed"> : Each interactive element and scripts will be surrounded with this tagging
• < div class="formula-wrapper"> : Allows for adding content into styled and responsive table
• < section class="references"> : Reference list

Similar to LaTeX, using the same id multiple times may result in unintended behavior when linking to said id.

Acknowledgment

The preferred spelling of the word "acknowledgment" in America is without an "e" after the "g". Avoid the stilted expression "one of us (R. B. G.) thanks $$\ldots$$". Instead, try "R. B. G. thanks $$\ldots$$". Put sponsor acknowledgments in the acknowledgement section in the appendix.

References

Please number citations consecutively within brackets [4]. The sentence punctuation follows the bracket [4]. Refer simply to the reference number, as in [4]---do not use "Ref. [4]" or "reference [4]" except at the beginning of a sentence: "Reference [4] was the first $$\ldots$$"

Unless there are six authors or more give all authors' names; do not use "et al.". Papers that have not been published, even if they have been submitted for publication, should be cited as "unpublished" [5]. Papers that have been accepted for publication should be cited as "in press" [6]. Capitalize only the first word in a paper title, except for proper nouns and element symbols.

For papers published in translation journals, please give the English citation first, followed by the original foreign-language citation [7].

The IEEE interactive article template contains guidance text for composing and formatting of interactive articles. Please ensure that all template text is removed from your article prior to submission. Failure to remove the template text from your paper may result in your paper not being published.