= 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]]
La plupart des outils intéragissent directement avec la base de données MAYA et dans une moindre mesure avec la base de données MINERVE. Les fonctions permettant cette intéraction 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
}}}





{{{
#!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/MINERVE-Isotherm_0/wiki MINERVE-Isotherm_0], [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;"
}}}