====== Creating ISE, COR@L and CVCR Technical Reports ======

[[https://ise.lehigh.edu/content/technical-reports-project-completion-reports-and-working-papers|ISE website]] has an archive for technical reports and working papers. This page describes steps to generate technical report in technical report format.

===== Using Latex on Polyps =====

There is a latex style file called "isetechreport.sty" written by Dr. Ralphs and Dr. Curtis. For your paper in latex format you can use this package to create technical reports. Lets say your paper is in specific journal format. You can edit your tex file so that it can generate technical report or journal format paper. To achieve this user can add a latex package called "ifthen" to her tex file. Using this package if else statements can be used in latex tex files. Then using a simple variable to control the output format user can generate both technical reports and journal papers. You can also hide the unwanted sections for one of the formats (ex. keywords may be needed for journal but not for tech report).


==== Using the Latex Package ====

Technical report package can be used with ''ifthen'' package. ''ifthen'' package provides command ''\ifthenelse'' which is used as follows,

<code>
\ifthenelse{\coralreport = 1}{
 This part will be active if coralreport variable is 1.
}
{
 This part is active if coralreport variable is not 1.
}
</code>

If no action is required then you can skip the content. The following shows the case where no action is required when ''coralreport'' is not 1.

<code>
\ifthenelse{\coralreport = 1}{
 This part will be active if coralreport variable is 1.
}
{}
</code>

An ''\ifthenelse'' statement was added the to the ''isetechreport.sty'' which can be used to update legacy (pre-2023) Technical reports using the old logo.
<code>
\newif\iflegacy
    ...
\legacyfalse

    ...

  \begin{center}
    \iflegacy 
        \includegraphics[height=0.8in]{ise.eps}\\
   \else
        \includegraphics[scale=0.35]{header-ISE.jpg} \\
   \fi

</code>

This section was tested using [[https://www.overleaf.com/|Overleaf]]

See [[tech_report_example.tex]] for an example.

In the example output is controlled by ''\def\coralreport{1}'' on the first line. If the value given to ''coralreport'' variable is 1, then technical report will be produced, journal paper otherwise.

In line 5 of the example we add the required ''ifthen'' package.

At line 37-54 we add isetechreport package using ''ifthenelse'' command. We also insert the title page information. Latex will use this information if ''coralreport'' variable is 1, ignore otherwise. You should edit this section for your report.

There are three more variables defined in lines 50-52. This variables determine the type of the technical report. There are three types of technical reports, coral, cvcr and ise. Example shows the case where we want an ISE technical report. If you want a different type you should edit this section (ex, for a coral report /coraltrue /cvcrfalse /isefalse).

In lines 60-70 we specify the authors. This example illustrates the case where different format of authors is used for journal and tech report. Again ''ifthenelse'' command is used to use the right format for each case.

In lines 85-89 ''ifthenelse'' command is used to add the keywords for journal format.


===== From MS Word Document =====
For this user needs two files. (1) cover.txt and (2) her report in MS Word format. Her report should be named as report.doc. cover.txt and report.doc should be in the same directory. Then she should call "make_tech_rep.sh" from this directory. cover.txt contains information regading the tech report. User can create this file by copying and editing [[info:cover_template|this]].

This should be done in polyp1.

All necessary scripts for this process are located on /home/software/convert/. It is already on every user's PATH. 


===== Using Texworks/MikTeX for Windows =====

If you wish you can clone the isetechincalreport package from the git repo on coral with
<code> git clone https://github.com/LehighISE/TechReport.git </code>
and move it to a folder within access of your Texworks or other Latex distribution. Then, simply add

<code tex>
\usepackage{isetechreport}
% Report year and no                                            
\def\reportyear{16T}                                                     
\def\reportno{005}                                                       
%% This is the revision number (increment for each revision)              
\def\revisionno{0}                                                       
%% This is the date f the original report                                 
\def\originaldate{May 30, 2016}                                          
%% This is the date of the latest revision                                
\def\revisiondate{May 30, 2016}                                          
%% Set these variables according to whether this should be a CORAL or CVCR
%% report                                                                 
\coralfalse                                                              
\cvcrfalse                                                               
\isetrue
</code>
to your preamble. To generate a cover page, you need to call 
<code tex>
\titlepage
</code>
before your ''\maketitle'' command.

===== Troubleshooting =====

==== Problems with tabular environment ====
If you have any kind of error that has to do with the tabular environment, please first make sure you are using the latest version of the tech report package, as a bug related to this was fixed (see above). Although it should not be necessary, please also make sure that you have added the \titlepage command in your document. Finally, if you have a \noindent error when compiling with latex, try getting rid of any \centering commands inside the tabular elements. If you are still having trouble, feel free to ask.

===== Installing Technical Report Latex Package =====

FIXME