User Tools

Site Tools


info:ise_tech_report

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
info:ise_tech_report [2015/03/29 13:07]
aykutbulut
info:ise_tech_report [2024/03/13 12:19] (current)
mjm519
Line 1: Line 1:
-====== Creating ISE, COR@L and CVCR Technical Reports on Polyps ======+====== Creating ISE, COR@L and CVCR Technical Reports ======
  
-===== Using Latex ===== +[[https://ise.lehigh.edu/content/technical-reports-project-completion-reports-and-working-papers|ISE website]] has an archive for technical reports and working papersThis page describes steps to generate technical report in technical report format.
-There is a latex document format called "isetechreport.sty" written by DrRalphs 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).+
  
-''ifthen'' package is used as follows,+===== 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}{ \ifthenelse{\coralreport = 1}{
  This part will be active if coralreport variable is 1.  This part will be active if coralreport variable is 1.
Line 13: Line 19:
  This part is active if coralreport variable is not 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. 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}{ \ifthenelse{\coralreport = 1}{
  This part will be active if coralreport variable is 1.  This part will be active if coralreport variable is 1.
 } }
 {} {}
-''+</code>
  
-See [[info:tech_report_example|this]] for an example.+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 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 ''ifthen'' package required.+In line 5 of the example we add the required ''ifthen'' package.
  
-At line 37-54 We add the title page information. Latex will use this information if ''coralreport'' variable is 1, ignore otherwise. You should edit this section for your report.+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). 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).
  
-Note that +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.
  
  
Line 45: Line 70:
  
 All necessary scripts for this process are located on /home/software/convert/. It is already on every user's PATH.  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
info/ise_tech_report.1427648820.txt.gz · Last modified: 1998/12/03 12:11 (external edit)