Changes between Version 4 and Version 5 of NERCPortals


Ignore:
Timestamp:
08/02/08 11:04:44 (11 years ago)
Author:
mkochan
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • NERCPortals

    v4 v5  
    1616 - {{{kml/csml2kml/outputs}}} contains all outputs from tests 
    1717 
     18Currently only CSML documents containing solely csml:GridSeriesFeature and csml:PointSeriesFeature elements are supported. 
     19 
    1820== KMLDocument == 
    1921 
     
    2325it can be saved into a file using the method {{{KMLDocument.save()}}} -- actual KML is generated only 
    2426during saving. 
     27 
     28== GridSeriesConvertor == 
     29 
     30Example test is contained in {{{kml/csml2kml/python/csml2kml/tests/testGridSeriesConvertor.py}}}.  
     31This test reads in the climate modelling file {{{clim_10.csml}}} with month/decade values for various 
     32csml:GridSeriesFeature's. The CSML file does not contain the grid data themselves -- these are read in from WMS. 
     33Since this information is not part of the CSML file, there must be a config file supplied as well, 
     34which contains the context for the conversion. Its format is as follows: 
     35{{{ 
     36<CSML2KMLConfig> 
     37  <CSMLGridSeriesFeatureWMSRequest> 
     38    <URL>http://www-devel.ipcc-data.org/maps/wms/obs</URL> 
     39    <ServiceVersion>1.1.1</ServiceVersion> 
     40    <ImageFormat>image/png</ImageFormat> 
     41    <ImageWidth>960</ImageWidth> 
     42    <ImageHeight>480</ImageHeight> 
     43    <CRS>EPSG:4326</CRS> 
     44    <LayerName>#FILENAME_EXCL_SUFFIX#/#FEATURE_NAME#</LayerName> 
     45    <LongitudeBounds>UNCONSTRAINED</LongitudeBounds> 
     46    <LatitudeBounds>UNCONSTRAINED</LatitudeBounds> 
     47  </CSMLGridSeriesFeatureWMSRequest> 
     48  <View name="Whole century"> 
     49    <SplitTimeStepsBy></SplitTimeStepsBy> 
     50    <LogicalDateTimeTransform>20_CENTURY_DECADE</LogicalDateTimeTransform> 
     51    <LogicalDateTimeDelta>MONTH_HENCE</LogicalDateTimeDelta> 
     52  </View> 
     53  <View name="Compare decades"> 
     54    <SplitTimeStepsBy>year</SplitTimeStepsBy> 
     55    <CategoryNamingPattern>Decade of #VERBATIM#</CategoryNamingPattern> 
     56    <LogicalDateTimeTransform>FIRST_DAY_OF_MONTH</LogicalDateTimeTransform> 
     57    <LogicalDateTimeDelta>MONTH_HENCE</LogicalDateTimeDelta> 
     58  </View> 
     59  <View name="Compare months"> 
     60    <SplitTimeStepsBy>month</SplitTimeStepsBy> 
     61    <CategoryNamingPattern>#MONTH#</CategoryNamingPattern> 
     62    <LogicalDateTimeTransform>FIRST_DAY_OF_MONTH</LogicalDateTimeTransform> 
     63    <LogicalDateTimeDelta>DECADE_HENCE</LogicalDateTimeDelta> 
     64  </View> 
     65</CSML2KMLConfig> 
     66}}} 
     67The {{{CSMLGridSeriesFeatureWMSRequest}}} element contains information about the WMS to be used 
     68from retrieval. Each {{{View}}} element describes a different way of viewing the data, 
     69i.e. how they should be organized in Google Earth's left panel. This also determines how they can be animated. 
     70 
     71The code for csml:GridSeriesFeature's conversion is organised in the following modules: 
     72 - {{{GridSeriesConvertor.py}}} -- contains class {{{GridSeriesConvertor}}} which performs the conversion 
     73 - {{{csmlwrappers.py}}} -- contains wrapper classes which wrap around various CSML features. 
     74   Currently there is only class {{{GridSeriesFeatureWrapper}}}. 
     75 - {{{kmlfeatures.py}}} -- encapsulation of CSML features as KML elements. Does not use {{{KMLDocument}}} 
     76   and is only used by {{{GridSeriesConvertor}}}.