/[thuban]/branches/WIP-pyshapelib-bramz/Thuban/Model/table.py
ViewVC logotype

Diff of /branches/WIP-pyshapelib-bramz/Thuban/Model/table.py

Parent Directory Parent Directory | Revision Log Revision Log | View Patch Patch

revision 590 by bh, Wed Apr 2 15:03:19 2003 UTC revision 1078 by bh, Wed May 28 09:07:30 2003 UTC
# Line 1  Line 1 
1  # Copyright (c) 2001, 2002, 2003 by Intevation GmbH  # Copyright (c) 2001, 2002, 2003 by Intevation GmbH
2  # Authors:  # Authors:
3  # Bernhard Herzog <[email protected]>  # Bernhard Herzog <[email protected]>
4    # Jan-Oliver Wagner <[email protected]>
5    # Frank Koormann <[email protected]>
6  #  #
7  # This program is free software under the GPL (>=v2)  # This program is free software under the GPL (>=v2)
8  # Read the file COPYING coming with Thuban for details.  # Read the file COPYING coming with Thuban for details.
# Line 11  Classes for handling tables of data. Line 13  Classes for handling tables of data.
13    
14  __version__ = "$Revision$"  __version__ = "$Revision$"
15    
16    import os
17    import inspect
18    import warnings
19    
20    from base import TitledObject
21    
22  import dbflib  import dbflib
23    
24  # the field types supported by a Table instance.  # the field types supported by a Table instance.
# Line 24  dbflib_fieldtypes = {dbflib.FTString: FI Line 32  dbflib_fieldtypes = {dbflib.FTString: FI
32                       dbflib.FTInteger: FIELDTYPE_INT,                       dbflib.FTInteger: FIELDTYPE_INT,
33                       dbflib.FTDouble: FIELDTYPE_DOUBLE}                       dbflib.FTDouble: FIELDTYPE_DOUBLE}
34    
 class Table:  
35    
36    class OldTableInterfaceMixin:
37    
38        """Mixin to implement the old table interface using the new one"""
39    
40        def __deprecation_warning(self):
41            """Issue a DeprecationWarning for code hat uses the old interface"""
42            callername = inspect.currentframe().f_back.f_code.co_name
43            warnings.warn("The %s method of the old table interface"
44                          " is deprecated" % callername,
45                          DeprecationWarning, stacklevel = 3)
46    
47        def record_count(self):
48            self.__deprecation_warning()
49            return self.NumRows()
50    
51        def field_count(self):
52            self.__deprecation_warning()
53            return self.NumColumns()
54    
55        def field_info(self, field):
56            """Return a tuple (type, name, width, prec) for the field no. field
57    
58            type is the data type of the field, name the name, width the
59            field width in characters and prec the decimal precision. width
60            and prec will be zero if the information returned by the Column
61            method doesn't provide values for them.
62            """
63            self.__deprecation_warning()
64            col = self.Column(field)
65            return (col.type, col.name,
66                   getattr(col, "width", 0), getattr(col, "prec", 0))
67    
68        def field_info_by_name(self, col):
69            self.__deprecation_warning()
70            try:
71                return self.field_info(col)
72            except KeyError:
73                # FIXME: It may be that field_info raises other exceptions
74                # when the name is not a valid column name.
75                return None
76    
77        def field_range(self, fieldName):
78            self.__deprecation_warning()
79            min, max = self.ValueRange(fieldName)
80            return ((min, None), (max, None))
81    
82        def GetUniqueValues(self, field):
83            self.__deprecation_warning()
84            return self.UniqueValues(field)
85    
86        def read_record(self, r):
87            self.__deprecation_warning()
88            return self.ReadRowAsDict(r)
89    
90    
91    
92    class DBFColumn:
93    
94        """Description of a column in a DBFTable
95    
96        Instances have the following public attributes:
97    
98        name -- Name of the column
99        type -- Type of the column (one of FIELDTYPE_STRING, FIELDTYPE_INT or\
100                FIELDTYPE_DOUBLE)
101        index -- The index of the column
102        width -- the width of the data in the column
103        prec -- The precision of the data (only valid for type == FIELDTYPE_DOUBLE)
104      """      """
     Represent a table of data.  
105    
106      Currently this is basically just a wrapper around dbflib.      def __init__(self, name, type, width, prec, index):
107            self.name = name
108            self.type = type
109            self.width = width
110            self.prec = prec
111            self.index = index
112    
113    
114    class DBFTable(TitledObject, OldTableInterfaceMixin):
115    
116        """
117        Table interface for the data in a DBF file
118      """      """
119    
120      # Implementation strategy regarding writing to a DBF file:      # Implementation strategy regarding writing to a DBF file:
# Line 48  class Table: Line 133  class Table:
133    
134      def __init__(self, filename):      def __init__(self, filename):
135          self.filename = filename          self.filename = filename
136    
137            # Omit the extension in the title as it's not really needed and
138            # it can be confusing because dbflib removes extensions and
139            # appends some variations of '.dbf' before it tries to open the
140            # file. So the title could be e.g. myshapefile.shp when the real
141            # filename is myshapefile.dbf
142            title = os.path.splitext(os.path.basename(self.filename))[0]
143            TitledObject.__init__(self, title)
144    
145          self.dbf = dbflib.DBFFile(filename)          self.dbf = dbflib.DBFFile(filename)
146    
147          # If true, self.dbf is open for writing.          # If true, self.dbf is open for writing.
148          self._writable = 0          self._writable = 0
149    
150      def Destroy(self):          # Create the column information objects
151          self.dbf.close()          self.columns = []
152          self.dbf = None          self.column_map = {}
153            for i in range(self.NumColumns()):
154                ftype, name, width, prec = self.dbf.field_info(i)
155                ftype = dbflib_fieldtypes[ftype]
156                index = len(self.columns)
157                col = DBFColumn(name, ftype, width, prec, index)
158                self.columns.append(col)
159                self.column_map[name] = col
160                self.column_map[index] = col
161    
162      def record_count(self):      def NumRows(self):
163          """Return the number of records"""          """Return the number of rows in the table"""
164          return self.dbf.record_count()          return self.dbf.record_count()
165    
166      def field_count(self):      def NumColumns(self):
167          """Return the number of fields in a record"""          """Return the number of columns in the table"""
168          return self.dbf.field_count()          return self.dbf.field_count()
169    
170      def field_info(self, field):      def Columns(self):
171          """Return a tuple (type, name, width, prec) for the field no. field          """Return the table's colum definitions
172    
173          type is the data type of the field, name the name, width the          The return value is a sequence of DBFColumn instances, one for
174          field width in characters and prec the decimal precision.          each column.
175          """          """
176          type, name, width, prec = self.dbf.field_info(field)          return self.columns
         type = dbflib_fieldtypes[type]  
         return type, name, width, prec  
