source: sans/Dev/trunk/Install_Instructions.txt @ 575

Last change on this file since 575 was 388, checked in by srkline, 14 years ago

Last minute tweaks before summer school

File size: 6.3 KB
Line 
1To install the NCNR Reduction and Analysis Package:
2
3(1) - Unzip the downloaded package
4(2) - Double click on the NCNR_Install_or_Update.pxp experiment
5(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.
6(4) - Click on "Install SANS Macros"
7(5) - When the installer is finished, you will be asked to Quit Igor (yes, do it, and save changes to the experiment.)
8(6) - If you were informed that some folders did not have proper permissions, skip down to the section for "Manual Install"
9
10- SANS_Reduction, USANS_Reduction, and Analysis templates are located in the same folder as the installer (these are the starting points)
11- Example data for reduction and analysis are in NCNR_SANS_Utilities
12- A folder with instructions and a template for writing your own analysis function is included (Single_Model_Template)
13- Help files are integral to each template. Open any of the templates and click on "Help" or "?" from any of the panels to view the help files.
14- 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.
15
16
17To Update the Package:
18
19(1) - double click on the NCNR_Install_or_Update.pxp experiment
20(2) - Click on "Check for Updates"
21(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.
22(4) If you need to update, download the current version (.zip), and run the installer as in the first step.
23
24
25Troubleshooting:
26
27(1) - double click on the NCNR_Install_or_Update.pxp experiment
28(2) - Click on "Print Diagnostics"
29(3) - Select and copy the entire contents of the notebook of diagnostics, and paste it into an e-mail.
30
31
32
33-------------------------------------------------------------------
34*** Manual Install of the NCNR SANS/USANS Procedures ***
35-------------------------------------------------------------------
36
37If you were directed by the installer to perform a manual install, it is most likely because you do not have the proper permissions to copy the files into the necessary subfolders of the Igor Pro application folder.
38
39-------------------
40First, if possible, contact your system administrator. See if it is possible to grant you full read/write access to these three folders:
41
42(on Windows)
43/Program Files/WaveMetrics/Igor Pro/Igor Help Files
44/Program Files/WaveMetrics/Igor Pro/Igor Extensions
45/Program Files/WaveMetrics/Igor Pro/User Procedures
46
47(on Mac OSX)
48/Applications/Igor Pro/Igor Help Files
49/Applications/Igor Pro/Igor Extensions
50/Applications/Igor Pro/User Procedures
51
52If 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.
53
54
55If you can't get full permissions, you may still be able to use the macros.
56
57Choose from the Menu Macros->Force Install.
58
59The installer will do as good as it can to install the macros. You must have at a minimum, permission to install in /User Procedures. If you can't get permission to install into /Igor Help Files, you can still open the help files manually as needed. If you can't get permission to install into /Igor Extensions, your calculations will be much slower, and you will not have access to any of the 2D analysis functions. The most common problem is faulty permissions on /Igor Help Files, which is not fatal, just inconvenient.
60
61------------------
62
63If you want to move the files and folders by hand, follow these steps, skipping those operations that you do not have permission to do:
64
65(0) Quit Igor, if it is open.
66
67(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.
68
69(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.
70
71(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.
72
73(4) From the downloaded package, move the entire folder NCNR_User_Procedures to the Igor Pro/User Procedures folder.
74
75(5) Move the entire folder NCNR_Help_Files to the Igor Pro/Igor Help Files folder.
76
77(6) In the NCNR_Extensions folder, move EITHER the Mac_XOP folder or the Win_XOP folder to Igor Pro/Igor Extensions, depending on your operating system. Delete the XOP for the platform that you are not using.
78
79(7) The NCNR_SANS_Utilities folder has the three templates for starting SANS or USANS Reduction experiment, and for an analysis experiment. If the templates open up correctly, you're likely OK. In this folder, there are also example data sets and a template for writing your own analysis model.
80
81
82
83-------------------
84"OLD" User Procedures could be any of the following:
85
86SANS_Reduction_v5.00
87SANS_Reduction_v5.0
88SANS Redn 28OCT03
89SANS Redn 18JUN04
90SANS Redn 23JAN04
91SANS Redn Beta
92SANS_Models_B 09MAY03
93SANS_Models (B)
94SANS_Models Beta
95SANS_Models Beta2
96SANS_Models_v3.00
97SANS_Models_v3.01
98USANS Procedures 13AUG02
99USANS_Procedures_14DEC04
100USANS_Procedures_15DEC05
101USANS Beta Procedures
102USANS Procedures v2.00
103USANS Procedures v2.20
104Put in User Procedures
105NCNR_User_Procedures
106NCNR_Extensions
107NCNR_Help_Files
108
109
110-------------------
111"OLD" Igor Help files could be any of the following:
112
113SANS_Reduction_Help_v5.ihf
114SANSReductionHelp_4p2.ihf
115SANS_Analysis_Docs_v3.00.ihf
116SANSAnalysisHelp(B).ihf
117SANS_Model_Docs_v3.00.ihf
118SANS_Model_Docs_v3.01.ihf
119USANSReductionHelp_v2.20.ihf
120USANSReductionHelp_v2.00.ihf
121USANSReductionHelp_v1.ihf
122SANS_Analysis_Docs_09JUN06.ihf
123SANS_Model_Docs_09JUN06.ihf
124Put in Igor Help Files
125NCNR_Help_Files
126
127
128-------------------
129"OLD" Igor Extensions could be any of the following:
130
131SANS_Analysis.xop
132NCNR_Extensions
133
134Mac_XOP
135Win_XOP
136-------------------
137
138
139
140
141June 2008 SRK
Note: See TracBrowser for help on using the repository browser.