...
geopoints
create_geo
( number )geopoints
geopoints create_geo
( number, string )
geopoints create_geo
( number, string, number )create_geo
( number, string, number, list )geopoints
create_geo
( ... )
Creates a new geopoints variable with the given number of points, all set to default values and coordinates. It is intended that this function be used in conjunction with the set_xxx geopoints functions in order to populate the geopoints with data. If saved, the geopoints file will be in the `traditional' 6-column format. If another format is desired, supply a string as the second parameter, possible values being 'polar_vector ', 'xy_vector ', 'xyv ' and 'ncols
'. If format 'ncols
' is specified, then the number of value columns can be given as the third argument (default is 1). In this case, an optional fourth argument can be used to provide a list of names of the value columns.
An alternative, and more efficient way to create a new geopoints variable if you already have the data to populate it, is to provide a set of named arguments as shown in the examples below. Using this syntax, you can completely create a new geopoints variable with all its column data in one go. This is much more efficient than creating an empty geopoints variable and then populating it using the set_
functions.
Examples are shown below:
Code Block | ||
---|---|---|
| ||
g = create_geo(8) # default geopoints format, 8 values
g = create_geo(9, 'xyv') # XYV formatted geopoints with 9 values
g = create_geo(4, 'ncols', 3, ['t', 'z', 'precip']) # NCOLS format with 3 named columns, each containing 4 values
g = create_geo(type:'standard',
latitudes: |4, 5, 6|,
longitudes: |2.3, 1.1, 6.5|,
levels: 850, # all rows will have 850 as their level
values: |1.1, 2.2, 3.3|,
times: nil,
stnids: ['aberdeen', 'aviemore', 'edinburgh'] )
g = create_geo(type:'xyv',
latitudes: |4, 5, 6|,
longitudes: |2.3, 1.1, 6.5|,
values: |1.1, 2.2, 3.3|) |
list
date
( geopoints )
Extracts the date information of all the geopoints and returns it as a list of dates.
...