177    
178      def field_info_by_name(self, fieldName):      def Column(self, col):
179          count = self.field_count()          """Return information about the column given by its name or index
180    
181          for i in range(count):          The returned object is an instance of DBFColumn
182              info = self.field_info(i)          """
183              if info[1] == fieldName:          return self.column_map[col]
184                  return info  
185        def HasColumn(self, col):
186            """Return whether the table has a column with the given name or index
187            """
188            return self.column_map.has_key(col)
189    
190        def ReadRowAsDict(self, row):
191            """Return the entire row as a dictionary with column names as keys"""
192            return self.dbf.read_record(row)
193    
194        def ReadValue(self, row, col):
195            """Return the value of the specified row and column
196    
197          return None          The col parameter may be the index of the column or its name.
198            """
199            return self.dbf.read_record(row)[self.column_map[col].name]
200    
201        def ValueRange(self, col):
202            """Return the minimum and maximum values of the values in the column
203    
204      def read_record(self, record):          The return value is a tuple (min, max) unless the table is empty
205          """Return the record no. record as a dict mapping field names to values          in which case the return value is None.
206          """          """
207          return self.dbf.read_record(record)          count = self.NumRows()
208    
209            if count == 0:
210                return None
211    
212            min = max = self.ReadValue(0, col)
213            for i in range(1, count):
214                value = self.ReadValue(i, col)
215                if value < min:
216                    min = value
217                elif value > max:
218                    max = value
219    
220            return (min, max)
221    
222        def UniqueValues(self, col):
223            """Return a sorted list of all unique values in the column col"""
224            dict = {}
225    
226            for i in range(self.NumRows()):
227                value = self.ReadValue(i, col)
228                dict[value] = 0
229    
230            values = dict.keys()
231            values.sort()
232            return values
233    
234        def Dependencies(self):
235            """Return an empty sequence. The DBFTable doesn't depend on anything"""
236            return ()
237    
238        # DBF specific interface parts.
239    
240        def Width(self, col):
241            """Return column width"""
242            return self.column_map[col].width
243    
244        def Destroy(self):
245            self.dbf.close()
246            self.dbf = None
247    
248      def write_record(self, record, values):      def write_record(self, record, values):
249          """Write the values into the record          """Write the values into the record
# Line 111  class Table: Line 266  class Table:
266          self.dbf.write_record(record, values)          self.dbf.write_record(record, values)
267          self.dbf.commit()          self.dbf.commit()
268    
269        def FileName(self):
270            """Return the filename the DBFTable was instantiated with"""
271            return self.filename
272    
273    
274    class MemoryColumn:
275    
276        def __init__(self, name, type, index):
277            self.name = name
278            self.type = type
279            self.index = index
280    
281    class MemoryTable(TitledObject, OldTableInterfaceMixin):
282    
283        """Very simple table implementation that operates on a list of tuples"""
284    
285        def __init__(self, fields, data):
286            """Initialize the MemoryTable
287    
288            Parameters:
289            fields -- List of (name, field_type) pairs
290            data -- List of tuples, one for each row of data
291            """
292            self.data = data
293            title = 'MemoryTable'
294            TitledObject.__init__(self, title)
295    
296            # Create the column information objects
297            self.columns = []
298            self.column_map = {}
299            for name, ftype in fields:
300                index = len(self.columns)
301                col = MemoryColumn(name, ftype, index)
302                self.columns.append(col)
303                self.column_map[name] = col
304                self.column_map[index] = col
305    
306        def NumColumns(self):
307            """Return the number of columns in the table"""
308            return len(self.columns)
309    
310        def Column(self, col):
311            """Return information about the column given by its name or index
312    
313            The returned object is an instance of MemoryColumn.
314            """
315            return self.column_map[col]
316    
317        def Columns(self):
318            """Return the table's colum definitions
319    
320            The return value is a sequence of MemoryColumn instances, one
321            for each column.
322            """
323            return self.columns
324    
325        def HasColumn(self, col):
326            """Return whether the table has a column with the given name or index
327            """
328            return self.column_map.has_key(col)
329    
330        def NumRows(self):
331            """Return the number of rows in the table"""
332            return len(self.data)
333    
334        def ReadValue(self, row, col):
335            """Return the value of the specified row and column
336    
337            The col parameter may be the index of the column or its name.
338            """
339            return self.data[row][self.column_map[col].index]
340    
341        def ReadRowAsDict(self, index):
342            """Return the entire row as a dictionary with column names as keys"""
343            return dict([(col.name, self.data[index][col.index])
344                          for col in self.columns])
345    
346        def ValueRange(self, col):
347            """Return the minimum and maximum values of the values in the column
348    
349            The return value is a tuple (min, max) unless the table is empty
350            in which case the return value is None.
351            """
352    
353            index = self.column_map[col].index
354            values = [row[index] for row in self.data]
355            if not values:
356                return None
357    
358            return min(values), max(values)
359    
360        def UniqueValues(self, col):
361            """Return a sorted list of all unique values in the column col
362    
363            col can be either column index or name.
364            """
365            dict = {}
366    
367            for i in range(self.NumRows()):
368                value = self.ReadValue(i, col)
369                dict[value] = 0
370    
371            values = dict.keys()
372            values.sort()
373            return values
374    
375        def Width(self, col):
376            """Return the maximum width of values in the column
377    
378            The return value is the the maximum length of string
379            representation of the values in the column (represented by index
380            or name).
381            """
382            max = 0
383    
384            type  = self.column_map[col].type
385            index = self.column_map[col].index
386            values = [row[index] for row in self.data]
387            if not values:
388                return None
389    
390            if type == FIELDTYPE_DOUBLE:
391                format = "%.12f"
392            elif type == FIELDTYPE_INT:
393                format = "%d"
394            else:
395                format = "%s"
396            for value in values:
397                l = len(format % value)
398                if l > max:
399                    max = l
400    
401            return max
402    
403        def Dependencies(self):
404            """Return an empty sequence. The MemoryTable doesn't depend on anything
405            """
406            return ()
407    
408        def write_record(self, record, values):
409            # TODO: Check for correct lenght and perhaps also
410            # for correct types in case values is a tuple. How to report problems?
411            # TODO: Allow values to be a dictionary and write the single
412            # fields that are specified.
413            self.data[record] = values
414    
415    
416    def table_to_dbf(table, filename):
417        """Create the dbf file filename from the table"""
418        dbf = dbflib.create(filename)
419    
420        dbflib_fieldtypes = {FIELDTYPE_STRING: dbflib.FTString,
421                             FIELDTYPE_INT: dbflib.FTInteger,
422                             FIELDTYPE_DOUBLE: dbflib.FTDouble}
423    
424        # Initialise the header. Distinguish between DBFTable and others.
425        for col in table.Columns():
426            width = table.Width(col.name)
427            if col.type == FIELDTYPE_DOUBLE:
428                prec = getattr(col, "prec", 12)
429            else:
430                prec = 0
431            dbf.add_field(col.name, dbflib_fieldtypes[col.type], width, prec)
432    
433        for i in range(table.NumRows()):
434            record = table.ReadRowAsDict(i)
435            dbf.write_record(i, record)
436        dbf.close()
437    
438    def table_to_csv(table, filename):
439        """Export table to csv file."""
440    
441        file = open(filename,"w")
442        columns = table.Columns()
443        if columns:
444            header = "#%s" % columns[0].name
445            for col in columns[1:]:
446                header = header + ",%s" % col.name
447            header = header + "\n"
448            file.write(header)
449    
450            for i in range(table.NumRows()):
451                record = table.ReadRowAsDict(i)
452                if len(record):
453                    line = "%s" % record[columns[0].name]
454                    for col in columns[1:]:
455                        line = line + ",%s" % record[col.name]
456                line = line + "\n"
457                file.write(line)
458        file.close()
459    
Legend:
Removed from v.590  
changed lines
  Added in v.1078
[email protected]
 ViewVC Help
Powered by ViewVC 1.1.26