source: TI02-CSML/trunk/csml/API/genSubset.py @ 2361

Subversion URL: http://proj.badc.rl.ac.uk/svn/ndg/TI02-CSML/trunk/csml/API/genSubset.py@2361
Revision 2361, 10.2 KB checked in by domlowe, 13 years ago (diff)

more on calendars etc

Line 
1'''#getSubset.py contains generic subsetting code that can be reused for multiple features
2Dominic Lowe, CCLRC, 31/01/2007'''
3
4import csml
5import csmlutils
6import sys
7import Numeric
8
9def checkNeighbours(domain, gridnames, **kwargs):
10    #for any non-range requests, get nearest neighbour
11    #e.g if 'latitude': (11) requested, latitude=12 may be the nearest value
12     
13    for key in kwargs:
14    #need to skip time axis
15        #handle single values
16        if type(kwargs[key]) is not tuple:
17            if type(domain[key]) is not list:
18                axeslist=domain[key].tolist()
19            else:
20                axeslist = domain[key]
21            nearestNeighbour=csml.API.csmlutils.nudgeSingleValuesToAxisValues(kwargs[key],axeslist)
22            if nearestNeighbour is not None:
23                kwargs[key]=nearestNeighbour   
24        else:
25            #handle ranges
26            tmpkey=[]
27            for val in kwargs[key]:
28                nearestNeighbour=csml.API.csmlutils.nudgeSingleValuesToAxisValues(val, domain[key])
29                if nearestNeighbour is not None:
30                    tmpkey.append(nearestNeighbour)   
31                kwargs[key]=tuple(tmpkey)
32    return kwargs
33
34def subsetDomain(timeaxis,times, domain,**kwargs):
35    '''takes the domain and returns a subset according to the keyword selection criteria
36    time = name of time dimension
37    times = string of times
38    '''   
39    strTimes=times
40    subsetDomain={}
41    totalArraySize=1
42    for key in domain.keys():
43        straxisValues=''
44        if key in kwargs:
45            if key ==timeaxis:
46                straxisValues=strTimes
47                arraySize=len(strTimes.split())
48            elif type(kwargs[key]) is not tuple:
49                #only one value not a range
50                straxisValues=str(kwargs[key]) 
51            elif kwargs[key][0] < kwargs[key][1]:   
52                for val in domain[key]:
53                      if val is not '':
54                            if float(val) >= kwargs[key][0]:
55                                if float(val) <= kwargs[key] [1]:
56                                    straxisValues=straxisValues+ str(val) + ','
57                straxisValues=straxisValues[:-1]
58            else:#this if deals with selections such as longitude (330,30) where the lower limit is 'greater' than the upper limit in a mathematical sense.
59                    for val in domain[key]:
60                        if val is not '':
61                            if val >= kwargs[key][0]:
62                                straxisValues=straxisValues+ str(val) + ','
63                    for val in domain[key]:
64                        if val is not '':
65                            if val <= kwargs[key] [1]:
66                                straxisValues=straxisValues+ str(val) + ','
67                    straxisValues=straxisValues[:-1]                                             
68        else: # this dimension has not been subsetted at all - CHECK  THIS
69            for val in domain[key]:
70                if val is not '':
71                    straxisValues=straxisValues+ str(val) + ','       
72            straxisValues=straxisValues[:-1]                       
73                                           
74        subsetDomain[key]=straxisValues
75        if key != timeaxis:
76            arraySize=len(subsetDomain[key].split(','))
77        else:
78            arraySize=len(subsetDomain[key].split())
79        totalArraySize = totalArraySize * arraySize
80    return subsetDomain, totalArraySize
81   
82def _setCalendar(feature, timeName, ords):
83    '''sets the cdtime calendar needed for conversion from CSML to NetCDF'''
84    calset=False
85    for gridOrd in ords:
86        if gridOrd.coordAxisLabel.CONTENT==timeName:     
87            try:
88                caltype=gridOrd.coordAxisValues.timePositionList.frame.split(':',2)[1]
89                calunits=gridOrd.coordAxisValues.timePositionList.frame.split(':',2)[2]
90                csml.csmllibs.csmltime.setcdtimeCalendar(caltype)
91                calset=True
92            except:pass
93    if calset!=True:
94        csml.csmllibs.csmltime.setcdtimeCalendar(csml.csmllibs.csmltime.cdtime.DefaultCalendar)       
95    try:
96        caltype=gridOrd.coordAxisValues.timePositionList.frame.split(':',2)[1]
97        calunits=gridOrd.coordAxisValues.timePositionList.frame.split(':',2)[2]
98        csml.csmllibs.csmltime.setcdtimeCalendar(caltype)
99    except:
100        csml.csmllibs.csmltime.setcdtimeCalendar(csml.csmllibs.csmltime.cdtime.DefaultCalendar)       
101    return calunits, caltype
102
103
104def _getTimes(timeSelection, timeName, domain):
105    #currently supporting domain subsetting only by CRS name
106    #(but should be easy to extend later)
107    if type(timeSelection) is str:
108        times=(timeSelection,)
109    else:
110        times=timeSelection
111   
112    if len(times)==0:
113        #no time specified, select all.
114        times= domain[timeName]
115    tone=csml.csmllibs.csmltime.getCDtime(times[0])
116    if len(times) == 2:
117        #then this is a range of times (t1, tn), and not a list
118        try:
119            tone=csml.csmllibs.csmltime.getCDtime(times[0])
120        except:
121            tone=times[0]
122        try:
123            ttwo=csml.csmllibs.csmltime.getCDtime(times[1])
124        except:
125            ttwo=times[1]
126        times=[]         
127        for time in domain[timeName]:
128            timeok=csml.csmllibs.csmltime.compareTimes(tone,time,ttwo)
129            if timeok ==1:
130                times.append(time)
131    return times
132
133def _getTimeToFileRatio(feature,domain, timeName):
134    if hasattr(feature.value.rangeSet, 'valueArray'):
135        if hasattr(feature.value.rangeSet.valueArray.valueComponent.quantityList, '__insertedExtract'):
136            numFiles= len( csmlutils.listify(feature.value.rangeSet.valueArray.valueComponent.quantityList.__insertedExtract.components)[0].fileList.fileNames.CONTENT.split())
137            return len(domain[timeName])/numFiles
138
139def getCoordTransformTable(domainSubset, crs, frame):
140    cTT=csml.parser.GridCoordinatesTable()
141    ords =[]
142    for key in domainSubset.keys():
143        go=csml.parser.GridOrdinateDescription()
144        go.coordAxisLabel=csml.parser.csString(key)
145        go.gridAxesSpanned=csml.parser.csString(key)
146        go.coordAxisValues = csml.parser.SpatialOrTemporalPositionList()
147        if key==crs.axes[crs.timeAxis]:
148            go.coordAxisValues.timePositionList=csml.parser.csString(domainSubset[key])
149            go.coordAxisValues.frame = frame
150            #self.domain.key placeholder
151        else:
152            go.coordAxisValues.coordinateList=csml.parser.csString(domainSubset[key]) #self.domain.key placeholder
153        ords.append(go) #go needs a few more properties setting
154    cTT.gridOrdinates=ords
155    return cTT
156
157
158
159def getTheData(feature, selection, times,timeName):
160   
161    #SOME OF THIS SHOULD PROBABLY BE IN THE DATA IO LAYER
162    domain = feature.domain
163    value=feature.value
164    files=[]
165    strTimes=''
166    fulldata=None
167    #get the ratio of times to files
168    timeToFileRatio = _getTimeToFileRatio(feature, domain, timeName)
169           
170    #list to keep track of files that have already been fetched. eg. if multiple times are in a single file only need to get data from that file once...
171    filesFetched=[]
172     
173    if hasattr(value.rangeSet, 'arrayDescriptor'):
174        #then just dealing with one file.
175        componentlist = csmlutils.listify(value.rangeSet.arrayDescriptor)
176    else:
177        #dealing with aggregated array
178         componentlist = csmlutils.listify(value.rangeSet.valueArray.valueComponent.quantityList.__insertedExtract.components)
179       
180    for time in times:
181        listPosition=domain[timeName].index(time)
182        strTimes= strTimes + ' ' + time                   
183        for comp in componentlist:
184            if timeToFileRatio == None:
185                filePos=None
186            else:
187                filePos=int(float(listPosition)/timeToFileRatio)
188            if filePos in filesFetched:
189                continue #already got data from this file, try next time         
190            data, fillvalue, axisorder, units=comp.getData(fileposition=filePos, **selection)         
191            if filePos is None:
192                files.append(comp.fileName.CONTENT)
193            else:
194                files.append(comp.fileList.fileNames.CONTENT[filePos]) #TODO, get the right file name
195           
196            if fulldata is None:
197                fulldata=data
198            else:
199                newfulldata=Numeric.concatenate([fulldata,data], axis=0)   
200                fulldata=newfulldata
201            filesFetched.append(filePos)
202    if hasattr(value.rangeSet, 'valueArrayl'):
203        units.append(value.rangeSet.valueArray.valueComponent.quantityList.uom) # final unit is that of the parameter
204    else:
205        units.append ('unitsTBA')
206    return strTimes, axisorder, units, fulldata, fillvalue
207
208def genericSubset(feature, csmlpath, ncpath, domain, kwargs):
209    if ncpath is not None:
210        pathToSubsetNetCDF=ncpath
211    else:
212        pathToSubsetNetCDF='temp.nc'
213   
214    #deal with longitude requests
215    #if the request is in -ve,+ve eg (-30,30) but the data is in (0,360) need to handle this by changing the args.
216    kwargs=csmlutils.fixLongitude(domain,kwargs)
217       
218    #get the name of the time axis in the coordinate reference system
219    cat=csml.csmllibs.csmlcrs.CRSCatalogue()
220    if type(feature) == csml.parser.GridSeriesFeature:
221        crs=cat.getCRS(feature.value.gridSeriesDomain.srsName,feature.value.gridSeriesDomain.axisLabels)
222        gridordinates = feature.value.gridSeriesDomain.coordTransformTable.gridOrdinates
223    elif type(feature) == csml.parser.ProfileSeriesFeature:
224        crs=cat.getCRS(feature.value.profileSeriesDomain.srsName)
225        gridordinates = feature.value.profileSeriesDomain.coordTransformTable.gridOrdinates
226    timeName=crs.axes[crs.timeAxis]
227    #Find the original time name (timeAxis) for the file.
228    for gridOrd in gridordinates:
229        if gridOrd.coordAxisLabel.CONTENT==timeName:
230            timeAxis = gridOrd.gridAxesSpanned.CONTENT  #only works for regular grids atm
231            break
232    #set the reference system for the time axis
233    calunits, caltype=_setCalendar(feature, timeName, gridordinates)
234   
235    try:
236        timeSelection=kwargs[timeName]
237    except KeyError:
238        timeSelection=[]
239   
240    times=_getTimes(timeSelection, timeName,domain)   
241    return pathToSubsetNetCDF, kwargs, timeAxis,timeName, calunits, caltype, times
Note: See TracBrowser for help on using the repository browser.