sics/site_ansto/manual/dbGTQuokka_ch2_reduction.xml

<?xml version="1.0" encoding="UTF-8"?>
<?oxygen RNGSchema="http://www.oasis-open.org/docbook/xml/5.0/rng/docbook.rng" type="xml"?>
<chapter xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"
    version="5.0">
    <info><title>Data Reduction</title><author>
        <personname>Katy Wood</personname>
    </author>
        <date>2008-08-29 16:47</date>
    </info>
    <sect1>
        <title>Installing data reduction macros on your own
                computer</title>
        <para>Note: Any data publication with quokka data reduced with the NIST macros should cite:
            Kline SR (2006) Reduction and analysis of SANS and USANS data using IGOR Pro. <emphasis
                role="italic">Journal of Applied Crystallography</emphasis><emphasis role="bold"
                >39:</emphasis> 895-900. </para>
    </sect1>
    <sect1><title>Install Igor</title>
        <para>If you don’t already have it… A free 30 day demo version can be downloaded from the wavemetrics website.  You need Igor version 6.2 or later.</para>
     </sect1>
    <sect1><title>Remove any older versions of the macros</title>
        <para>Skip this step if you’ve never had any of the NIST or Quokka macros installed. If you’ve had any older versions of the NIST or 
            Quokka analysis macros installed, it’s important to remove completely/rename folder so there will be no conflicts.  
            You will only have to do this once, as the future updates will be done automatically as long as you are connected to the internet.</para>
        <caution><para>once you have installed the newer versions of the macros, you will not be able to load any
                Igor project files made with the older ones. This means you should save all the
                treated ascii files you are likely to need before installing a newer version of the
                software. </para></caution>
        <orderedlist>
            
        <listitem><para>Delete any old NIST and Quokka macros from the following directories (or move all macros elsewhere if you’d like to keep older versions of the macros):</para>
            <orderedlist>
                <listitem><para>C:\Program Files\WaveMetrics\Igor Pro Folder\User Procedures</para></listitem>
                <listitem><para>C:\Documents and Settings\user_name\My Documents\WaveMetrics\Igor Pro 6 User Files\User Procedures</para></listitem>
                <listitem><para>C:\Documents and Settings\user_name\My Documents\WaveMetrics\Igor Pro 6 User Files\Igor Procedures</para></listitem>
               </orderedlist></listitem>
            <listitem><para>Delete the two shortcuts to HDF5.xop and HDF5 Browser.ipf in: </para>
            <orderedlist>
                <listitem><para>C:\Program Files\WaveMetrics\Igor Pro Folder\Igor Extensions</para></listitem>
            </orderedlist>
            </listitem>
        </orderedlist>
    </sect1>
    <sect1><title>Install Quokka specific macros</title>
        <para>Navigate to:
            <link xlink:href="http://www.nbi.ansto.gov.au/quokka/macros/IgorUserFilesSwitch.exe">http://www.nbi.ansto.gov.au/quokka/macros/IgorUserFilesSwitch.exe</link>
            and download the executable  ‘IgorUserFilesSwitch.exe’.  Double click on the executable.  
        </para>
        <figure><title>Select Quokka Macros</title><mediaobject>
            <imageobject>
                <imagedata align="center" width="80mm" fileref="igorSelectMacros.jpg"/>
            </imageobject>
        </mediaobject>
        </figure>
        <para>Select Quokka macros to install and click OK. You will be asked if it is OK to
            download the macros, select yes. </para>
        <para>After installation ‘continue’ will launch Igor. Ticking the ‘continue when done box’
            will automatically start Igor after you have used the switch. </para>
        <para>Once this is done you should have a “Igor with Quokka macros” shortcut either under
            the Start&gt;Igor menu OR on your desktop (depending on which version of windows you are
            running).</para>
        <para>Once Igor Pro is open, the Macros menu should now contain ‘Load QUOKKA SANS Reduction
            Macros’. Selecting this brings up the yellow ‘SANS Reduction Controls’.</para>
        <figure><title>Data Reduction Controls</title><mediaobject>
            <imageobject>
                <imagedata align="center" width="160mm" fileref="igorStartScreen.jpg"/>
            </imageobject>
        </mediaobject>
        </figure>
        <para>Every time you open the “Igor with Quokka macros” shortcut, if you are connected to
            the internet, you will be prompted to install any updates as they become
            available.</para>
    </sect1>
    <sect1><title>Switch to NIST macros</title>
        <para>Double click again on the executable ‘IgorUserFilesSwitch.exe’. (Or select the “Igor
            Pro Macro Settings” shortcut under either under start&gt;Igor or on the desktop). Select
            the NIST macros and click OK. As above, you will be asked if it is OK to download
            macros, select yes. </para>
        <para>Once this is done you should have a “Igor with NIST macros” shortcut either under the
            Start&gt;Igor menu OR on your desktop (depending on which version of windows you are
            running).</para>
        <para>Both NIST and Quokka macros will now be on your computer and you can switch between by
            selecting the different shortcuts “Igor with NIST macros” and “Igor with Quokka
            macros”.</para></sect1>
</chapter>