Changeset 7aab144 in sasview for installers/README.txt
- Timestamp:
- Sep 9, 2018 5:54:22 AM (6 years ago)
- Branches:
- master, magnetic_scatt, release-4.2.2, ticket-1009, ticket-1094-headless, ticket-1242-2d-resolution, ticket-1243, ticket-1249, unittest-saveload
- Children:
- 7e736c6
- Parents:
- 711d7e7
- File:
-
- 1 edited
Legend:
- Unmodified
- Added
- Removed
-
installers/README.txt
r2b07b6d r7aab144 1 1 Release Notes 2 2 ============= 3 This is a beta pre-release version of 4.2.0. A number of fixes and changes 4 have been made in the year since the previous release. 5 Full release notes will be compiled prior to the full release 4.2.0. 3 4 1- Features 5 =========== 6 - New in Version 4.2.0 7 -------------------- 8 This release heralds many improvements and a host of bug fixes, along with 9 some significant changes from previous versions. Further, as promised, it 10 marks the end of support for 32 bit operating systems and is only 11 available for 64bit operating systems. With this version the change to the 12 new model API and plugins infrastructure begun with 4.0 is essentially 13 complete (though extensions are in the works and more are likely they 14 should remain backwardly compatible with previous versions of SasView). 15 NOTE: old style plugin models, including old sum|mul mocels will continue 16 to be supported (i.e. SasView will be able to run them) in 4.x. However, 17 the expectation is that such support will be removed in 5.0 and everyone 18 is strongly encouraged to convert their custom models to the new API. 19 Finally, the new orientation angles and orientatinal distribution is now 20 also complete. 21 22 - Changes 23 - The infrastucture for calculating 2D patterns from 3D orientated objects 24 has been totally re-factored. It is now more accurate and consistent 25 across models. 26 - The way that SasView defines the orientation of anisometric and 27 aligned objects has been completely overhauled. It now differs from 28 previous versions. 29 - Plugin models, including sum/multiply models, have completely migrated 30 to the new infrastructure. NOTE that 3.x type models as well as early, 31 intermediate 4.x type models, including those generated by sum|multiply 32 will continue to be supported in 4.x but will likely no longer be 33 supported after the move to 5.0. Users are strongly encouraged to 34 migrate any custom models. 35 - The NeXus loader has been removed as it is superseded by the NXcanSAS 36 standard loader and SasView does not support the treatment of raw 37 data. 38 - Improvements 39 - The accuracy/speed of some numerical integrations have been improved. 40 - An orientation viewer tool has been introduced to assist in 41 understanding the new orientation framework. 42 - Problems with the computation of magnetic scattering from some 43 objects have been rectified. Some questions however remain. 44 - The known issue with the core_shell_parallelepiped model is now fixed. 45 - A number of issues and inconsistencies with the creation of 46 sum|product models have been rectified. 47 - A Boltzmann distribution has been added for polydispersity/orientational 48 distributions. 49 - Some batch slicing options have been introduced. 50 - Correlation function analysis now computes both the 1D and 3D functions. 51 - There are several data loading improvements. 52 - There are several improvements to Save/Load Project. 53 - There have been numerous other bug fixes. 54 - Documentation 55 Several sections of the help documentation have undergone significant 56 checking and updating, particularly those relating to orientation, 57 magnetic scattering, and polydispersity distributions. Detailed 58 advanced instructions for plugin writing and some scripting 59 instructions have been added. 60 - Other work 61 - A Third-Party initiative has recently succeeded in getting SasView to 62 run on Debian. More details at 63 http://trac.sasview.org/wiki/DevNotes/Projects/Debian 64 - With this release we have started to prepare for the inevitable move 65 to Python 3, which will occur with the release of 5.0 66 - SasView 5.0 is currently in development. The two most significant 67 features of this version will be (i) a move away from the present 68 WxPython GUIs to new, completely rewritten, Qt5 GUIs, and 69 (ii)implementation of the Beta-approximation for S(Q). Subject to 70 resources, some limited access to the latter functionality may be 71 available in a future SasView 4.x release. 72 - Bug Fixes 73 Fixes # 260: Box integration does not update when entering values in dialog 74 Fixes # 446: Saving plot as PGF (not PDF!) format throws error 75 Fixes # 467: Extend batch functionality to slicer 76 Fixes # 489: ABS reader (NIST 1D) does not handle negative dx properly 77 (USANS slit smearing) 78 Fixes # 499: create sin(x)/x, 2*J1(x)/x and 3*j1(x)/x functions 79 Fixes # 510: Build PDF documentation along with HTML 80 Fixes # 525: Add GUI category defaults to models in sasmodels 81 Fixes # 579: clean up sasview directory 82 Fixes # 597: Need to document Combine Batch Fit 83 Fixes # 645: GUI logic problem in Batch vs single fit mode 84 Fixes # 648: Need to allow user input background value in Pr perspective 85 Fixes # 685: Fix data upload to marketplace 86 Fixes # 695: linear slope in onion model 87 Fixes # 735: Review new Corfunc documentation 88 Fixes # 741: Recalculate P(Q) and S(Q) components on model update. 89 Fixes # 767: Sum/Product Models don't do what they should 90 Fixes # 776: angular dispersity 91 Fixes # 784: Add 3D integral to Correlation Function analysis 92 Fixes # 786: core_shell_parallelepiped 1-D model is incorrect 93 Fixes # 818: report button followed by save makes an empty pdf file 94 Fixes # 838: Fix model download from marketplace 95 Fixes # 848: can't save analysis when only one fit page 96 Fixes # 849: Load Folder should ignore files starting with . 97 Fixes # 852: More unit tests, especially for oriented or 2d models 98 Fixes # 854: remove unnecessary sleep() in fitting perspective 99 Fixes # 856: Reading SAS_OPENCL from custom_config sometimes raises an ERROR 100 Fixes # 861: cannot defined a structure factor plugin 101 Fixes # 864: New Model Editor (simple plugin editor) error parsing 102 parameter line 103 Fixes # 865: Plugin live discovery issues 104 Fixes # 866: inform user when NaN is returned from compute 105 Fixes # 869: fit page computation thread cleanup 106 Fixes # 875: Possible weirdness with 1D NXcanSAS data 107 Fixes # 876: Add check for HDF5 format in dataloader 108 Fixes # 887: reorganize tree, separating the installed source from the 109 build source 110 Fixes # 889: Refactor dataloader error handling infrastructure 111 Fixes # 890: use new orientation definition for asymmetric shapes 112 Fixes # 891: update docs for oriented shapes with new orientation definition 113 Fixes # 896: equations in core shell parallelepiped docs do not match code 114 Fixes # 898: Image Viewer Tool file selector issue 115 Fixes # 899: Igor Reader q calculation 116 Fixes # 902: IgorReader Q calculation needs fixing/improving 117 Fixes # 903: sasview - all non-gui tests should be converted to run in Python 3 118 Fixes # 906: polydispersity not showing up in tabulated results 119 Fixes # 912: About box points to misleading contributors page on Github 120 Fixes # 915: load project issues 121 Fixes # 916: Proper Logging 122 Fixes # 920: Logarithmic binning option in the slice viewer 123 Fixes # 921: Improve developer communication methods 124 Fixes # 922: Remove support for all data formats that are not in q space 125 Fixes # 923: Add CI and trac integrations to Slack 126 Fixes # 930: fitting help says chisq is normalized to number of points 127 Fixes # 931: Allow admins to edit all models and upload data etc on 128 marketplace 129 Fixes # 932: Need to fix upload of data files to marketplace 130 Fixes # 934: Slurp tutorial repo for tutorials 131 Fixes # 935: Build new tutorials as PDF 132 Fixes # 943: Deep copy error on setting model after data is selected 133 Fixes # 950: Most of the readers don't close files properly. 134 Fixes # 954: cross check dll/opencl/python polydispersity and 135 orientation results 136 Fixes # 956: Possible problem with new doc build process 137 Fixes # 961: sasmodels tests should fail if the parameter name does not exist 138 Fixes # 962: star polymer typo in docs 139 Fixes # 967: no uncertainties errors on fitting parameters 140 Fixes # 969: About Box not picking up dls_logo.png 141 Fixes # 970: ASCII loader doesn't handle ISIS 2D ASCII 142 Fixes # 974: blacklist Intel HD 620/630 for double precision 143 Fixes # 978: load project fails for pages which have not been defined 144 Fixes # 983: Remove Nexus Loader 145 Fixes # 984: PDF reports are not being properly generated on Windows 146 Fixes # 985: Saving Project Fails 147 Fixes # 986: Send to fitting overwrites theory page even if blank 148 FitPage has focus 149 Fixes # 990: utest_sasview.py giving different results than run_one.py 150 Fixes # 993: Windows x64 versions not installing to correct folder 151 Fixes # 994: Error changing fit engine 152 Fixes # 995: OpenCL required on Linux even if turned off in GUI 153 Fixes #1006: multiplicity models don't work with SQ 154 Fixes #1007: spherical_sld model freezes SasView 155 Fixes #1008: plugin model scaling not working? S 156 Fixes #1010: Win64 build script not creating working executable 157 Fixes #1011: sld_test failing on ubuntu 158 Fixes #1013: FileReaderBaseClass output[] not reset - same file loaded 159 multiple times 160 Fixes #1018: add Boltzmann distribution 161 Fixes #1021: add PDF documentation to website and document in wiki 162 release process 163 Fixes #1024: Update version numbers in master 164 Fixes #1025: Sum/multiply editor hangs 165 Fixes #1032: convert C++ modules to C 166 Fixes #1035: Order of combining P(Q) and S(Q) in Plugins seems to matter 167 Fixes #1037: data loader crop not working? & all fits crashing 168 Fixes #1043: problem compiling marketplace models 169 Fixes #1050: fix appveyor test for sasmodels win 64 python 3 170 Fixes #1052: Can't use a user-created plugin model in a plugin model 171 Fixes #1057: phi rotation issue for elliptical cylinder 172 Fixes #1060: incorrect default for rectangle dispersion 173 Fixes #1062: win32 build not installing correctly 174 Fixes #1064: Fitting did not converge!!! error with a Sum|Multi plugin model 175 Fixes #1069: GUI problem when using polydispersity/orientation distributions 176 Fixes #1070: Parameter error boxes should not be editable 177 Fixes #1079: Remove save button in report dialog on Mac 178 Fixes #1081: GUI problem with new orientation distribution 179 Fixes #1083: Magnetic models not being computed 180 Fixes #1099: Erratic behaviour of Sum|Multi model in 4.1.2 181 Fixes #1101: Batch results page not displaying polydispersity values 182 Fixes #1131: OpencCl dialog does not open 183 Fixes #1132: Slit Size Calculator Tool not working 184 Fixes #1139: Missing Docs and Help for new Batch Slicing 185 Fixes #1141: Intro to scripting.rst needs improvement 186 Fixes #1142: Plugin framework is broken 187 Fixes #1044: Unable to upload c file to marketplace 188 Fixes #1145: Update models in model marketplace to 4.2 when 4.2 is released. 189 Fixes #1148: Documentation for S(Q) models need updating 190 Fixes #1128: AutoPlot generation for model documentation does not 191 include background 192 193 It is recommended that all users upgrade to this version, but your 194 attention is drawn to the Changes section above. 195 196 - New in Version 4.2.0-Beta 197 ------------------------- 198 This is a beta pre-release version of 4.2.0. A number of fixes and changes 199 have been made in the year since the previous release. Full release notes 200 will be compiled prior to the full release 4.2.0. 6 201 7 Highlights are:202 Highlights are: 8 203 - Infrastucture for calculating 2D patterns from 3D orientated objects 9 204 has now been totally refactored 10 205 - Plugins have completely migrated to the new infrastructure now, 11 including sum/multiply models206 including sum/multiply models 12 207 - Some batch slicing options have been introduced 13 208 - The known issue with the core_shell_parallelepiped is now fixed … … 17 212 - Lots of documentation enhancement 18 213 19 In the meantime please report any bugs or issues found while using this beta 20 21 1- Features 22 =========== 214 In the meantime please report any bugs or issues found while using this beta 215 216 23 217 - New in Version 4.1.2 24 218 -------------------- … … 448 642 ============================= 449 643 450 *** Note 1: Much more information is available at www.sasview.org under links. 451 Look in the 'For Developers' section and particularly the wiki at 452 www.sasview.org/trac/wiki. 644 *** Note 1: The easiest approach to setting up the propoer environment to 645 build from source is to use conda. Instructions for setting up 646 using conda can be found at: 647 http://trac.sasview.org/wiki/DevNotes/CondaDevSetup 453 648 *** Note 2: If you have EXE or ZIP SasView installer, you won't need any of 454 649 the following. However it is highly recommended that any 455 650 previous versions be un-installed prior to installing the 456 651 new version. 652 *** Note 3: Much more information is available at www.sasview.org under links. 653 Look in the 'For Developers' section and particularly the wiki at 654 www.sasview.org/trac/wiki. 457 655 458 656 2.1- System Requirements … … 464 662 - to follow the current development version from source control use 465 663 git clone https://github.com/SasView/sasview.git 664 git clone https://github.com/Sasview/sasmodels.git 466 665 git clone https://github.com/bumps/bumps.git 467 666 - to install a specific version … … 477 676 - clone the source from git; also clone bumps, which is developed in parallel 478 677 git clone https://github.com/SasView/sasview.git 678 git clone https://github.com/Sasview/sasmodels.git 479 679 git clone https://github.com/bumps/bumps.git 480 680 - open a command line window in the 'sasview' directory … … 482 682 - run 'python run.py'; this runs from the source directories, so you 483 683 don't have to rebuild every time you make a change, unless you are 484 changing the C++ model files 485 486 - The following modules are required (version numbers are what are used 487 in the windows release build): 488 489 - Common Packages 490 - reportlab 3.1.44 491 - lxml 3.4.4.0 (MAC 3.4.2.0) 492 - PIL 1.1.7 493 - xhtml2pdf 3.0.33 (MAC = not installed on build server) 494 - unittest-xml-reporting 1.12.0 (MAC 1.10.0) 495 - matplotlib Version Installed: 1.4.3 (MAC 1.1.1) 496 - bumps Version Installed: 0.7.5.9 497 - scipy Version Installed: 0.16.0b2 (MAC 0.11.0) 498 - periodictable Version Installed: 1.4.1 499 - setuptools Version Installed: 7.0 (MAC 12.0.5) 500 - sphinx Version Installed: 1.3.1 (MAC 1.3b2) 501 - pyparsing Version Installed: 2.0.3 502 - numpy Version Installed: 1.9.2 (MAC 1.6.2) 503 - html5lib Version Installed: 0.99999 504 - wx Version Installed: 3.0.2.0 505 506 - Windows Specific Packages 507 - pywin 219 508 - py2exe 0.6.9 509 - comtypes 1.1.1 510 - MinGW w/ gcc version 4.6.1 (WIN) 511 - vcredist_x86.exe (version 9.0.21022.8 -microsoft visual C 2008 512 re-distributable) 513 - Innosetup (WIN - isetup 5.4.2-unicode) - used to create distributable 514 515 *** Note: Windows build dependencies can be set up using anaconda. Instructions 516 can be found at http://trac.sasview.org/wiki/AnacondaSetup 517 518 - MAC Specifc Packages 519 - py2app 0.7.1 684 changing the C model files 685 686 -For the latest list of dependencies see the appropriate yml file in 687 the SasView repo at sasview/build_tools/conda/ymls 520 688 521 689 … … 523 691 =============== 524 692 693 694 4.2.0 - All systmes 695 There are currently no major known issues. A full list of known bugs and 696 feature requests by release version that users may wish to be aware of 697 can be viewed at http://trac.sasview.org/report/3 698 NOTE: Any corrections to models that may become known/available will be 699 posted to Marketplace as available (and fixed in the following release) 525 700 526 701 4.1- All systems:
Note: See TracChangeset
for help on using the changeset viewer.