Changeset 230 for canSAS2012


Ignore:
Timestamp:
Aug 4, 2012 1:37:11 PM (7 years ago)
Author:
prjemian
Message:

comments noted but not added to documentation yet

Location:
canSAS2012/docs/source
Files:
3 added
3 edited

Legend:

Unmodified
Added
Removed
  • canSAS2012/docs/source/conf.py

    r226 r230  
    107107# "<project> v<release> documentation". 
    108108#html_title = None 
     109html_title = 'Documentation of the canSAS2012 standard data format' 
    109110 
    110111# A shorter title for the navigation bar.  Default is the same as html_title. 
    111112#html_short_title = None 
     113html_short_title = 'canSAS2012' 
    112114 
    113115# The name of an image file (relative to this directory) to place at the top 
    114116# of the sidebar. 
    115117#html_logo = None 
     118html_logo = 'cswikilogo.png' 
    116119 
    117120# The name of an image file (within the static path) to use as favicon of the 
  • canSAS2012/docs/source/contents.rst

    r227 r230  
    1010   :maxdepth: 2 
    1111    
     12   basics 
    1213   framework 
    1314   implementation 
  • canSAS2012/docs/source/index.rst

    r227 r230  
    5757.. [#]  http://www.smallangles.net/wgwiki/index.php/canSAS-2012 
    5858.. [#]  http://www.smallangles.net/wgwiki/index.php/2012_Data_Discussion 
     59 
     60 
     61 
     62..      ---------------------------------------------------------------------- 
     63        #################################################################### 
     64        ### These remarks should be folded into the introduction above. 
     65        #################################################################### 
     66         
     67        On 2012-08-03, Adrien Rennie writes: 
     68         
     69        One comment that I would make is that, to encourage facilities (and  
     70        facility management) to support this, we have to be clear about  
     71        benefits - particularly as regards science. Even the introduction to  
     72        the data format should emphasize that apart from the obvious step of  
     73        facilitating analysis of large volumes of data, there are two further  
     74        clear advantages: (a) a data format that will enable storage of  
     75        appropriate metadata and of uncertainties in scattering data and  
     76        metadata with sufficient detail to permit their use optimized  
     77        analysis will permit improved interpretation and greater reliability  
     78        of results.  Advances may rely on appropriate regularization of  
     79        models and understanding the distribution and origin of uncertainty  
     80        in data and metadata. (b) Provision of metadata and treated data in a  
     81        systematic way will allow users and facilities to meet more readily  
     82        present and future deposition standards that are being required for  
     83        publications. 
     84 
     85        I hope that marketing the work on the basis of better science will be  
     86        one way to encourage the adoption. 
     87 
     88 
     89..      ---------------------------------------------------------------------- 
     90 
     91        Another advantage of the definition of the standard structure, apart  
     92        from its implementation(s), is to define a common interface where  
     93        reduction stops and analysis starts.  This interface is needed 
     94        especially for analysis of higher dimensionality data. 
Note: See TracChangeset for help on using the changeset viewer.