Changeset 128


Ignore:
Timestamp:
Sep 30, 2009 5:33:30 PM (10 years ago)
Author:
prjemian
Message:

more cross-references and formatting, first index entries, cleaned up the Makefile, refs #19

Location:
1dwg/trunk/doc
Files:
16 edited

Legend:

Unmodified
Added
Removed
  • 1dwg/trunk/doc/src/Makefile

    r127 r128  
    1717#       make            default (1st) rule: same as "make all" 
    1818#       make all        builds docbook and BaseClassSections.xml 
    19 #       make docbook    builds all DocBook sections 
    20 #       make clean      removes files built in this directory 
    21 #       make rebuild    does a make clean then make all 
    22  
    23 RELEASE = 1.0 
    24 TARGET = cansas-1d-1_0-manual.pdf 
    25 #TARGET = manual.pdf 
    26  
    27 CLEANING_LIST += $(TARGET) 
    28 #CLEANING_LIST += *.pdf 
    29 #CLEANING_LIST += *.html 
    30 #CLEANING_LIST += *.ps 
     19#       make dblatex    builds the manual 
    3120 
    3221# === Rules === 
    3322 
    34 all: docbook 
     23all: dblatex 
    3524 
    36 docbook : $(TARGET) 
    37  
    38 test :: 
    39         @echo $(CLEANING_LIST) 
    40  
    41 # dblatex.sf.net can be used to build a PDF version of the manual 
     25# dblatex.sf.net builds the PDF version of the manual 
    4226dblatex cansas-1d-1_0-manual.pdf :: 
    43         @#dblatex -P table.in.float=0 -ttex manual.xml 
    4427        dblatex -P table.in.float=0 -b pdftex -tpdf manual.xml 
    45         @#pdftops $< temporary-manual.ps 
    46         @#ps2pdf temporary-manual.ps $< 
    47         mv -f manual.pdf cansas-1d-1_0-manual.pdf 
    48  
    49 cansas-1d-1_0-manual.ps :: cansas-1d-1_0-manual.pdf 
    50         pdftops $< 
    51  
    52 clean :: 
    53         /bin/rm -f $(CLEANING_LIST) 
    54  
    55 rebuild :: clean all 
     28        mv -f manual.pdf ../cansas-1d-1_0-manual.pdf 
  • 1dwg/trunk/doc/src/cansas1d_casestudy_collagen.xml

    r127 r128  
    3333                                    <imageobject> 
    3434                                        <imagedata 
    35                                             fileref="../graphics/cs-collagen-data-table-Excel.jpg" 
     35                                            fileref="../../graphics/cs-collagen-data-table-Excel.jpg" 
    3636                                            width="200pt" scalefit="1"/> 
    3737                                    </imageobject> 
     
    4545                                    <imageobject> 
    4646                                        <imagedata 
    47                                             fileref="../graphics/cs-collagen-saxs-chart-excel.jpg" 
     47                                            fileref="../../graphics/cs-collagen-saxs-chart-excel.jpg" 
    4848                                            width="200pt" scalefit="1"/> 
    4949                                    </imageobject> 
     
    177177                <mediaobject> 
    178178                    <imageobject> 
    179                         <imagedata fileref="../graphics/cs-collagen-macro-editing.jpg" 
     179                        <imagedata fileref="../../graphics/cs-collagen-macro-editing.jpg" 
    180180                            width="400pt" scalefit="1"/> 
    181181                    </imageobject> 
  • 1dwg/trunk/doc/src/cansas1d_element_SAScollimation.xml

    r127 r128  
    1818        $Date$ 
    1919    </bridgehead> 
     20    <itemizedlist mark="opencircle"> 
     21        <listitem> 
     22            <indexterm><primary>SAScollimation</primary></indexterm> 
     23            <para> 
     24                parent: 
     25                <link xlink:href="#cansas1d_documentation-element-SASinstrument">SASinstrument</link> 
     26            </para> 
     27        </listitem> 
     28    </itemizedlist> 
    2029    <figure> 
    2130        <title>The SAScollimation element</title> 
    2231        <mediaobject> 
    2332            <imageobject> 
    24                 <imagedata fileref="../graphics/6-SAScollimation.png" width="200pt" 
     33                <imagedata fileref="../../graphics/6-SAScollimation.png" width="200pt" 
    2534                    scalefit="1"/> 
    2635            </imageobject> 
     
    3342        </mediaobject> 
    3443    </figure> 
    35     <itemizedlist mark="opencircle"> 
    36         <listitem> 
    37             <para> 
    38                 parent: SASinstrument 
    39             </para> 
    40         </listitem> 
    41     </itemizedlist> 
    4244    <section> 
    4345        <title>SAScollimation</title> 
     
    176178                                <mediaobject> 
    177179                                    <imageobject> 
    178                                         <imagedata fileref="../graphics/translation-orientation-geometry.jpg" width='200pt' scalefit='1'/> 
     180                                        <imagedata fileref="../../graphics/translation-orientation-geometry.jpg" width='200pt' scalefit='1'/> 
    179181                                    </imageobject> 
    180182                                    <caption> 
     
    186188                                <mediaobject> 
    187189                                    <imageobject> 
    188                                         <imagedata fileref="../graphics/translation-orientation-geometry-2.jpg" width='200pt' scalefit='1'/> 
     190                                        <imagedata fileref="../../graphics/translation-orientation-geometry-2.jpg" width='200pt' scalefit='1'/> 
    189191                                    </imageobject> 
    190192                                    <caption> 
  • 1dwg/trunk/doc/src/cansas1d_element_SASdata.xml

    r127 r128  
    1414    version="5.0" xmlns:xlink="http://www.w3.org/1999/xlink"> 
    1515    <title>SASdata element</title> 
    16     <bridgehead> 
    17         $Revision$ 
    18         $Date$ 
    19     </bridgehead> 
     16    <bridgehead> $Revision$ $Date$ </bridgehead> 
     17    <itemizedlist mark="opencircle"> 
     18        <listitem> 
     19            <indexterm><primary>SASdata</primary></indexterm> 
     20            <para> parent: <link xlink:href="#cansas1d_documentation-element-SASentry" 
     21                ><literal>SASentry</literal></link> 
     22            </para> 
     23        </listitem> 
     24    </itemizedlist> 
    2025    <figure> 
    2126        <title>The SASdata element</title> 
    2227        <mediaobject> 
    2328            <imageobject> 
    24                 <imagedata fileref="../graphics/2-SASdata.png" width="200pt" 
    25                     scalefit="1"/> 
     29                <imagedata fileref="../../graphics/2-SASdata.png" width="200pt" scalefit="1"/> 
    2630            </imageobject> 
    2731            <textobject> 
     
    3741        <mediaobject> 
    3842            <imageobject> 
    39                 <imagedata fileref="../graphics/Q-geometry.jpg" width="200pt" 
    40                     scalefit="1"/> 
     43                <imagedata fileref="../../graphics/Q-geometry.jpg" width="200pt" scalefit="1"/> 
    4144            </imageobject> 
    4245            <textobject> 
     
    4851        </mediaobject> 
    4952    </figure> 
    50     <itemizedlist mark="opencircle"> 
    51         <listitem> 
    52             <para> 
    53                 parent: SASentry 
    54             </para> 
    55         </listitem> 
    56     </itemizedlist> 
    5753    <section> 
    5854        <title>SASdata</title> 
     
    7571                    <row> 
    7672                        <entry> 
    77                             '''Idata''' 
    78                         </entry> 
    79                         <entry> 
    80                             container 
    81                         </entry> 
    82                         <entry> 
    83                             [1..inf] 
    84                         </entry> 
    85                         <entry> 
    86                             Idata describes a single SAS data point. 
    87                         </entry> 
     73                            <emphasis role="bold"> 
     74                                Idata 
     75                                <indexterm><primary>Idata</primary></indexterm> 
     76                            </emphasis> 
     77                        </entry> 
     78                        <entry> container </entry> 
     79                        <entry> [1..inf] </entry> 
     80                        <entry> Idata describes a single SAS data point. </entry> 
    8881                        <entry/> 
    8982                    </row> 
    90                 </tbody></tgroup> 
     83                </tbody> 
     84            </tgroup> 
    9185        </table> 
    9286    </section> 
     
    115109                            </para> 
    116110                        </entry> 
    117                         <entry> 
    118                             floating-point number 
    119                         </entry> 
    120                         <entry> 
    121                             [1..1] 
    122                         </entry> 
    123                         <entry> 
    124                             <para> 
    125                                 <emphasis>Q=(4 pi; / lambda;) sin(theta;)</emphasis> where <emphasis>lambda;</emphasis> is the wavelength of the radiation and <emphasis>2theta;</emphasis> is the angle through which the detected radiation has been scattered. The <emphasis role="bold">unit</emphasis> attribute is required. See cansas1d_documentation#Rules for acceptable values. Either <emphasis>1/A</emphasis> or <emphasis>1/nm</emphasis> are typical. 
    126                             </para> 
    127                         </entry> 
    128                         <entry> 
    129                             <para> 
    130                                 <emphasis role="bold">unit</emphasis>={units} 
    131                             </para> 
     111                        <entry> floating-point number </entry> 
     112                        <entry> [1..1] </entry> 
     113                        <entry> 
     114                            <para> 
     115                                <emphasis>Q=(4 pi; / lambda;) sin(theta;)</emphasis> where 
     116                                    <emphasis>lambda;</emphasis> is the wavelength of the radiation 
     117                                and <emphasis>2theta;</emphasis> is the angle through which the 
     118                                detected radiation has been scattered. The <emphasis role="bold" 
     119                                    >unit</emphasis> attribute is required. See <link 
     120                                    xlink:href="#cansas1d_documentation-rules">rules for 
     121                                    units</link> 
     122                                <!--cansas1d_documentation#Rules --> for acceptable values. Either 
     123                                    <emphasis>1/A</emphasis> or <emphasis>1/nm</emphasis> are 
     124                                typical. </para> 
     125                        </entry> 
     126                        <entry> 
     127                            <para> 
     128                                <emphasis role="bold">unit</emphasis>={units} </para> 
    132129                        </entry> 
    133130                    </row> 
     
    138135                            </para> 
    139136                        </entry> 
    140                         <entry> 
    141                             floating-point number 
    142                         </entry> 
    143                         <entry> 
    144                             [1..1] 
    145                         </entry> 
    146                         <entry> 
    147                             Intensity of the detected radiation.  
    148                             The <emphasis role="bold">unit</emphasis> attribute is required.  
    149                             See cansas1d_documentation#Rules for acceptable values.  
    150                             One possibility might be<emphasis>1/cm</emphasis> for absolute  
    151                             units when the intensity describes a <emphasis>differential  
    152                                 cross-section per unit volume per unit solid angle</emphasis>.  
    153                             <emphasis role="bold">NOTE</emphasis>:  
    154                             Be aware that there are different types of intensity that  
    155                             may be reported (see Talk:cansas1d_documentation#The_Intensity_Problem)  
    156                             and one should be very careful to inspect the  
    157                             <emphasis role="bold">unit</emphasis> attribute to determine how to  
    158                             handle subsequent data processing, especially in the area of  
    159                             units conversion. 
    160                         </entry> 
    161                         <entry> 
    162                             <para> 
    163                                 <emphasis role="bold">unit</emphasis>={units} 
    164                             </para> 
     137                        <entry> floating-point number </entry> 
     138                        <entry> [1..1] </entry> 
     139                        <entry> 
     140                            <para> Intensity of the detected radiation. The <emphasis role="bold" 
     141                                    >unit</emphasis> attribute is required. See 
     142                                cansas1d_documentation#Rules for acceptable values. One possibility 
     143                                might be<emphasis>1/cm</emphasis> for absolute units when the 
     144                                intensity describes a <emphasis>differential cross-section per unit 
     145                                    volume per unit solid angle</emphasis>. </para> 
     146                            <para> Be aware that there are different types of intensity used in 
     147                                small-angle scattering that may be reported (see the section titled 
     148                                    <link xlink:href="#the_intensity_problem-rules"><emphasis 
     149                                        role="italic">The Intensity Problem</emphasis></link>). One 
     150                                should be very careful to inspect the <emphasis role="bold" 
     151                                    >unit</emphasis> attribute to determine how to handle subsequent 
     152                                data processing, especially in the area of units conversion. </para> 
     153                        </entry> 
     154                        <entry> 
     155                            <para> 
     156                                <emphasis role="bold">unit</emphasis>={units} </para> 
    165157                        </entry> 
    166158                    </row> 
     
    171163                            </para> 
    172164                        </entry> 
    173                         <entry> 
    174                             floating-point number 
    175                         </entry> 
    176                         <entry> 
    177                             [0..1] 
    178                         </entry> 
    179                         <entry> 
    180                             Estimated standard deviation of  
    181                             <emphasis role="bold">I</emphasis>. 
    182                             The <emphasis role="bold">unit</emphasis> attribute is required.  
    183                             See cansas1d_documentation#Rules for acceptable values.  
    184                             One possibility might be <emphasis>1/cm</emphasis>. 
    185                         </entry> 
    186                         <entry> 
    187                             <para> 
    188                                 <emphasis role="bold">unit</emphasis>={units} 
    189                             </para> 
     165                        <entry> floating-point number </entry> 
     166                        <entry> [0..1] </entry> 
     167                        <entry> Estimated standard deviation of <emphasis role="bold">I</emphasis>. 
     168                            The <emphasis role="bold">unit</emphasis> attribute is required. See 
     169                                <link xlink:href="#cansas1d_documentation-rules">rules for 
     170                                units</link> 
     171                            <!--cansas1d_documentation#Rules --> for acceptable values. One 
     172                            possibility might be <emphasis>1/cm</emphasis>. </entry> 
     173                        <entry> 
     174                            <para> 
     175                                <emphasis role="bold">unit</emphasis>={units} </para> 
    190176                        </entry> 
    191177                    </row> 
     
    196182                            </para> 
    197183                        </entry> 
    198                         <entry> 
    199                             floating-point number 
    200                         </entry> 
    201                         <entry> 
    202                             [0..1] 
    203                         </entry> 
    204                         <entry> 
    205                             Estimated standard deviation of  
    206                             <emphasis role="bold">Q</emphasis>. (optional: see note below on usage)The <emphasis role="bold">unit</emphasis> attribute is required. See cansas1d_documentation#Rules for acceptable values. Either <emphasis>1/A</emphasis> or <emphasis>1/nm</emphasis> are typical. 
    207                         </entry> 
    208                         <entry> 
    209                             <para> 
    210                                 <emphasis role="bold">unit</emphasis>={units} 
    211                             </para> 
     184                        <entry> floating-point number </entry> 
     185                        <entry> [0..1] </entry> 
     186                        <entry> Estimated standard deviation of <emphasis role="bold">Q</emphasis>. 
     187                            (optional: see note below on usage)The <emphasis role="bold" 
     188                                >unit</emphasis> attribute is required. See <link 
     189                                xlink:href="#cansas1d_documentation-rules">rules for units</link> 
     190                            <!--cansas1d_documentation#Rules --> for acceptable values. Either 
     191                                <emphasis>1/A</emphasis> or <emphasis>1/nm</emphasis> are typical. </entry> 
     192                        <entry> 
     193                            <para> 
     194                                <emphasis role="bold">unit</emphasis>={units} </para> 
    212195                        </entry> 
    213196                    </row> 
     
    218201                            </para> 
    219202                        </entry> 
    220                         <entry> 
    221                             floating-point number 
    222                         </entry> 
    223                         <entry> 
    224                             [0..1] 
    225                         </entry> 
    226                         <entry> 
    227                             <para> 
    228                                 <emphasis role="bold">Q</emphasis> resolution along the axis of scanning (the high-resolution <emphasis>slit width</emphasis> direction). Useful for defining resolution data from slit-smearing instruments such as Bonse-Hart geometry. (optional: see note below on usage)The <emphasis role="bold">unit</emphasis> attribute is required. See cansas1d_documentation#Rules for acceptable values. Either <emphasis>1/A</emphasis> or <emphasis>1/nm</emphasis> are typical. 
    229                             </para> 
     203                        <entry> floating-point number </entry> 
     204                        <entry> [0..1] </entry> 
     205                        <entry> 
     206                            <para> 
     207                                <emphasis role="bold">Q</emphasis> resolution along the axis of 
     208                                scanning (the high-resolution <emphasis>slit width</emphasis> 
     209                                direction). Useful for defining resolution data from slit-smearing 
     210                                instruments such as Bonse-Hart geometry. (optional: see note below 
     211                                on usage).</para> 
     212                            <para> The <emphasis role="bold">unit</emphasis> attribute is required. 
     213                                See <link xlink:href="#cansas1d_documentation-rules">rules for 
     214                                    units</link> 
     215                                <!--cansas1d_documentation#Rules --> for acceptable values. Either 
     216                                    <emphasis>1/A</emphasis> or <emphasis>1/nm</emphasis> are 
     217                                typical. </para> 
    230218                        </entry> 
    231219                        <entry> 
     
    240228                            </para> 
    241229                        </entry> 
    242                         <entry> 
    243                             floating-point number 
    244                         </entry> 
    245                         <entry> 
    246                             [0..1] 
    247                         </entry> 
    248                         <entry> 
    249                             <para> 
    250                                 <emphasis role="bold">Q</emphasis> resolution perpendicular to the axis of scanning (the low-resolution <emphasis>slit length</emphasis> direction). Useful for defining resolution data from slit-smearing instruments such as Bonse-Hart geometry. (optional: see note below on usage)The <emphasis role="bold">unit</emphasis> attribute is required. See cansas1d_documentation#Rules for acceptable values. Either <emphasis>1/A</emphasis> or <emphasis>1/nm</emphasis> are typical. 
    251                             </para> 
    252                         </entry> 
    253                         <entry> 
    254                             <para> 
    255                                 <emphasis role="bold">unit</emphasis>={units} 
    256                             </para> 
     230                        <entry> floating-point number </entry> 
     231                        <entry> [0..1] </entry> 
     232                        <entry> 
     233                            <para> 
     234                                <emphasis role="bold">Q</emphasis> resolution perpendicular to the 
     235                                axis of scanning (the low-resolution <emphasis>slit 
     236                                    length</emphasis> direction). Useful for defining resolution 
     237                                data from slit-smearing instruments such as Bonse-Hart geometry. 
     238                                (optional: see note below on usage)The <emphasis role="bold" 
     239                                    >unit</emphasis> attribute is required. See <link 
     240                                    xlink:href="#cansas1d_documentation-rules">rules for 
     241                                    units</link> 
     242                                <!--cansas1d_documentation#Rules --> for acceptable values. Either 
     243                                    <emphasis>1/A</emphasis> or <emphasis>1/nm</emphasis> are 
     244                                typical. </para> 
     245                        </entry> 
     246                        <entry> 
     247                            <para> 
     248                                <emphasis role="bold">unit</emphasis>={units} </para> 
    257249                        </entry> 
    258250                    </row> 
     
    263255                            </para> 
    264256                        </entry> 
    265                         <entry> 
    266                             floating-point number 
    267                         </entry> 
    268                         <entry> 
    269                             [0..1] 
    270                         </entry> 
    271                         <entry> 
    272                             Mean value of <emphasis role="bold">Q</emphasis> for this datum. Useful when describing data that has been binned from higher-resolution or from area detectors.The <emphasis role="bold">unit</emphasis> attribute is required. See cansas1d_documentation#Rules for acceptable values. Either <emphasis>1/A</emphasis> or <emphasis>1/nm</emphasis> are typical. 
    273                         </entry> 
     257                        <entry> floating-point number </entry> 
     258                        <entry> [0..1] </entry> 
     259                        <entry> Mean value of <emphasis role="bold">Q</emphasis> for this datum. 
     260                            Useful when describing data that has been binned from higher-resolution 
     261                            or from area detectors.The <emphasis role="bold">unit</emphasis> 
     262                            attribute is required. See <link 
     263                                xlink:href="#cansas1d_documentation-rules">rules for units</link> 
     264                            <!--cansas1d_documentation#Rules --> for acceptable values. Either 
     265                                <emphasis>1/A</emphasis> or <emphasis>1/nm</emphasis> are typical. </entry> 
    274266                        <entry> 
    275267                            <para> 
     
    283275                            </para> 
    284276                        </entry> 
    285                         <entry> 
    286                             floating-point number 
    287                         </entry> 
    288                         <entry> 
    289                             [0..1] 
    290                         </entry> 
    291                         <entry> 
    292                             Describes the adjustment due to the beam stop penumbra.  
    293                             <emphasis role="bold">(This definition needs revision. NIST?)</emphasis> 
    294                             NOTE: There is no unit attribute. 
     277                        <entry> floating-point number </entry> 
     278                        <entry> [0..1] </entry> 
     279                        <entry> 
     280                            <para> Describes the adjustment due to the beam stop penumbra. </para> 
     281                            <caution> 
     282                                <para>This definition needs revision. NIST?</para> 
     283                            </caution> 
     284                            <note> 
     285                                <para>There is no unit attribute.</para> 
     286                            </note> 
    295287                        </entry> 
    296288                        <entry/> 
    297289                    </row> 
    298290                    <row> 
    299                         <entry> 
    300                             '''''{any}''''' 
    301                         </entry> 
    302                         <entry> 
    303                             container 
    304                         </entry> 
     291                        <entry><emphasis role="bold"><emphasis role="italic"> {any} 
     292                                </emphasis></emphasis></entry> 
     293                        <entry> container </entry> 
    305294                        <entry> [0..inf] </entry> 
    306                         <entry> 
    307                             Any element(s) not defined in the cansas1d/1.0 standard can be placed at this point. See ''{any}'' for more details. 
    308                         </entry> 
    309                         <entry> 
    310                             <para> 
    311                                 <emphasis role="bold"><emphasis>xmlns:{foreign-prefix}</emphasis></emphasis>={foreign-namespace} 
    312                             </para> 
    313                         </entry> 
    314                     </row> 
    315                 </tbody></tgroup> 
     295                        <entry> Any element(s) not defined in the cansas1d/1.0 standard can be 
     296                            placed at this point. See <link 
     297                                xlink:href="#cansas1d_documentation-element-any"><emphasis 
     298                                    role="bold">{any}</emphasis></link> 
     299                            <!--''{any}'' --> for more details. </entry> 
     300                        <entry> 
     301                            <para> 
     302                                <emphasis role="bold" 
     303                                    ><emphasis 
     304                                        >xmlns:{foreign-prefix}</emphasis></emphasis> 
     305                                =<link 
     306                                    xlink:href="#cansas1d_documentation-element-any" 
     307                                    ><literal>{foreign-namespace}</literal></link> 
     308                            </para> 
     309                        </entry> 
     310                    </row> 
     311                </tbody> 
     312            </tgroup> 
    316313        </table> 
    317314    </section> 
    318     <section><title>Notes</title> 
    319         <orderedlist numeration="arabic"><listitem> 
    320             <para> 
    321                 When an optional element (<emphasis role="bold"><emphasis>Idev</emphasis></emphasis>, <emphasis role="bold"><emphasis>Qdev</emphasis></emphasis>, ...) is used, it must be given in every '''Idata''' within the enclosing '''SASdata'''. 
    322             </para> 
    323         </listitem> 
     315    <section> 
     316        <title>Notes</title> 
     317        <orderedlist numeration="arabic"> 
    324318            <listitem> 
    325                 <para> 
    326                     If either <emphasis role="bold"><emphasis>dQw</emphasis></emphasis> or <emphasis role="bold"><emphasis>dQl</emphasis></emphasis> are used, then <emphasis role="bold"><emphasis>Qdev</emphasis></emphasis> is not permitted to be used. 
    327                 </para> 
     319                <para> When an optional element (<emphasis role="bold" 
     320                        ><emphasis>Idev</emphasis></emphasis>, <emphasis role="bold" 
     321                            ><emphasis>Qdev</emphasis></emphasis>, ...) is used, it must be given in 
     322                    every <emphasis role="bold">Idata</emphasis> within the enclosing <emphasis 
     323                        role="bold">SASdata</emphasis>. </para> 
     324            </listitem> 
     325            <listitem> 
     326                <para> If either <emphasis role="bold"><emphasis>dQw</emphasis></emphasis> or 
     327                        <emphasis role="bold"><emphasis>dQl</emphasis></emphasis> are used, then 
     328                        <emphasis role="bold"><emphasis>Qdev</emphasis></emphasis> is not permitted 
     329                    to be used. </para> 
    328330            </listitem> 
    329331        </orderedlist> 
    330         <note><para> 
    331             <emphasis role="bold">(The Shadowfactor attribute definition needs revision. NIST?)</emphasis> 
    332         </para></note> 
     332        <note> 
     333            <para> 
     334                <emphasis role="bold">(The Shadowfactor attribute definition needs revision. 
     335                    NIST?)</emphasis> 
     336            </para> 
     337        </note> 
    333338    </section> 
    334339</section> 
  • 1dwg/trunk/doc/src/cansas1d_element_SASdetector.xml

    r127 r128  
    1919    </bridgehead> 
    2020    <itemizedlist mark="opencircle"> 
    21                 <listitem> 
    22                 <para> 
    23                     parent:  
    24                                 <link xlink:href="#cansas1d_documentation-element-SASinstrument">SASinstrument</link> 
    25                 </para> 
    26             </listitem> 
     21        <listitem> 
     22            <indexterm><primary>SASdetector</primary></indexterm> 
     23            <para> 
     24                parent:  
     25                <link xlink:href="#cansas1d_documentation-element-SASinstrument">SASinstrument</link> 
     26            </para> 
     27        </listitem> 
    2728    </itemizedlist> 
    2829    <figure> 
     
    3031        <mediaobject> 
    3132            <imageobject> 
    32                 <imagedata fileref="../graphics/7-SASdetector.png" width="200pt" 
     33                <imagedata fileref="../../graphics/7-SASdetector.png" width="200pt" 
    3334                    scalefit="1"/> 
    3435            </imageobject> 
     
    199200                            <imageobject> 
    200201                                <imagedata 
    201                                     fileref="../graphics/translation-orientation-geometry.jpg" 
     202                                    fileref="../../graphics/translation-orientation-geometry.jpg" 
    202203                                    width="200pt" scalefit="1"/> 
    203204                            </imageobject> 
     
    214215                            <imageobject> 
    215216                                <imagedata 
    216                                     fileref="../graphics/translation-orientation-geometry-2.jpg" 
     217                                    fileref="../../graphics/translation-orientation-geometry-2.jpg" 
    217218                                    width="200pt" scalefit="1"/> 
    218219                            </imageobject> 
  • 1dwg/trunk/doc/src/cansas1d_element_SASentry.xml

    r127 r128  
    2020    <itemizedlist mark="opencircle"> 
    2121        <listitem> 
     22            <indexterm><primary>SASentry</primary></indexterm> 
    2223            <para> 
    2324                                parent: 
     
    3031        <mediaobject> 
    3132            <imageobject> 
    32                 <imagedata fileref="../graphics/1-SASroot.png" width="200pt" 
     33                <imagedata fileref="../../graphics/1-SASroot.png" width="200pt" 
    3334                    scalefit="1"/> 
    3435            </imageobject> 
  • 1dwg/trunk/doc/src/cansas1d_element_SASinstrument.xml

    r127 r128  
    1818        $Date$ 
    1919    </bridgehead> 
     20    <itemizedlist mark="opencircle"> 
     21        <listitem> 
     22            <indexterm><primary>SASinstrument</primary></indexterm> 
     23            <para> 
     24                parent: 
     25                <link xlink:href="#cansas1d_documentation-element-SASentry">SASentry</link> 
     26            </para> 
     27        </listitem> 
     28    </itemizedlist> 
    2029    <figure> 
    2130        <title>The SASinstrument element</title> 
    2231        <mediaobject> 
    2332            <imageobject> 
    24                 <imagedata fileref="../graphics/4-SASinstrument.png" width="200pt" 
     33                <imagedata fileref="../../graphics/4-SASinstrument.png" width="200pt" 
    2534                    scalefit="1"/> 
    2635            </imageobject> 
     
    3241            </caption> 
    3342        </mediaobject> 
    34     </figure><itemizedlist mark="opencircle"><listitem> 
    35         <para> 
    36             parent: SASentry 
    37         </para> 
    38     </listitem> 
    39     </itemizedlist> 
     43    </figure> 
    4044    <table orient="port" role="small"> 
    4145        <title/> 
  • 1dwg/trunk/doc/src/cansas1d_element_SASnote.xml

    r127 r128  
    1818        $Date$ 
    1919    </bridgehead> 
     20    <itemizedlist mark="opencircle"> 
     21        <listitem> 
     22            <indexterm><primary>SASnote</primary></indexterm> 
     23            <para> 
     24                parent: 
     25                <link xlink:href="#cansas1d_documentation-element-SASentry">SASentry</link> 
     26            </para> 
     27        </listitem> 
     28    </itemizedlist> 
    2029    <figure> 
    2130        <title>The SASroot element</title> 
    2231        <mediaobject> 
    2332            <imageobject> 
    24                 <imagedata fileref="../graphics/1-SASroot.png" width="200pt" 
     33                <imagedata fileref="../../graphics/1-SASroot.png" width="200pt" 
    2534                    scalefit="1"/> 
    2635            </imageobject> 
     
    3342        </mediaobject> 
    3443    </figure> 
    35     <itemizedlist mark="opencircle"> 
    36         <listitem> 
    37             <para> 
    38                 parent: SASentry 
    39             </para> 
    40         </listitem> 
    41     </itemizedlist> 
    4244    <table orient="port" role="small"> 
    4345        <title/> 
  • 1dwg/trunk/doc/src/cansas1d_element_SASprocess.xml

    r127 r128  
    1818        $Date$ 
    1919    </bridgehead> 
     20    <itemizedlist mark="opencircle"> 
     21        <listitem> 
     22            <indexterm><primary>SASprocess</primary></indexterm> 
     23            <para> 
     24                parent: 
     25                <link xlink:href="#cansas1d_documentation-element-SASentry">SASentry</link> 
     26            </para> 
     27        </listitem> 
     28    </itemizedlist> 
    2029    <figure> 
    2130        <title>The SASprocess element</title> 
    2231        <mediaobject> 
    2332            <imageobject> 
    24                 <imagedata fileref="../graphics/8-SASprocess.png" width="200pt" scalefit="1"/> 
     33                <imagedata fileref="../../graphics/8-SASprocess.png" width="200pt" scalefit="1"/> 
    2534            </imageobject> 
    2635            <textobject> 
     
    3241        </mediaobject> 
    3342    </figure> 
    34     <itemizedlist mark="opencircle"> 
    35         <listitem> 
    36             <para> 
    37                 parent: SASentry 
    38             </para> 
    39         </listitem> 
    40     </itemizedlist> 
    4143    <table orient="port" role="small"> 
    4244        <title/> 
  • 1dwg/trunk/doc/src/cansas1d_element_SASroot.xml

    r127 r128  
    2020    <itemizedlist mark="opencircle"> 
    2121        <listitem> 
     22            <indexterm><primary>SASroot</primary></indexterm> 
    2223            <para>  
    2324                                parent:  
     
    3031        <mediaobject> 
    3132            <imageobject> 
    32                 <imagedata fileref="../graphics/1-SASroot.png" width="200pt" scalefit="1"/> 
     33                <imagedata fileref="../../graphics/1-SASroot.png" width="200pt" scalefit="1"/> 
    3334            </imageobject> 
    3435            <textobject> 
  • 1dwg/trunk/doc/src/cansas1d_element_SASsample.xml

    r127 r128  
    1818        $Date$ 
    1919    </bridgehead> 
     20    <itemizedlist mark="opencircle"> 
     21        <listitem> 
     22            <indexterm><primary>SASsample</primary></indexterm> 
     23            <para> 
     24                parent: 
     25                <link xlink:href="#cansas1d_documentation-element-SASentry">SASentry</link> 
     26            </para> 
     27        </listitem> 
     28    </itemizedlist> 
    2029    <figure> 
    2130        <title>The SASsample element</title> 
    2231        <mediaobject> 
    2332            <imageobject> 
    24                 <imagedata fileref="../graphics/3-SASsample.png" width="200pt" scalefit="1"/> 
     33                <imagedata fileref="../../graphics/3-SASsample.png" width="200pt" scalefit="1"/> 
    2534            </imageobject> 
    2635            <textobject> 
     
    3241        </mediaobject> 
    3342    </figure> 
    34     <itemizedlist mark="opencircle"> 
    35         <listitem> 
    36             <para> parent: SASentry </para> 
    37         </listitem> 
    38     </itemizedlist> 
    3943    <table orient="port" role="small"> 
    4044        <title/> 
     
    162166                                    <imageobject> 
    163167                                        <imagedata 
    164                                             fileref="../graphics/translation-orientation-geometry.jpg" 
     168                                            fileref="../../graphics/translation-orientation-geometry.jpg" 
    165169                                            width="200pt" scalefit="1"/> 
    166170                                    </imageobject> 
     
    177181                                    <imageobject> 
    178182                                        <imagedata 
    179                                             fileref="../graphics/translation-orientation-geometry-2.jpg" 
     183                                            fileref="../../graphics/translation-orientation-geometry-2.jpg" 
    180184                                            width="200pt" scalefit="1"/> 
    181185                                    </imageobject> 
  • 1dwg/trunk/doc/src/cansas1d_element_SASsource.xml

    r127 r128  
    1414    version="5.0" xmlns:xlink="http://www.w3.org/1999/xlink"> 
    1515    <title>SASsource element</title> 
    16     <bridgehead> 
    17         $Revision$ 
    18         $Date$ 
    19     </bridgehead> 
     16    <bridgehead> $Revision$ $Date$ </bridgehead> 
     17    <itemizedlist mark="opencircle"> 
     18        <listitem> 
     19            <indexterm><primary>SASsource</primary></indexterm> 
     20            <para> parent: <link xlink:href="#cansas1d_documentation-element-SASinstrument" 
     21                    >SASinstrument</link> 
     22            </para> 
     23        </listitem> 
     24    </itemizedlist> 
    2025    <figure> 
    2126        <title>The SASsource element</title> 
    2227        <mediaobject> 
    2328            <imageobject> 
    24                 <imagedata fileref="../graphics/5-SASsource.png" width="200pt" 
    25                     scalefit="1"/> 
     29                <imagedata fileref="../../graphics/5-SASsource.png" width="200pt" scalefit="1"/> 
    2630            </imageobject> 
    2731            <textobject> 
     
    3337        </mediaobject> 
    3438    </figure> 
    35     <itemizedlist mark="opencircle"> 
    36         <listitem> 
    37             <para> parent: SASinstrument </para> 
    38         </listitem> 
    39     </itemizedlist> 
    4039    <section> 
    4140        <title>SASsource</title> 
     
    5655                        <entry><?dblatex bgcolor="[gray]{0.8}"?>Attributes</entry> 
    5756                    </row> 
    58                 <row> 
    59                     <entry> 
    60                         <para> 
    61                             <emphasis role="bold">radiation</emphasis> 
    62                         </para> 
    63                     </entry> 
    64                     <entry> 
    65                         string 
    66                     </entry> 
    67                     <entry> 
    68                         [1..1] 
    69                     </entry> 
    70                     <entry> 
    71                         Name of the radiation used. For maximum compatibility with NeXus, use one of the names defined by either  
    72                         <link xlink:href="http://www.nexusformat.org/NXsource"><citetitle>NeXus '''NXsource'''/type</citetitle></link> 
    73                         * Spallation Neutron Source  * Pulsed Reactor Neutron Source  * Reactor Neutron Source  * Synchrotron X-ray Source  * Pulsed Muon Source  * Rotating Anode X-ray  * Fixed Tube X-ray  or  
    74                         <link xlink:href="http://www.nexusformat.org/NXsource"><citetitle>NeXus '''NXsource'''/probe</citetitle></link>  * neutron  * x-ray  * muon  * electron 
    75                     </entry> 
    76                     <entry> 
    77                     </entry> 
    78                 </row> 
    79                 <row> 
    80                     <entry> 
    81                         '''''beam_size''''' 
    82                     </entry> 
    83                     <entry> 
    84                         container 
    85                     </entry> 
    86                     <entry> 
    87                         [0..1] 
    88                     </entry> 
    89                     <entry> 
    90                         Physical dimension of the beam (incident on the sample). Note: If beam is round, just use X dimension. Note: While Z dimension is allowed by the standard, it does not make sense for small-angle scattering. 
    91                     </entry> 
    92                     <entry> 
    93                         <para> 
    94                             <emphasis role="bold"><emphasis>name</emphasis></emphasis>={name} 
    95                         </para> 
    96                     </entry> 
    97                 </row> 
    98                 <row> 
    99                     <entry> 
    100                         <para> 
    101                             <emphasis role="bold"><emphasis>beam_shape</emphasis></emphasis> 
    102                         </para> 
    103                     </entry> 
    104                     <entry> 
    105                         string 
    106                     </entry> 
    107                     <entry> 
    108                         [0..1] 
    109                     </entry> 
    110                     <entry> 
    111                         Text description of the shape of the beam (incident on the sample). 
    112                     </entry> 
    113                     <entry> 
    114                     </entry> 
    115                 </row> 
    116                 <row> 
    117                     <entry> 
    118                         <para> 
    119                             <emphasis role="bold"><emphasis>wavelength</emphasis></emphasis> 
    120                         </para> 
    121                     </entry> 
    122                     <entry> 
    123                         floating-point number 
    124                     </entry> 
    125                     <entry> 
    126                         [0..1] 
    127                     </entry> 
    128                     <entry> 
    129                         wavelength (lambda;) of radiation incident on the sample. 
    130                     </entry> 
    131                     <entry> 
    132                         <para> 
    133                             <emphasis role="bold">unit</emphasis>={unit} 
    134                         </para> 
    135                     </entry> 
    136                 </row> 
    137                 <row> 
    138                     <entry> 
    139                         <para> 
    140                             <emphasis role="bold"><emphasis>wavelength_min</emphasis></emphasis> 
    141                         </para> 
    142                     </entry> 
    143                     <entry> 
    144                         floating-point number 
    145                     </entry> 
    146                     <entry> 
    147                         [0..1] 
    148                     </entry> 
    149                     <entry> 
    150                         Some facilities specify wavelength using a range. The minimum of such a range is given by wavelength_min. 
    151                     </entry> 
    152                     <entry> 
    153                         <para> 
    154                             <emphasis role="bold">unit</emphasis>={unit} 
    155                         </para> 
    156                     </entry> 
    157                 </row> 
    158                 <row> 
    159                     <entry> 
    160                         <para> 
    161                             <emphasis role="bold"><emphasis>wavelength_max</emphasis></emphasis> 
    162                         </para> 
    163                     </entry> 
    164                     <entry> 
    165                         floating-point number 
    166                     </entry> 
    167                     <entry> 
    168                         [0..1] 
    169                     </entry> 
    170                     <entry> 
    171                         Some facilities specify wavelength using a range. The maximum of such a range is given by wavelength_max. 
    172                     </entry> 
    173                     <entry> 
    174                         <para> 
    175                             <emphasis role="bold">unit</emphasis>={unit} 
    176                         </para> 
    177                     </entry> 
    178                 </row> 
    179                 <row> 
    180                     <entry> 
    181                         <para> 
    182                             <emphasis role="bold"><emphasis>wavelength_spread</emphasis></emphasis> 
    183                         </para> 
    184                     </entry> 
    185                     <entry> 
    186                         floating-point number 
    187                     </entry> 
    188                     <entry> 
    189                         [0..1] 
    190                     </entry> 
    191                     <entry> 
    192                         Some facilities specify the width of the wavelength spectrum. The width of such a range is given by wavelength_spread. 
    193                     </entry> 
    194                     <entry> 
    195                         <para> 
    196                             <emphasis role="bold">unit</emphasis>={unit} 
    197                         </para> 
    198                     </entry> 
    199                 </row> 
    200             </tbody></tgroup> 
     57                    <row> 
     58                        <entry> 
     59                            <para> 
     60                                <emphasis role="bold">radiation</emphasis> 
     61                            </para> 
     62                        </entry> 
     63                        <entry> string </entry> 
     64                        <entry> [1..1] </entry> 
     65                        <entry> 
     66                            <para> 
     67                                Name of the radiation used. For maximum compatibility with NeXus, 
     68                                use one of the names defined by either <link 
     69                                    xlink:href="http://www.nexusformat.org/NXsource" 
     70                                    ><citetitle>NeXus</citetitle> 
     71                                        <literal>NXsource/type</literal></link>  
     72                            </para> 
     73                            <itemizedlist> 
     74                                <listitem><para>Spallation Neutron Source</para></listitem> 
     75                                <listitem><para>Pulsed Reactor Neutron Source</para></listitem> 
     76                                <listitem><para>Reactor Neutron Source</para></listitem> 
     77                                <listitem><para>Synchrotron X-ray Source</para></listitem> 
     78                                <listitem><para>Pulsed Muon Source</para></listitem> 
     79                                <listitem><para>Rotating Anode X-ray</para></listitem> 
     80                                <listitem><para>Fixed Tube X-ray</para></listitem> 
     81                            </itemizedlist> 
     82                            <para>  
     83                                or <link 
     84                                    xlink:href="http://www.nexusformat.org/NXsource" 
     85                                    ><citetitle>NeXus</citetitle> 
     86                                    <literal>NXsource/probe</literal></link>  
     87                            </para> 
     88                            <itemizedlist> 
     89                                <listitem><para>neutron</para></listitem> 
     90                                <listitem><para>x-ray</para></listitem> 
     91                                <listitem><para>muon</para></listitem> 
     92                                <listitem><para>electron</para></listitem> 
     93                            </itemizedlist> 
     94                        </entry> 
     95                        <entry/> 
     96                         
     97                    </row> 
     98                    <row> 
     99                        <entry> '''''beam_size''''' </entry> 
     100                        <entry> container </entry> 
     101                        <entry> [0..1] </entry> 
     102                        <entry> Physical dimension of the beam (incident on the sample). Note: If 
     103                            beam is round, just use X dimension. Note: While Z dimension is allowed 
     104                            by the standard, it does not make sense for small-angle scattering. </entry> 
     105                        <entry> 
     106                            <para> 
     107                                <emphasis role="bold"><emphasis>name</emphasis></emphasis>={name} 
     108                            </para> 
     109                        </entry> 
     110                    </row> 
     111                    <row> 
     112                        <entry> 
     113                            <para> 
     114                                <emphasis role="bold"><emphasis>beam_shape</emphasis></emphasis> 
     115                            </para> 
     116                        </entry> 
     117                        <entry> string </entry> 
     118                        <entry> [0..1] </entry> 
     119                        <entry> Text description of the shape of the beam (incident on the sample). </entry> 
     120                        <entry> 
     121                        </entry> 
     122                    </row> 
     123                    <row> 
     124                        <entry> 
     125                            <para> 
     126                                <emphasis role="bold"><emphasis>wavelength</emphasis></emphasis> 
     127                            </para> 
     128                        </entry> 
     129                        <entry> floating-point number </entry> 
     130                        <entry> [0..1] </entry> 
     131                        <entry>  
     132                            <para> 
     133                                wavelength  
     134                                (<inlineequation> 
     135                                    <mathphrase><alt>$\lambda$</alt></mathphrase> 
     136                                </inlineequation>) 
     137                                of radiation incident on the sample. 
     138                            </para> 
     139                        </entry> 
     140                        <entry> 
     141                            <para> 
     142                                <emphasis role="bold">unit</emphasis>={unit} </para> 
     143                        </entry> 
     144                    </row> 
     145                    <row> 
     146                        <entry> 
     147                            <para> 
     148                                <emphasis role="bold"><emphasis>wavelength_min</emphasis></emphasis> 
     149                            </para> 
     150                        </entry> 
     151                        <entry> floating-point number </entry> 
     152                        <entry> [0..1] </entry> 
     153                        <entry> Some facilities specify wavelength using a range. The minimum of 
     154                            such a range is given by wavelength_min. </entry> 
     155                        <entry> 
     156                            <para> 
     157                                <emphasis role="bold">unit</emphasis>={unit} </para> 
     158                        </entry> 
     159                    </row> 
     160                    <row> 
     161                        <entry> 
     162                            <para> 
     163                                <emphasis role="bold"><emphasis>wavelength_max</emphasis></emphasis> 
     164                            </para> 
     165                        </entry> 
     166                        <entry> floating-point number </entry> 
     167                        <entry> [0..1] </entry> 
     168                        <entry> Some facilities specify wavelength using a range. The maximum of 
     169                            such a range is given by wavelength_max. </entry> 
     170                        <entry> 
     171                            <para> 
     172                                <emphasis role="bold">unit</emphasis>={unit} </para> 
     173                        </entry> 
     174                    </row> 
     175                    <row> 
     176                        <entry> 
     177                            <para> 
     178                                <emphasis role="bold" 
     179                                    ><emphasis>wavelength_spread</emphasis></emphasis> 
     180                            </para> 
     181                        </entry> 
     182                        <entry> floating-point number </entry> 
     183                        <entry> [0..1] </entry> 
     184                        <entry> Some facilities specify the width of the wavelength spectrum. The 
     185                            width of such a range is given by wavelength_spread. </entry> 
     186                        <entry> 
     187                            <para> 
     188                                <emphasis role="bold">unit</emphasis>={unit} </para> 
     189                        </entry> 
     190                    </row> 
     191                </tbody> 
     192            </tgroup> 
    201193        </table> 
    202194    </section> 
     
    206198            <table> 
    207199                <title/> 
    208                 <tgroup cols='2'> 
     200                <tgroup cols="2"> 
    209201                    <tbody> 
    210202                        <row> 
     
    212204                                <mediaobject> 
    213205                                    <imageobject> 
    214                                         <imagedata fileref="../graphics/translation-orientation-geometry.jpg" width='200pt' scalefit='1'/> 
     206                                        <imagedata 
     207                                            fileref="../../graphics/translation-orientation-geometry.jpg" 
     208                                            width="200pt" scalefit="1"/> 
    215209                                    </imageobject> 
    216210                                    <caption> 
     
    222216                                <mediaobject> 
    223217                                    <imageobject> 
    224                                         <imagedata fileref="../graphics/translation-orientation-geometry-2.jpg" width='200pt' scalefit='1'/> 
     218                                        <imagedata 
     219                                            fileref="../../graphics/translation-orientation-geometry-2.jpg" 
     220                                            width="200pt" scalefit="1"/> 
    225221                                    </imageobject> 
    226222                                    <caption> 
     
    253249                                <emphasis role="bold">x</emphasis> 
    254250                            </entry> 
    255                             <entry> 
    256                                 floating-point number 
    257                             </entry> 
    258                             <entry> 
    259                                 [0..1] 
    260                             </entry> 
    261                             <entry> 
    262                                 Dimension of the beam in X. The <emphasis role="bold">unit</emphasis> attribute is required. See cansas1d_documentation#Rules for acceptable values. 
    263                             </entry> 
    264                             <entry> 
    265                                 <emphasis role="bold">unit</emphasis>={units} 
    266                             </entry> 
     251                            <entry> floating-point number </entry> 
     252                            <entry> [0..1] </entry> 
     253                            <entry> Dimension of the beam in X. The <emphasis role="bold" 
     254                                    >unit</emphasis> attribute is required. See 
     255                                cansas1d_documentation#Rules for acceptable values. </entry> 
     256                            <entry> 
     257                                <emphasis role="bold">unit</emphasis>={units} </entry> 
    267258                        </row> 
    268259                        <row> 
     
    270261                                <emphasis role="bold">y</emphasis> 
    271262                            </entry> 
    272                             <entry> 
    273                                 floating-point number 
    274                             </entry> 
    275                             <entry> 
    276                                 [0..1] 
    277                             </entry> 
    278                             <entry> 
    279                                 Dimension of the beam in Y. The <emphasis role="bold">unit</emphasis> attribute is required. See cansas1d_documentation#Rules for acceptable values. 
    280                             </entry> 
    281                             <entry> 
    282                                 <emphasis role="bold">unit</emphasis>={units} 
    283                             </entry> 
     263                            <entry> floating-point number </entry> 
     264                            <entry> [0..1] </entry> 
     265                            <entry> Dimension of the beam in Y. The <emphasis role="bold" 
     266                                    >unit</emphasis> attribute is required. See 
     267                                cansas1d_documentation#Rules for acceptable values. </entry> 
     268                            <entry> 
     269                                <emphasis role="bold">unit</emphasis>={units} </entry> 
    284270                        </row> 
    285271                        <row> 
     
    287273                                <emphasis role="bold">z</emphasis> 
    288274                            </entry> 
    289                             <entry> 
    290                                 floating-point number 
    291                             </entry> 
    292                             <entry> 
    293                                 [0..1] 
    294                             </entry> 
    295                             <entry> 
    296                                 Dimension of the beam in Z. The <emphasis role="bold">unit</emphasis> attribute is required. See cansas1d_documentation#Rules for acceptable values. Note: While Z dimension is allowed by the standard (provided by use of a standard element in the XML Schema), it does not make sense for small-angle scattering. 
    297                             </entry> 
    298                             <entry> 
    299                                 <emphasis role="bold">unit</emphasis>={units} 
    300                             </entry> 
     275                            <entry> floating-point number </entry> 
     276                            <entry> [0..1] </entry> 
     277                            <entry> Dimension of the beam in Z. The <emphasis role="bold" 
     278                                    >unit</emphasis> attribute is required. See 
     279                                cansas1d_documentation#Rules for acceptable values. Note: While Z 
     280                                dimension is allowed by the standard (provided by use of a standard 
     281                                element in the XML Schema), it does not make sense for small-angle 
     282                                scattering. </entry> 
     283                            <entry> 
     284                                <emphasis role="bold">unit</emphasis>={units} </entry> 
    301285                        </row> 
    302286                    </tbody> 
  • 1dwg/trunk/doc/src/manual.xml

    r127 r128  
    5252            <mediaobject> 
    5353                <imageobject> 
    54                     <imagedata fileref="../graphics/cswikilogo.png" scale="200"/> 
     54                    <imagedata fileref="../../graphics/cswikilogo.png" scale="200"/> 
    5555                </imageobject> 
    5656            </mediaobject> 
     
    8383    </preface> 
    8484 
    85  
    8685        <!-- 
    8786        Here is an example of how to construct a cross-reference from NeXus 
  • 1dwg/trunk/doc/src/other.xml

    r127 r128  
    1010    ########### SVN repository information ################### 
    1111--> 
    12 <chapter xml:id="wiki-other"  
    13     xmlns="http://docbook.org/ns/docbook" version="5.0" 
    14     xmlns:xlink="http://www.w3.org/1999/xlink" 
    15     xmlns:xi="http://www.w3.org/2001/XInclude"> 
     12<chapter xml:id="wiki-other" xmlns="http://docbook.org/ns/docbook" version="5.0" 
     13    xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xi="http://www.w3.org/2001/XInclude"> 
    1614    <title>Other matters</title> 
    17     <para>Various topics have been considered or presented in considering this standard.   
    18         Some are described below.</para> 
     15    <para>Various topics have been considered or presented in considering this standard. Some are 
     16        described below.</para> 
    1917    <xi:include href="cansas1d_definition_of_terms.xml"/> 
    2018    <xi:include href="xml-help.xml"/> 
     19    <section xml:id="the_intensity_problem"> 
     20        <title>The Intensity Problem</title> 
     21        <para> The intensity (see  
     22            <link 
     23                xlink:href="#cansas1d_documentation-element-SASdata" 
     24                ><literal>SASdata/Idata</literal></link>)  
     25            is permitted in three different forms: </para> 
     26        <itemizedlist> 
     27            <listitem> 
     28                <para><emphasis role="bold">absolute units:</emphasis> differential cross-section 
     29                    per unit volume per unit solid angle (typical unit: 1/cm)</para> 
     30            </listitem> 
     31            <listitem> 
     32                <para><emphasis role="bold">absolute units:</emphasis> differential cross-section 
     33                    per unit atom per unit solid angle (typical unit: cm^2)</para> 
     34            </listitem> 
     35            <listitem> 
     36                <para><emphasis role="bold">arbitrary units:</emphasis> usually a ratio of two 
     37                    detectors but unit is meaningless (typical unit: a.u.)</para> 
     38            </listitem> 
     39        </itemizedlist> 
     40        <para> This presents a few problems for analysis software to sort out when reading the data. 
     41            Fortunately, it is possible to analyze the unit attribute to decide which type of 
     42            intensity is being reported and make choices at the time the file is read. But this is 
     43            an area for consideration and possible improvement. </para> 
     44        <para> One problem arises with software that automatically converts data into some canonical 
     45            units used by that software. The software should not convert units between these three 
     46            types of intensity indiscriminately. </para> 
     47        <para> A second problem is that when arbitrary units are used, then the set of possible 
     48            analytical results is restricted (such as no meaningful volume fraction or number 
     49            density can be determined directly from I(Q)). </para> 
     50    </section> 
    2151</chapter> 
  • 1dwg/trunk/doc/src/wiki.xml

    r127 r128  
    7676                <mediaobject> 
    7777                    <imageobject> 
    78                         <imagedata fileref="../graphics/10-minimum.png" scalefit="1" width="200pt"/> 
     78                        <imagedata fileref="../../graphics/10-minimum.png" scalefit="1" width="200pt"/> 
    7979                    </imageobject> 
    8080                </mediaobject> 
     
    292292                        <mediaobject> 
    293293                            <imageobject> 
    294                                 <imagedata fileref="../graphics/Q-geometry.jpg" scalefit="1" 
     294                                <imagedata fileref="../../graphics/Q-geometry.jpg" scalefit="1" 
    295295                                    width="200pt"/></imageobject> 
    296296                        </mediaobject> 
     
    362362                                                  <imageobject> 
    363363                                                  <imagedata 
    364                                                   fileref="../graphics/translation-orientation-geometry.jpg" 
     364                                                  fileref="../../graphics/translation-orientation-geometry.jpg" 
    365365                                                  width="200pt" scalefit="1"/> 
    366366                                                  </imageobject> 
     
    374374                                                  <imageobject> 
    375375                                                  <imagedata 
    376                                                   fileref="../graphics/translation-orientation-geometry-2.jpg" 
     376                                                  fileref="../../graphics/translation-orientation-geometry-2.jpg" 
    377377                                                  width="200pt" scalefit="1"/> 
    378378                                                  </imageobject> 
Note: See TracChangeset for help on using the changeset viewer.