source: trunk/python/__init__.py@ 317

Last change on this file since 317 was 301, checked in by kil064, 20 years ago

add function resample

  • Property svn:eol-style set to native
  • Property svn:keywords set to Author Date Id Revision
File size: 12.7 KB
Line 
1"""
2This is the ATNF Single Dish Analysis package.
3
4"""
5import os,sys
6
7def validate_bool(b):
8 'Convert b to a boolean or raise'
9 bl = b.lower()
10 if bl in ('f', 'no', 'false', '0', 0): return False
11 elif bl in ('t', 'yes', 'true', '1', 1): return True
12 else:
13 raise ValueError('Could not convert "%s" to boolean' % b)
14
15def validate_int(s):
16 'convert s to int or raise'
17 try: return int(s)
18 except ValueError:
19 raise ValueError('Could not convert "%s" to int' % s)
20
21def asap_fname():
22 """
23 Return the path to the rc file
24
25 Search order:
26
27 * current working dir
28 * environ var ASAPRC
29 * HOME/.asaprc
30
31 """
32
33 fname = os.path.join( os.getcwd(), '.asaprc')
34 if os.path.exists(fname): return fname
35
36 if os.environ.has_key('ASAPRC'):
37 path = os.environ['ASAPRC']
38 if os.path.exists(path):
39 fname = os.path.join(path, '.asaprc')
40 if os.path.exists(fname):
41 return fname
42
43 if os.environ.has_key('HOME'):
44 home = os.environ['HOME']
45 fname = os.path.join(home, '.asaprc')
46 if os.path.exists(fname):
47 return fname
48 return None
49
50
51defaultParams = {
52 # general
53 'verbose' : [True, validate_bool],
54 'useplotter' : [True, validate_bool],
55 'insitu' : [False, validate_bool],
56
57 # plotting
58 'plotter.stacking' : ['p', str],
59 'plotter.panelling' : ['s', str],
60
61 # scantable
62 'scantable.save' : ['ASAP', str],
63 'scantable.autoaverage' : [True, validate_bool],
64 'scantable.freqframe' : ['LSRK', str], #default frequency frame
65 'scantable.allaxes' : [True, validate_bool], # apply action to all axes
66 'scantable.plotter' : [True, validate_bool], # use internal plotter
67
68 # fitter
69 }
70
71def list_rcparameters():
72
73 print """
74 # general
75 # print verbose output
76 'verbose' : True
77
78 # preload a default plotter
79 'useplotter' : True
80
81 # apply operations on the input scantable or return new one
82 'insitu' : False
83
84 # plotting
85 # default mode for colour stacking
86 'plotter.stacking' : 'Pol'
87
88 # default mode for panelling
89 'plotter.panelling' : 'scan'
90
91 # scantable
92 # default ouput format when saving
93 'scantable.save' : 'ASAP'
94 # auto averaging on read
95 'scantable.autoaverage' : True
96
97 # default frequency frame to set when function
98 # scantable.set_freqfrmae is called
99 'scantable.freqframe' : 'LSRK'
100
101 # apply action to all axes not just the cursor location
102 'scantable.allaxes' : True
103
104 # use internal plotter
105 'scantable.plotter' : True
106
107 # Fitter
108 """
109
110def rc_params():
111 'Return the default params updated from the values in the rc file'
112
113 fname = asap_fname()
114
115 if fname is None or not os.path.exists(fname):
116 message = 'could not find rc file; returning defaults'
117 ret = dict([ (key, tup[0]) for key, tup in defaultParams.items()])
118 #print message
119 return ret
120
121 cnt = 0
122 for line in file(fname):
123 cnt +=1
124 line = line.strip()
125 if not len(line): continue
126 if line.startswith('#'): continue
127 tup = line.split(':',1)
128 if len(tup) !=2:
129 print ('Illegal line #%d\n\t%s\n\tin file "%s"' % (cnt, line, fname))
130 continue
131
132 key, val = tup
133 key = key.strip()
134 if not defaultParams.has_key(key):
135 print ('Bad key "%s" on line %d in %s' % (key, cnt, fname))
136 continue
137
138 default, converter = defaultParams[key]
139
140 ind = val.find('#')
141 if ind>=0: val = val[:ind] # ignore trailing comments
142 val = val.strip()
143 try: cval = converter(val) # try to convert to proper type or raise
144 except Exception, msg:
145 print ('Bad val "%s" on line #%d\n\t"%s"\n\tin file "%s"\n\t%s' % (val, cnt, line, fname, msg))
146 continue
147 else:
148 # Alles Klar, update dict
149 defaultParams[key][0] = cval
150
151 # strip the conveter funcs and return
152 ret = dict([ (key, tup[0]) for key, tup in defaultParams.items()])
153 verbose.report('loaded rc file %s'%fname)
154
155 return ret
156
157
158# this is the instance used by the asap classes
159rcParams = rc_params()
160
161rcParamsDefault = dict(rcParams.items()) # a copy
162
163def rc(group, **kwargs):
164 """
165 Set the current rc params. Group is the grouping for the rc, eg
166 for lines.linewidth the group is 'lines', for axes.facecolor, the
167 group is 'axes', and so on. kwargs is a list of attribute
168 name/value pairs, eg
169
170 rc('lines', linewidth=2, color='r')
171
172 sets the current rc params and is equivalent to
173
174 rcParams['lines.linewidth'] = 2
175 rcParams['lines.color'] = 'r'
176
177
178 Note you can use python's kwargs dictionary facility to store
179 dictionaries of default parameters. Eg, you can customize the
180 font rc as follows
181
182 font = {'family' : 'monospace',
183 'weight' : 'bold',
184 'size' : 'larger',
185 }
186
187 rc('font', **font) # pass in the font dict as kwargs
188
189 This enables you to easily switch between several configurations.
190 Use rcdefaults to restore the default rc params after changes.
191 """
192
193 aliases = {
194 }
195
196 for k,v in kwargs.items():
197 name = aliases.get(k) or k
198 key = '%s.%s' % (group, name)
199 if not rcParams.has_key(key):
200 raise KeyError('Unrecognized key "%s" for group "%s" and name "%s"' % (key, group, name))
201
202 rcParams[key] = v
203
204
205def rcdefaults():
206 """
207 Restore the default rc params - the ones that were created at
208 asap load time
209 """
210 rcParams.update(rcParamsDefault)
211
212from asapfitter import *
213from asapreader import reader
214from asapmath import *
215from scantable import *
216from asaplinefind import *
217
218if rcParams['useplotter']:
219 if os.environ.has_key('DISPLAY'):
220 print "Initialising plotter..."
221 import asapplotter
222 plotter = asapplotter.asapplotter()
223 else:
224 print "No $DISPLAY set. Disabling plotter\n"
225
226#from numarray ones,zeros
227
228__date__ = '$Date: 2005-01-25 15:00:39 +0000 (Tue, 25 Jan 2005) $'
229__version__ = '0.2'
230
231def list_scans(t = scantable):
232 import sys, types
233 #meta_t = type(t)
234 #if meta_t == types.InstanceType:
235 # t = t.__class__
236 #elif meta_t not in [types.ClassType, types.TypeType]:
237 # t = meta_t
238 globs = sys.modules['__main__'].__dict__.iteritems()
239 print "The user created scantables are:"
240 x = map(lambda x: x[0], filter(lambda x: isinstance(x[1], t), globs))
241 print x
242
243def commands():
244 x = """
245 [The scan container]
246 scantable - a container for integrations/scans
247 (can open asap/rpfits/sdfits and ms files)
248 copy - returns a copy of a scan
249 get_scan - gets a specific scan out of a scantable
250 summary - print info about the scantable contents
251 set_cursor - set a specific Beam/IF/Pol 'cursor' for
252 further use
253 get_cursor - print out the current cursor position
254 stats - get specified statistic of the spectra in
255 the scantable
256 stddev - get the standard deviation of the spectra
257 in the scantable
258 get_tsys - get the TSys
259 get_time - get the timestamps of the integrations
260 get_unit - get the currnt unit
261 set_unit - set the abcissa unit to be used from this point on
262 get_abcissa - get the abcissa values and name for a given
263 row (time)
264 set_freqframe - set the frame info for the Spectral Axis
265 (e.g. 'LSRK')
266 set_doppler - set the doppler to be used from this point on
267 set_instrument - set the instrument name
268 get_fluxunit - get the brightness flux unit
269 set_fluxunit - set the brightness flux unit
270 create_mask - return an mask in the current unit
271 for the given region. The specified regions
272 are NOT masked
273 get_restfreqs - get the current list of rest frequencies
274 set_restfreqs - set a list of rest frequencies
275 flag_spectrum - flag a whole Beam/IF/Pol
276 save - save the scantable to disk as either 'ASAP'
277 or 'SDFITS'
278 nbeam,nif,nchan,npol - the number of beams/IFs/Pols/Chans
279 [Math]
280 average_time - return the (weighted) time average of a scan
281 or a list of scans
282 average_pol - average the polarisations together.
283 The dimension won't be reduced and
284 all polarisations will contain the
285 averaged spectrum.
286 quotient - return the on/off quotient
287 simple_math - simple mathematical operations on two scantables,
288 'add', 'sub', 'mul', 'div'
289 scale - return a scan scaled by a given factor
290 add - return a scan with given value added
291 bin - return a scan with binned channels
292 resample - return a scan with resampled channels
293 smooth - return the spectrally smoothed scan
294 poly_baseline - fit a polynomial baseline to all Beams/IFs/Pols
295 gain_el - apply gain-elevation correction
296 opacity - apply opacity correction
297 convert_flux - convert to and from Jy and Kelvin brightness
298 units
299
300 fitter
301 auto_fit - return a scan where the function is
302 applied to all Beams/IFs/Pols.
303 commit - return a new scan where the fits have been
304 commited.
305 fit - execute the actual fitting process
306 get_chi2 - get the Chi^2
307 set_scan - set the scantable to be fit
308 set_function - set the fitting function
309 set_parameters - set the parameters for the function(s), and
310 set if they should be held fixed during fitting
311 get_parameters - get the fitted parameters
312 [Plotter]
313 asapplotter - a plotter for asap, default plotter is
314 called 'plotter'
315 plot - plot a (list of) scantable
316 set_mode - set the state of the plotter, i.e.
317 what is to be plotted 'colour stacked'
318 and what 'panelled'
319 set_range - set the abcissa 'zoom' range
320 set_legend - specify user labels for the legend indeces
321 set_title - specify user labels for the panel indeces
322 set_ordinate - specify a user label for the ordinate
323 set_abcissa - specify a user label for the abcissa
324
325 [Reading files]
326 reader - access rpfits/sdfits files
327 read - read in integrations
328 summary - list info about all integrations
329
330 [General]
331 commands - this command
332 print - print details about a variable
333 list_scans - list all scantables created bt the user
334 del - delete the given variable from memory
335 range - create a list of values, e.g.
336 range(3) = [0,1,2], range(2,5) = [2,3,4]
337 help - print help for one of the listed functions
338 execfile - execute an asap script, e.g. execfile('myscript')
339 list_rcparameters - print out a list of possible values to be
340 put into $HOME/.asaprc
341 Note:
342 How to use this with help:
343 # function 'summary'
344 [xxx] is just a category
345 Every 'sub-level' in this list should be replaces by a '.' Period when
346 using help
347 Example:
348 ASAP> help scantable # to get info on ths scantable
349 ASAP> help scantable.summary # to get help on the scantable's
350 ASAP> help average_time
351
352 """
353 print x
354 return
355
356print """Welcome to ASAP - the ATNF Single Dish Analysis Package
357This is a testing pre-release v0.2
358
359Please report any bugs to:
360Malte.Marquarding@csiro.au
361
362[NOTE: ASAP is 0-based]
363Type commands() to get a list of all available ASAP commands.
364"""
Note: See TracBrowser for help on using the repository browser.