= MINERVE-D3 = Le projet TRAC `MINERVE-D3` correspond aux développements informatiques réalisés dans le cadre de la thèse MINERVE d'[https://people.epfl.ch/alain.foehn?lang=fr Alain Foehn]. Un certain nombre d'outils, présentés ci-dessous, ont été développés. [[BR]] Les outils interagissent aux travers des '''api-node''' et '''api-research''' directement avec les bases de données spatiales '''MAYA''' et '''DANA''' ainsi que la base de données mysql '''MINERVE'''. Les fonctions permettant cette interaction on été regroupées dans le dossier suivant: {{{ MINERVE-D3\Code }}} Le fichier '''fc_API-REST.R''' contient les fonctions suivantes : ||='''Function name'''=||='''Description'''=||='''Type of output'''=|| || download_data_in_slots || Download data (value of a pixel or aggregated raster) over a period, using function ''download_slot'' for each slot. || time series OR raster || || download_slot || Download data (value of a pixel or aggregated raster) for a given slot of the entire period. || time series OR raster || || download_timeseries_from_raster || Function used by ''download_slot'' for managing the download of time series from raster using function ''download_request''. || time series || || download_request || Function used to download the request text prepared by ''download_timeseries_from_raster''. || time series || || manage_download_raster || Function used by ''download_slot'' for managing the download of raster data using the ''download_raster'' function. || raster || || download_raster || Function used by acquire_MAYA_data for downloading a raster (aggregation function defined in the API-INI file). || raster || || download_altitude_of_pixel || Function to download the elevation value of a pixel from the metadata DEM of a given product. || value || Le fichier '''fc_common.R''' contient les fonction suivantes : ||='''Function name'''=||='''Description'''=|| || get_token || Manage acquisition of the token : first uses ''get_token_local'', if it fails, uses ''get_token_server'' and the saves the token with ''write_token''. || || get_token_local || Reads the token from the local file. || || get_token_server || Acquires a new token from the API-REST. || || write_token || Saves in the local file the newly acquire token. || || || || || define_computetime || Date formating function || || print_elapsed_time || Function to print the time of a code part, with an argument for the text to be printed. || || pause_and_print || Function to makes a break and print that it has done a break (used in the download functions, to handle cases where API-REST does temporary not answer, for example due to a manuel restart). || || || || || write.RSMcsv || Function to export data in a CSV format readable by RS MINERVE (currently not used in the tools listed below). || == Combi-Valais == Outil de spatialisation des pluies. {{{ MINERVE-D3\Combi-Valais }}} == Spatial_Temp [en développement] == Outil de spatialisatoin des températures. {{{ MINERVE-D3\Spatial_Temp }}} == Snow_Analyzer [en développement] == Outil pour calculer les coefficients degré-jour de fonte de neige, à partir soit du produit OSHD du SLF, soit de MODIS. {{{ MINERVE-D3\Snow_Analyzer }}} == Raster_gap_Analyzer == Outil pour identifier les valeurs manquantes sur un produit raster dans la BD MAYA. [[BR]] Possible d'analyser plusieurs produits en même temps. [[BR]] {{{ MINERVE-D3\Divers\Raster_gap_Analyzer }}} == Raster_Additioner == Outil pour appliquer une fonction d'aggréation sur un produit raster sur une longue période (pas possible directement par l'API-REST). [[BR]] Note : la fonction d'aggrégation est définie dans le fichier API-node. {{{ MINERVE-D3\Divers\Raster_Additioner }}} == Raster_to_CSVR [En développement par javflu]== Outil pour extraire les valeurs d'un produit de la BD MAYA sur une période, un extent et une résolution spatiale définie par l'utilisateur. [[BR]] Démarche proposée : - Créer une fonction de lecture de données qui ne sauvegarde pas à chaque slot un fichier de données. - Créer une fonction ''get_coords_in_shp'' to define coordinates on which the function must loop. {{{ MINERVE-D3\Divers\Raster_to_CSVR }}} == Snow_Analyzer [A développer] == Outil pour l'assimilation de données en temps réel. {{{ MINERVE-D3\Data_Assimilation }}} == Améliorations / Tâches proposées == - Créer un fichier `global_param.ini` qui contiendrait des paramêtres globaux utilisables par tous les outils. À placer dans le dossier \MINERVE-D3. Il fuadrait donc changer, pour les fonctions qui l'utiliseraient, la façon de créer l'objet 'config' - Fixer un temps maximum pour télécharger des données de l'API - Donner l'option de ne pas créer un fichier temp différent à chaque itération (argument write_temp=TRUE). Ceci devrait fixer le nom du tmp_file sans l'incrémenter {{{ MINERVE-D3\Divers\Raster_to_CSVR }}} == Computer configuration == In order to work properly, the code requires - An installation of [https://curl.haxx.se/download.html curl] in C:\opt\Curl - Jave 8 Update 171 (64-bit) installed on the machine - RS MINERVE (at least version 2.6.0.0) installed on the machine {{{ #!div style="margin-top:3em; width:95%;border:1px solid #cccccc;" }}} [[span(Personne(s) de contact:,style=font-weight:bold;)]] [mailto:alain.foehn@crealp.ch?subject=Projet%20MINERVE-D3%20sur%20Trac alafoe] {{{ #!div style="width:95%;border:1px solid #cccccc;" }}} '''Autres projets:''' [http://trac.crealp.ch/Crealp-Admin/wiki Crealp-Admin], [http://trac.crealp.ch/Crealp-API/wiki Crealp-API], [https://trac.crealp.ch/Crealp-Product/wiki Crealp-Product], [http://trac.crealp.ch/polhydro-scripts/wiki MINERVE-scripts], [http://trac.crealp.ch/Ofev-CC/wiki Ofev-CC], [http://trac.crealp.ch/polhydro-pcr/wiki polhydro-pcr], [http://trac.crealp.ch/RSDataset/wiki RSDataset], [http://trac.crealp.ch/RSMinerve/wiki RSMinerve], [https://trac.crealp.ch/S.T.R.E.S.S/wiki S.T.R.E.S.S], [http://trac.crealp.ch/TeREsA/wiki TeREsA], [http://trac.crealp.ch/VIVA/wiki VIVA] '''Projets inactifs:''' [http://trac.crealp.ch/polhydro-bulletin/wiki MINERVE-bulletin], [http://trac.crealp.ch/polhydro-rest/wiki MINERVE-rest], [http://trac.crealp.ch/polhydro-www/wiki MINERVE-www], [http://trac.crealp.ch/SnowMapping/wiki SnowMapping], [https://trac.crealp.ch/toolmap2/wiki ToolMap 2] {{{ #!div style="width:95%;border:1px solid #cccccc;" }}}