% guisdap170 README, version of 20011130, bi % % This file contains information on Guisdap 1.70. % It is a modified version of the guisdap170/README file. % It contains the following sections: % % - Installation notes % - Some changes from version 1.65 % - Major revision history % % Version number 1.70 has been used in order to inaugurate a new EISCAT version % of the Guisdap software and to provide an unambiguous point of reference for % future changes. % % Note that the acronym "eisdap" stands for "EISCAT Data Analysis Package". % Installation notes: % % (1) Download guisdap170.20011126.tar.gz from the web page % % http://www.eiscat.uit.no/data_analysis/eisdap/guisdap17.html % % It is a 32 MB download. % % (2) Uncompress and untar using % % gunzip guisdap170.20011126.tar.gz % and % tar xvf guisdap170.20011126.tar % % Uncompressed, it takes up about 260 MB of disk space. % % (3a) Change the "/data0/analysis/" in the following path to suit your system: % % result_path = sprintf('/data0/analysis/%d-%02d-%02d_%s_%s_%d_%s/', ... % % (3b) Change the "/opt/eiscat/apps/" in the path in all of the following paths % to suit your system: % % shell/cshrc_eisdap: set path=( /opt/eiscat/apps/guisdap170/scripts/ $path ) % shell/cshrc_eisdap: setenv LD_LIBRARY_PATH /opt/eiscat/apps/guisdap170/uklib % % scripts/ana: MATLABPATH=/opt/eiscat/apps/guisdap170/Tromso % scripts/eisdap: MATLABPATH=/opt/eiscat/apps/guisdap170/Tromso % scripts/eisdapb_matlab: MATLABPATH=/opt/eiscat/apps/guisdap170/Tromso % % Tromso/main/guppath.m: path('/opt/eiscat/apps/guisdap170/m165',p); p = path; % Tromso/main/guppath.m: path('/opt/eiscat/apps/guisdap170/m165gr',p); p = path; % Tromso/main/guppath.m:% path('/opt/eiscat/apps/guisdap170/m165ESR',p); p = path; % Tromso/main/guppath.m: path('/opt/eiscat/apps/guisdap170/Tromso',p); p = path; % Tromso/main/start_GUP.m: path_GUP='/opt/eiscat/apps/guisdap170/'; % % Tromso/analysissetup.m: path('/opt/eiscat/apps/guisdap170/m165',path); % Tromso/analysissetup.m: path('/opt/eiscat/apps/guisdap170/m165gr',path); % Tromso/analysissetup.m: path('/opt/eiscat/apps/guisdap170/m165KST',path); % Tromso/analysissetup.m: path('/opt/eiscat/apps/guisdap170/mex152',path); % Tromso/analysissetup.m: path('/opt/eiscat/apps/guisdap170/uklib',path); % Tromso/analysissetup.m: path('/opt/eiscat/apps/guisdap170/Tromso',path); % Tromso/analysissetup.m: path('/opt/eiscat/apps/guisdap170/Tromso/main',path); % Tromso/analysissetup.m: path('/opt/eiscat/apps/guisdap170/Tromso/frontend',path); % Tromso/analysissetup.m: path('/opt/eiscat/apps/guisdap170/Tromso/frontend/newsystem_2gup',path); % Tromso/analysissetup.m: path('/opt/eiscat/apps/guisdap170/SuperDARN',path); % Tromso/analysissetup.m: path_GUP='/opt/eiscat/apps/guisdap170/'; % Tromso/analysissetup.m: path_exps='/opt/eiscat/apps/guisdap170/exps/'; % Tromso/analysissetup.m: path_GUP='/opt/eiscat/apps/guisdap170/'; % Tromso/analysissetup.m: path_exps='/opt/eiscat/apps/guisdap170/exps/'; % % m165/start_GUP.m: path_GUP='/opt/eiscat/apps/guisdap170/'; % % (4) Add the following line to your .cshrc file: % % source /opt/eiscat/apps/guisdap170/shell/cshrc_eisdap % % or do the equivalent for whatever shell you prefer. Note that you must replace % the "/opt/eiscat/apps/" part of the path by your own installation path, the same % as in item (3b) above. % % (5) To run Guisdap 1.70, you may cd into the Tromso/ directory and type "analysis" % as before. However, there are also three new ways to run Guisdap 1.70: % % (a) The command "eisdap" may be used directly from the Unix shell command prompt % from any directory, so long as the shell is set up as described above. % % (b) "eisdapb " will run the analysis in a batch mode. Copy and rename % file Tromso/analysis_batch_inputs.m into your own directory, e.g. % % cp Tromso/analysis_batch_inputs.m ~// % % Then, edit myinputfile for the parameters you prefer, then type % % eisdapb % % to run the analysis. % % (c) "ana" runs the analysis in a simplified mode, for use by the site staff when % starting common programs. % % Please report any problems to Brett Isham at . % Some changes from version 1.65: % % = Three new startup options have been added as described above. Much of the code % from analysis.m is now contained in the files Tromso/analysissetup.m and % Tromso/analysisconfigure.m. analysissetup.m includes an initial check for valid % program names. As noted, the file analysis.m functions as before. % % = The file Tromso/an_start.m (or Tromso/NWan_start.m) has been renamed to % Tromso/main/analysismain_NW.m and is called from analysissetup.m, exactly as it % was before from analysis.m. % % = Code that was in Tromso/GUISPERT.m is now in Tromso/frontend/frontend.m and in % files called from there. In particular, code for the old system analysis, new % system analysis, transmitter power, and antenna pointing has been separated out % into separate files. Tromso/frontend/frontend.m is called immediately before % GUISPERT.m so that commands inserted into GUISPERT will override other settings % exactly as in the past. % % = frontend.m is called in analysismain_NW.m immediately before GUISPERT.m so that % commands inserted into GUISPERT.m will override other settings exactly as before. % % = The file Tromso/main/get_impresp.m has been corrected to incorporate the mainland % data sampling rate; the incorrect version used the Svalbard rate. All the radar % programs (a.k.a. experiments) supported to date have been reinitialized in order to % incorporate the correction. This change reduces the apparent value of the system % constant by about 35%. % % = The system constant has been correctly calibrated for electron densities in the % cp1lt lp and ac channels as of 10 March, 23-25 April, and 25 November 2001. % % = The new (2001) EISCAT radar program and raw data directory naming convention has % been implemented. Raw data is processed based on the pulse code name only. % % The 2001 EISCAT naming convention may be summarized as follows: % % - Radar program names: % % pulsepattern[_scanpattern][_Comment][_CC] % % where CC is a country code. Fields in square brackets [ ] are optional. % % - Raw data directory names: % % pulsepattern[_scanpattern][_Comment][_CC]@antenna % % where antenna may be uhf, kir, sod, vhf0, vhf1, vhf2, 32m, or 42m. % % = Future versions will incorporate analysis for the remote sites and the tau2, tau3, % arc, and dlayer programs. ESR data, which has until now been handled separately % from the mainland data, will also be included. % Major revision history (since 20001001): % % 20011001 bi replace get_impresp.m with Ingemar's new version % 20011002 bi move guisdap files to /opt/eiscat/apps/guisdap/ % adjusted analysis.m for both new and old names % updated GUISPERT.m for 2001 name convention and for /opt/eiscat/ % using name_pulse in analysis.m and GUISPERT.m instead of name_expr % added tau1 and tau1v to start_analysis_NW % reinitialized all radar programs in exps/ directory % Tromso/ directory extensively reorganized % bug: path_GUP set in Tromso/start_GUP.m (perhaps should be in Tromso/analysis.m) % 20011104 bi start_analysis_NW renamed to analysismain_NW % GUISPERT.m replaced by frontend/frontend.m, called from analysismain_NW % /opt/eiscat/apps/guisdap/ renamed to /opt/eiscat/apps/guisdap165/ % 20011111 bi add options for keyboard, commonrt, and batch input modes % analysis_commonrt.m is for operators and others to start standard CP rt analysis % analysis_batch.m executes file ./analysis_batch_inputs/analysis_batch_inputs_template.m % analysis.m calls analysis_keyboard.m and functions % 20011119 bi guisdap165/ renamed to guisdap170/ for clear reference and as eiscat version