Changes between Version 44 and Version 45 of NERCPortals


Ignore:
Timestamp:
03/04/08 14:08:14 (11 years ago)
Author:
domlowe
Comment:

minor restructure and formatting

Legend:

Unmodified
Added
Removed
Modified
  • NERCPortals

    v44 v45  
    66 - CedaDevEnvironment being created on {{{bond}}}. 
    77 
    8 = Conversion from CSML to KML = 
    9  
    10 == User manual == 
     8= Conversion from CSML to KML: User manual = 
    119 
    1210Since CSML currently lacks the constructs for describing the context for the CSML features, the actual mechanisms used to convert data from CSML to KML do use limited amount of CSML as a data source. The rest comes from different languages derived from GML. Hence this project became rather a demonstration of how OGC web services can be integrated into a common framework, which has a potential of working using purely CSML data, once CSML matures enough to contain all information in it. 
     
    1614 - {{{csml2kmlpylon}}} (a Pylon application) - is a web server (to be run by the BADC) serving a {{{csmlGrapher}}} web service that renders dynamic HTTP content on top of static data in KML files being viewed in Google Earth. 
    1715 
    18 === Temporary storage and archival of KML results === 
     16== Installation on a target machine == 
     17 
     18Both {{{csml2kml}}} and {{{csml2kmlpylon}}} require {{{matplotlib}}}, {{{cElementTree}}} and {{{csml}}}. 
     19 
     20=== Installation of {{{csml2kml}}} === 
     21 
     22The procedure is: 
     23 1. Use the standard {{{easy_install}}} command to install latest version of the egg on the target machine.  
     24{{{  
     25easy_install -f http://ndg.nerc.ac.uk/dist csml2kml  
     26}}} 
     27 
     28This will install the egg and also install two scripts (called ''wms2kml'' and ''stations2kml''). 
     29 
     30==== Temporary storage and archival of KML results ==== 
    1931 
    2032For daily use as a directory for KML output, it is recommended to use the following directory with {{{svn:ignore='*'}}} set on it: 
     
    3850}}} 
    3951 
    40 === Installation on a target machine === 
    41  
    42 Both {{{csml2kml}}} and {{{csml2kmlpylon}}} require {{{matplotlib}}}, {{{cElementTree}}} and {{{csml}}}. 
    43  
    44 ==== Installation of {{{csml2kml}}} ==== 
    45  
    46 The procedure is: 
    47  1. Use the standard {{{easy_install}}} command to install latest version of the egg on the target machine.  
    48 {{{  
    49 easy_install -f http://ndg.nerc.ac.uk/dist csml2kml  
    50 }}} 
    51  
    52 This will install the egg and also install two scripts (called ''wms2kml'' and ''stations2kml''). 
    53  
    54 ==== Installation of {{{csml2kmlpylon}}} ==== 
     52=== Installation of {{{csml2kmlpylon}}} === 
    5553 
    5654  1. Check out the Pylon application from the repository, at Subversion URL: 
     
    6967}}} 
    7068 
    71 === Usage of the {{{csml2kml}}} scripts === 
    72  
    73 ==== The {{{wms2kml.py}}} script ==== 
     69== Usage of the {{{csml2kml}}} scripts == 
     70 
     71=== The {{{wms2kml.py}}} script === 
    7472 
    7573Run this script as: 
     
    9896The field {{{URL}}} is a base URL of the WMS web service serving the intended dataset. 
    9997 
    100 ==== The {{{stations2kml.py}}} script ==== 
     98=== The {{{stations2kml.py}}} script === 
    10199 
    102100Run this script as: 
     
    132130  - {{{StationData}}} - contains station-specific data that are substituted in the balloon template.  The {{{#ID#}}} and {{{#NAME#}}} fields get replaced by the script with station identifier (such as "{{{midas.station.2500}}}") and name (such as "{{{FAIR ISLE}}}"), respectively. Note that a station's latitude and longitute need not be shown in the balloon, as they can be found by right-clicking on the station placemark. 
    133131  - {{{DisplayIntervalStart}}} and {{{DisplayIntervalEnd}}} specify the time internal, which is used in marking some stations red: the stations that contain ''at least one'' CSML feature which has been measured ''during this time interval'', will be painted red; the rest will be white. 
    134 === Usage of the {{{csml2kmlpylon}}} web service === 
     132== Usage of the {{{csml2kmlpylon}}} web service == 
    135133 
    136134Assuming that the pylon is served at URL ''{{{http://server:port}}}'', the web service can be used in two ways: 
     
    189187   - {{{IsCSMLLinkVisible}}} (use values {{{yes}}} or {{{no}}}) specifies whether to show the feature query URLs as links in the station feature listing.  
    190188 
    191 == Source code notes == 
     189= Source code notes = 
    192190 
    193191This section describes how source code is organised. 
    194192 
    195 === Source code notes for {{{csml2kml}}}  === 
     193== Source code notes for {{{csml2kml}}}  == 
    196194 
    197195The egg's {{{csml2kml}}} directory contains all Python modules, and the following 3 sub-directories: 
     
    205203There is a naming convention that wrappers of entities which normally exist as XML elements are prefixed with XML spacename. For instance, a class WMSLayer is a wrapper for an element ''<wms:Layer>''. Wrappers for KML elements (in {{{kml}}} namespace), which are used for output, contain a {{{build()}}} method, which builds each instance into an {{{ElementTree.Element}}} object. On the contrary, wrappers for elements in {{{wms}}} and {{{np}}} namespaces contain {{{parseXML()}}} method, as they are used for input. 
    206204 
    207 === Source code notes for {{{csml2kmlpylon}}}  === 
     205== Source code notes for {{{csml2kmlpylon}}}  == 
    208206 
    209207The !EpyDoc for the whole Pylon is available at