To install the NCNR Reduction and Analysis Package: (1) - Unzip the downloaded package. Be sure to extract all (2) - Double click on the NCNR_Install_or_Update.pxp experiment (3) - If there are any help files open, you will be asked to close them. NOTE: be sure to hold down the option (or alt) key when closing them to kill them, not just hide them. (4) - Click on "Install SANS Macros" (5) - When the installer is finished, and you will see four lines of "copy...: OK" in the command window at the bottom of the screen, indicating a successful install. You will be asked to Quit Igor (yes, do it, and save changes to the experiment.) --- If you were informed that some folders did not have proper permissions, (you'll see "ERROR" rather then OK, and some alerts about procedures that could not be removed) -- then skip down to the section for "Manual Install" After a successful install: - When you restart Igor, there will be 4 "Load..." macros in the Macros menu for you to load the SANS or USANS Reduction packages, or the Analysis package. This is the starting point. There are no longer any "template" experiments necessary. Any or all of the packages can now be loaded into the same experiment. - Example data for reduction and analysis are in NCNR_SANS_Utilities - A folder with instructions and a template for writing your own analysis function is included (Single_Model_Template) - Help files are integral to each package. Click on "Help" or "?" from any of the panels to view the help files. - Any previous installations, including any files you may have modified are moved to the NCNR_Moved_Files folder. Look in here for anything that you may want to save. To Update the Package: (1) - double click on the NCNR_Install_or_Update.pxp experiment (2) - Click on "Check for Updates" (3) - The updater will check the version installed versus the version available on the NCNR website. If your version is out-of-date, you will be sent to the NCNR website. (4) If you need to update, download the current version (.zip), and run the installer as in the first step. Troubleshooting: (1) - double click on the NCNR_Install_or_Update.pxp experiment (2) - Click on "Print Diagnostics" (3) - Select and copy the entire contents of the notebook of diagnostics, and paste it into an e-mail. ------------------------------------------------------------------- *** Manual Install of the NCNR SANS/USANS Procedures *** ------------------------------------------------------------------- If you were directed by the installer that there were old NCNR procedures present that need to be removes, it is most likely because you do not have the proper permissions to move the files from the necessary subfolders of the Igor Pro application folder. ------------------- First, if possible, contact your system administrator. See if it is possible to grant you full read/write access to these three folders: (on Windows) /Program Files/WaveMetrics/Igor Pro/Igor Help Files /Program Files/WaveMetrics/Igor Pro/Igor Extensions /Program Files/WaveMetrics/Igor Pro/User Procedures (on Mac OSX) /Applications/Igor Pro/Igor Help Files /Applications/Igor Pro/Igor Extensions /Applications/Igor Pro/User Procedures If you or someone can reset the permissions on these folders so you can read and write, then re-run the installer, and it should work correctly without errors. If you can't get full permissions, you may still be able to use the macros. You may need to remove some of the old NCNR procedures by hand, granting permission for each move. To do this, follow these steps, skipping those operations that you do not have permission to do: (0) Quit Igor, if it is open. (1) Clean out ALL of the older versions of the NCNR macros from the User Procedures folder. Move them to the trash/recycle, and be sure to EMPTY the trash/recycle. The files to remove will have a variety of names. See the listing at the bottom of this file. (2) Clean out all of the older versions of the NCNR Help Files from the Igor Help Files folder. Move them to the trash/recycle, and be sure to EMPTY the trash/recycle. Again, see the listing of possible names at the bottom of this file. (3) Clean out all of the older versions of the NCNR Extensions from the Igor Extensions folder. Move them to the trash/recycle, and be sure to EMPTY the trash/recycle. Again, see the listing of possible names at the bottom of this file. -- now with all of the old material removed, re-run the installer. All should be OK now. If, for some bizarre reason it is not, continue by moving procedures in manually. These locations are not in the application folder, so you will have write permission. (4) From the downloaded package, move the entire folder NCNR_User_Procedures to: :Documents:WaveMetrics:Igor Pro 6 User Files:User Procedures or on Windows: MyDocuments\WaveMetrics\Igor Pro 6 User Files\User Procedures (5) Move the entire folder NCNR_Help_Files to: :Documents:WaveMetrics:Igor Pro 6 User Files:Igor Help Files or on Windows: MyDocuments\WaveMetrics\Igor Pro 6 User Files\Igor Help Files (6) In the NCNR_Extensions folder, move EITHER the Mac_XOP folder or the Win_XOP folder to: :Documents:WaveMetrics:Igor Pro 6 User Files:Igor Extensions or on Windows: MyDocuments\WaveMetrics\Igor Pro 6 User Files\Igor Extensions (7) Move the entire folder NCNR_Igor_Procedures to: :Documents:WaveMetrics:Igor Pro 6 User Files:Igor Procedures or on Windows: MyDocuments\WaveMetrics\Igor Pro 6 User Files\Igor Procedures (8) Launch Igor. The "Load..." macros should appear under the Macros menu. ------------------- "OLD" User Procedures could be any of the following: SANS_Reduction_v5.00 SANS_Reduction_v5.0 SANS Redn 28OCT03 SANS Redn 18JUN04 SANS Redn 23JAN04 SANS Redn Beta SANS_Models_B 09MAY03 SANS_Models (B) SANS_Models Beta SANS_Models Beta2 SANS_Models_v3.00 SANS_Models_v3.01 USANS Procedures 13AUG02 USANS_Procedures_14DEC04 USANS_Procedures_15DEC05 USANS Beta Procedures USANS Procedures v2.00 USANS Procedures v2.20 Put in User Procedures NCNR_User_Procedures NCNR_Extensions NCNR_Help_Files ------------------- "OLD" Igor Help files could be any of the following: SANS_Reduction_Help_v5.ihf SANSReductionHelp_4p2.ihf SANS_Analysis_Docs_v3.00.ihf SANSAnalysisHelp(B).ihf SANS_Model_Docs_v3.00.ihf SANS_Model_Docs_v3.01.ihf USANSReductionHelp_v2.20.ihf USANSReductionHelp_v2.00.ihf USANSReductionHelp_v1.ihf SANS_Analysis_Docs_09JUN06.ihf SANS_Model_Docs_09JUN06.ihf Put in Igor Help Files NCNR_Help_Files ------------------- "OLD" Igor Extensions could be any of the following: SANS_Analysis.xop NCNR_Extensions Mac_XOP Win_XOP ------------------- APR 2010 SRK