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

Last change on this file since 740 was 685, checked in by srkline, 12 years ago

new version of the install instructions

new version of the "installedVersion" - now set to 7.0, but this is open for debate.

adjusted button and control positioning on the 2D MC control panel.

File size: 6.8 KB
Line 
1To install the NCNR Reduction and Analysis Package:
2
3
4
5(1) - Unzip the downloaded package. Be sure to extract all
6
7(2) - Double click on the NCNR_Install_or_Update.pxp experiment
8
9(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.
10
11(4) - Click on "Install SANS Macros"
12
13(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.)
14
15--- 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"
16
17
18
19After a successful install:
20
21
22- 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.
23
24- Example data for reduction and analysis are in NCNR_SANS_Utilities
25
26- A folder with instructions and a template for writing your own analysis function is included (Single_Model_Template)
27
28- Help files are integral to each package. Click on "Help" or "?" from any of the panels to view the help files.
29
30- 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.
31
32
33
34
35
36To Update the Package:
37
38
39
40(1) - double click on the NCNR_Install_or_Update.pxp experiment
41
42(2) - Click on "Check for Updates"
43
44(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.
45
46(4) If you need to update, download the current version (.zip), and run the installer as in the first step.
47
48
49
50
51
52Troubleshooting:
53
54
55
56(1) - double click on the NCNR_Install_or_Update.pxp experiment
57
58(2) - Click on "Print Diagnostics"
59
60(3) - Select and copy the entire contents of the notebook of diagnostics, and paste it into an e-mail.
61
62
63
64
65
66
67
68-------------------------------------------------------------------
69
70*** Manual Install of the NCNR SANS/USANS Procedures ***
71
72-------------------------------------------------------------------
73
74
75
76If 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.
77
78
79
80-------------------
81
82First, if possible, contact your system administrator. See if it is possible to grant you full read/write access to these three folders:
83
84
85
86(on Windows)
87
88/Program Files/WaveMetrics/Igor Pro/Igor Help Files
89
90/Program Files/WaveMetrics/Igor Pro/Igor Extensions
91
92/Program Files/WaveMetrics/Igor Pro/User Procedures
93
94
95
96(on Mac OSX)
97
98/Applications/Igor Pro/Igor Help Files
99
100/Applications/Igor Pro/Igor Extensions
101
102/Applications/Igor Pro/User Procedures
103
104
105
106If 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.
107
108
109
110
111
112If 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.
113
114To do this, follow these steps, skipping those operations that you do not have permission to do:
115
116
117
118(0) Quit Igor, if it is open.
119
120
121
122(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.
123
124
125
126(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.
127
128
129
130(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.
131
132
133-- 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.
134
135
136
137(4) From the downloaded package, move the entire folder NCNR_User_Procedures to:
138<user>:Documents:WaveMetrics:Igor Pro 6 User Files:User Procedures
139or on Windows:
140MyDocuments\WaveMetrics\Igor Pro 6 User Files\User Procedures
141
142
143(5) Move the entire folder NCNR_Help_Files to:
144<user>:Documents:WaveMetrics:Igor Pro 6 User Files:Igor Help Files
145or on Windows:
146MyDocuments\WaveMetrics\Igor Pro 6 User Files\Igor Help Files
147
148
149(6) In the NCNR_Extensions folder, move EITHER the Mac_XOP folder or the Win_XOP folder to:
150<user>:Documents:WaveMetrics:Igor Pro 6 User Files:Igor Extensions
151or on Windows:
152MyDocuments\WaveMetrics\Igor Pro 6 User Files\Igor Extensions
153
154(7) Move the entire folder NCNR_Igor_Procedures to:
155<user>:Documents:WaveMetrics:Igor Pro 6 User Files:Igor Procedures
156or on Windows:
157MyDocuments\WaveMetrics\Igor Pro 6 User Files\Igor Procedures
158
159
160(8) Launch Igor. The "Load..." macros should appear under the Macros menu.
161
162
163
164
165
166
167
168-------------------
169
170"OLD" User Procedures could be any of the following:
171
172
173
174SANS_Reduction_v5.00
175
176SANS_Reduction_v5.0
177
178SANS Redn 28OCT03
179
180SANS Redn 18JUN04
181
182SANS Redn 23JAN04
183
184SANS Redn Beta
185
186SANS_Models_B 09MAY03
187
188SANS_Models (B)
189
190SANS_Models Beta
191
192SANS_Models Beta2
193
194SANS_Models_v3.00
195
196SANS_Models_v3.01
197
198USANS Procedures 13AUG02
199
200USANS_Procedures_14DEC04
201
202USANS_Procedures_15DEC05
203
204USANS Beta Procedures
205
206USANS Procedures v2.00
207
208USANS Procedures v2.20
209
210Put in User Procedures
211
212NCNR_User_Procedures
213
214NCNR_Extensions
215
216NCNR_Help_Files
217
218
219
220
221
222-------------------
223
224"OLD" Igor Help files could be any of the following:
225
226
227
228SANS_Reduction_Help_v5.ihf
229
230SANSReductionHelp_4p2.ihf
231
232SANS_Analysis_Docs_v3.00.ihf
233
234SANSAnalysisHelp(B).ihf
235
236SANS_Model_Docs_v3.00.ihf
237
238SANS_Model_Docs_v3.01.ihf
239
240USANSReductionHelp_v2.20.ihf
241
242USANSReductionHelp_v2.00.ihf
243
244USANSReductionHelp_v1.ihf
245
246SANS_Analysis_Docs_09JUN06.ihf
247
248SANS_Model_Docs_09JUN06.ihf
249
250Put in Igor Help Files
251
252NCNR_Help_Files
253
254
255
256
257
258-------------------
259
260"OLD" Igor Extensions could be any of the following:
261
262
263
264SANS_Analysis.xop
265
266NCNR_Extensions
267
268
269
270Mac_XOP
271
272Win_XOP
273
274-------------------
275
276
277
278
279
280
281
282APR 2010 SRK
Note: See TracBrowser for help on using the repository browser.