| 1 | Release Notes |
|---|
| 2 | ============= |
|---|
| 3 | |
|---|
| 4 | SANS Models version 0.4.1 |
|---|
| 5 | |
|---|
| 6 | Package name: sans.models |
|---|
| 7 | |
|---|
| 8 | 1- What's New in Version 0.? |
|---|
| 9 | - Release date: ? |
|---|
| 10 | - C extension models now use new C++ classes that incorporate dispersity and averaging |
|---|
| 11 | functionality. |
|---|
| 12 | |
|---|
| 13 | Version 0.4.1 |
|---|
| 14 | - Release date: 6/9/2008 |
|---|
| 15 | - Modified non-shape models so that the 2D output is the 1D output for the length of Q |
|---|
| 16 | |
|---|
| 17 | Version 0.4.0 |
|---|
| 18 | - Release date: 4/15/2008 |
|---|
| 19 | - Added shape-independent models. |
|---|
| 20 | |
|---|
| 21 | Version 0.3.2: |
|---|
| 22 | - Release date: 2/14/2008 |
|---|
| 23 | - Added models to be used in magnetic analysis. |
|---|
| 24 | |
|---|
| 25 | |
|---|
| 26 | 2- Downloading and Installing |
|---|
| 27 | |
|---|
| 28 | 2.1- System Requirements: |
|---|
| 29 | - Python version >= 2.4 should be running on the system |
|---|
| 30 | |
|---|
| 31 | 2.2- Installing: |
|---|
| 32 | - Get the code from svn://danse.us/sans/releases/sansmodels-0.4.0 |
|---|
| 33 | - Execute the following: |
|---|
| 34 | python setup.py install |
|---|
| 35 | |
|---|
| 36 | 3- Known Issues |
|---|
| 37 | |
|---|
| 38 | 3.1- All systems: |
|---|
| 39 | - Q range validity of I(q) calculations. |
|---|
| 40 | Our 1D models of I(q) use the function of the NCNR library |
|---|
| 41 | for their IGOR package (Klein, 2006). That library uses a |
|---|
| 42 | fsat integration technique in some of its models (cylinders |
|---|
| 43 | and ellipsoids). Integration is done using 76 points in the |
|---|
| 44 | angle between the axis of the object and the q-vector, which |
|---|
| 45 | translates in a larger inaccuracy at high q. Integratiing |
|---|
| 46 | the 2D model I(q,phi) over all orientations of the object |
|---|
| 47 | will not yield the exact same result as the NCNR calculation |
|---|
| 48 | for q > 0.3 A-1. |
|---|
| 49 | - Refactoring needs to be done to update the model base class. |
|---|
| 50 | We should get rid of the useless arithmetics and store the parameters |
|---|
| 51 | as class objects rather than values. This would eliminate the multitude |
|---|
| 52 | of dictionaries needed to store all the various aspects of a parameter |
|---|
| 53 | (limits, units, dispersity information). The C++ design it relies |
|---|
| 54 | on is much cleaner in that respect, but it still depends on the old |
|---|
| 55 | C computation. Those should be incorporated in the C++ classes. |
|---|
| 56 | |
|---|
| 57 | 3.2- Windows: |
|---|
| 58 | - None |
|---|
| 59 | |
|---|
| 60 | 3.3- Linux: |
|---|
| 61 | - None |
|---|
| 62 | |
|---|
| 63 | 4- Troubleshooting |
|---|
| 64 | |
|---|
| 65 | - None |
|---|
| 66 | |
|---|
| 67 | 5- Frequently Asked Questions |
|---|
| 68 | |
|---|
| 69 | - None |
|---|
| 70 | |
|---|
| 71 | 6- Other Resources |
|---|
| 72 | |
|---|
| 73 | - See: http://danse.us/trac/sans/wiki/8_2_2_1DModelFitting |
|---|
| 74 | - See: http://danse.us/trac/sans/wiki/8_2_3_2DModeling |
|---|
| 75 | - See: http://danse.us/trac/sans/wiki/8_2_6_model_extensions |
|---|
| 76 | - See: http://danse.us/trac/sans/wiki/8_2_1Nonshape_models |
|---|
| 77 | |
|---|
| 78 | |
|---|
| 79 | |
|---|
| 80 | |
|---|
| 81 | |
|---|
| 82 | |
|---|
