source: sasview/src/sas/models/c_extension/release_notes.txt @ 84cbaae

Release Notes
=============

SAS Models version 0.4.3

Package name: sans.models 

1- What's New in Version 0.4.3
    - Release date: April 21, 2009
    - C extension models now use new C++ classes that incorporate dispersity and averaging
      functionality. See utest_dispersity.py for examples of how to use the new dispersion
      classes.
      
      # Create a model
      model= CylinderModel()
      
      # Create a dispersion model
      disp = GaussianDispersion()
      
          # Set the dispersion for a chosen parameter
          model.set_dispersion('radius', disp)
          
          # Set the parameters of the dispersion model
      model.dispersion['radius']['width'] = 5.0
      model.dispersion['radius']['npts'] = 100


    Version 0.4.3
    -P(Q)*S(Q) added for P(Q)=cylinder, sphere, ellipsoid
    -Array dispersion (user defined) added

    Version 0.4.2
    -4 Structure factors added
    
    Version 0.4.1
    - Release date: 6/9/2008
    - Modified non-shape models so that the 2D output is the 1D output for the length of Q

    Version 0.4.0
        - Release date: 4/15/2008
        - Added shape-independent models.
        
        Version 0.3.2:
        - Release date: 2/14/2008
        - Added models to be used in magnetic analysis.


2- Downloading and Installing

        2.1- System Requirements:
                - Python version >= 2.5 and < 3.0 should be running on the system


        2.2- Installing:
                - Get the code from svn://danse.us/sans/releases/sansmodels-0.4.3
                - Execute the following: 
                        python setup.py install

3- Known Issues

        3.1- All systems:
                - Q range validity of I(q) calculations.
                        Our 1D models of I(q) use the function of the NCNR library 
                        for their IGOR package (Klein, 2006). That library uses a
                        fast integration technique in some of its models (cylinders
                        and ellipsoids). Integration is done using 76 points in the
                        angle between the axis of the object and the q-vector, which
                        translates in a larger inaccuracy at high q. Integratiing
                        the 2D model I(q,phi) over all orientations of the object
                        will not yield the exact same result as the NCNR calculation
                        for q > 0.3 A-1.
                - Refactoring needs to be done to update the model base class.
                  We should get rid of the useless arithmetics and store the parameters
                  as class objects rather than values. This would eliminate the multitude
                  of dictionaries needed to store all the various aspects of a parameter
                  (limits, units, dispersity information). The C++ design it relies
                  on is much cleaner in that respect, but it still depends on the old
                  C computation. Those should be incorporated in the C++ classes.

        3.2- Windows:
                - None

        3.3- Linux:
                - None

4- Troubleshooting

        - None

5- Frequently Asked Questions

        - None

6- Other Resources

        - See: http://danse.us/trac/sans/wiki/8_2_2_1DModelFitting
        - See: http://danse.us/trac/sans/wiki/8_2_3_2DModeling
        - See: http://danse.us/trac/sans/wiki/8_2_6_model_extensions
        - See: http://danse.us/trac/sans/wiki/8_2_1Nonshape_models