User Tools

Site Tools


devel:brewerjsonpythonmodule

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
devel:brewerjsonpythonmodule [2015/09/21 10:31]
ajberjon
devel:brewerjsonpythonmodule [2022/10/20 08:00] (current)
Line 11: Line 11:
   import sys   import sys
   sys.path.append("/​home/​to/​module/"​)   sys.path.append("/​home/​to/​module/"​)
 +
 +By default the sys.path variable includes the current directory, so if brewerjson.py is in the same directory as the Python script, the module can be directly imported.
  
 Alternatively,​ you can download brewer.py file to the standard location for third-party Python modules. This location varies by platform and by how you built/​installed Python itself. Typical locations are shown in the following table: Alternatively,​ you can download brewer.py file to the standard location for third-party Python modules. This location varies by platform and by how you built/​installed Python itself. Typical locations are shown in the following table:
Line 23: Line 25:
  
 ^ Field ^ Description ^ ^ Field ^ Description ^
-^ [[devel:​brewerjsonpythonmodule#​getdata|getdata()]] | Retrieve ​raw data from RBCC-E ​database ​+^ [[devel:​brewerjsonpythonmodule#​getDataList|getDataList()]] | Retrieve ​a list of dictionaries with data from RBCC-E ​between two dates. ​
-^ [[devel:​brewerjsonpythonmodule#​getDataList|getDataList()]] | Retrieve a list of dictionaries ​with data from RBCC-E between two dates ^+^ [[devel:​brewerjsonpythonmodule#​writejson|writejson()]] | Write list of dictionaries ​(measures, config,..) to file. ^ 
 +^ [[devel:​brewerjsonpythonmodule#​readjson|readjson()]] | Read list of dictionaries (measures, config,​..) ​from file. ^
  
-=== getdata() === 
  
-This function ​retrieves brewer data using the interface described in the [[codes:accessfunctions|access functions Section]]. This function accepts only an argument ​//params// which is a dictionary. Mandatory elements in //params// are: //user//, //password//, //berwerid// and //​function//​. ​Other elements should be provided depending ​on the selected ​//​function//​. The //​function// ​element refers to the different functions described in the [[codes:accessfunctions|access functions Section]].+=== getDataList() === 
 + 
 +This function ​retrieve a list of [[http://​eubrewnet.aemet.es/​dokuwiki/​doku.php?​id=devel:​brewerpythonmodule#​data_structures|dictionaries]] with data of the registered brewers at the RBCC-E databaseArguments are //berwerid////user////password//, //function//, //date1// and //date2//. If //date2// is omitted the function ​returns only data of the day //data1//. 
 + 
 +The returned dictionaries structures depend ​on the //​function// ​argument value: 
 + 
 +//​function// ​^ Dictionaries ^ 
 +^ '​DS'​ | [[http://​eubrewnet.aemet.es/​dokuwiki/​doku.php?​id=devel:​brewerpythonmodule#​measure|measure]] 
 +^ '​SL'​ | [[http://​eubrewnet.aemet.es/​dokuwiki/​doku.php?​id=devel:​brewerpythonmodule#​measure|measure]] ^ 
 +^ '​ConfigbyDate'​ | [[http://​eubrewnet.aemet.es/​dokuwiki/​doku.php?​id=devel:​brewerpythonmodule#​config|config]] ^
  
 **Example** **Example**
Line 34: Line 45:
     import datetime     import datetime
     ​     ​
-    ​params['​user'​]='​user'​ +    ​d1=datetime.date(2014,​10,​01) 
-    ​params['​password'​]='​password'​ +    ​d2=datetime.date(2014,​10,​02
-    params['​function'​]='​getDS'​ +    data=brewerjson.getDataList(185,'​user,'​password','​DS',​d1,​d2)
-    params['​brewerid'​]=37 +
-    params['​date'​]=datetime.date(2014,​10,​01)' +
-    data=brewerjson.getdata(params)+
  
-In this example we retrieve data from the url: http://​rbcce.aemet.es/​eubrewnet/​getdata/​getDS?​brewerid=037&​date=2014-10-01 
  
-This function returns different data structures depending on //​function//​ parameter.+=== writejson() ===
  
 +This function save a list of [[http://​eubrewnet.aemet.es/​dokuwiki/​doku.php?​id=devel:​brewerpythonmodule#​data_structures|dictionaries]] to file. The values of '​gmt'​ and '​date'​ are transformed to strings.
  
-=== getDataList() ​===+**Example** 
 +    import brewerjson 
 +    import datetime 
 +     
 +    d1=datetime.date(2014,​10,​01) 
 +    d2=datetime.date(2014,​10,​02) 
 +    data=brewerjson.getDataList(185,'​user,'​password','​DS',​d1,​d2) 
 +    brewerjson.getdata(data,'​output.txt'​)
  
-This function ​retrieve a list of [[http://rbcce.aemet.es/​dokuwiki/​doku.php?​id=devel:​brewerpythonmodule#​data_structures|dictionaries]] with data of the registered brewers at the RBCC-E database. Arguments are //​berwerid//,​ //user//, //​password//,​ //​function//,​ //date1// and //date2//. If //date2// is omitted the function returns only data of the day //data1//.+This function ​accepts two input parameters: //'data'// and //'​file'​//.
  
-The returned dictionaries structures depend on the //function// argument value:+  * //'​data'​// is a list of [[http://​eubrewnet.aemet.es/​dokuwiki/​doku.php?​id=devel:​brewerpythonmodule#​data_structures|dictionaries]]. 
 +  * //'​file'//​ output file.
  
-^ //​function//​ ^ Dictionaries ^ + 
-^ '​getDS'​ | [[http://​rbcce.aemet.es/​dokuwiki/​doku.php?​id=devel:​brewerpythonmodule#​measure|measure]] ^ +=== readjson() === 
-^ '​getDSS'​ | [[http://​rbcce.aemet.es/​dokuwiki/​doku.php?​id=devel:​brewerpythonmodule#​measure|measure]] ^ + 
-^ '​getSL'​ | [[http://​rbcce.aemet.es/​dokuwiki/​doku.php?​id=devel:​brewerpythonmodule#​measure|measure]] ^ +This function read a file containing a list of [[http://eubrewnet.aemet.es/​dokuwiki/​doku.php?​id=devel:​brewerpythonmodule#​data_structures|dictionaries]].
-^ '​getSLS'​ | [[http://rbcce.aemet.es/​dokuwiki/​doku.php?​id=devel:​brewerpythonmodule#​measure|measure]] +
-^ '​getConfigsbyDate''​ | [[http://​rbcce.aemet.es/​dokuwiki/​doku.php?​id=devel:​brewerpythonmodule#​config|config]] ^+
  
 **Example** **Example**
Line 63: Line 77:
     import datetime     import datetime
     ​     ​
-    ​d1=datetime.date(2014,​10,​01) +    brewerjson.getdata('input.txt')
-    d2=datetime.date(2014,​10,​02) +
-    data=brewerjson.getDataList(37,'user,'​password','​getDS',d1,d2) +
  
  
  
devel/brewerjsonpythonmodule.1442831512.txt.gz · Last modified: 2015/09/21 10:31 by ajberjon