Les récoltes

Description et problèmes d'interprétation

NEW 05/07/2023

La table recolte est en cours de réorganisation pour remplacer l'information date d'une fiche (qui est parfois ambigüe) par l'identifiant unique d'un évènementt eid.

Une récoltes est entièrement définie par le triplet de informations suivantes :

• un évènement (table Event) qui est connu pas son identifiant unique appelé eid (le eid est généralement une date sous la forme 20221001 pour peut être de la forme 20221001_expo ou 20221001a),
• un taxon (table Amref) identifié par le numéro unique amf_id (parfois aid dans le code php),
• un lieu (table Site) défini par un identifiant unique appelé sid dans le fichier amf_sites.yaml (mais site_name dans les fichiers YAML des évènements).

Cependant les récoltes sont actuellement renseignées dans des fichiers excel contenant :

• une colonne par sortie avec un nom de la forme 20221001a-canche
• une ligne par espèce, contenant en particulier l'information amf_id
• chaque cellule contient la chaine 1 si l'espèce associée à sa ligne a été récoltée lors de la sortie associée à sa colonne.

D'une manière générale, un nom de colonne est découpé en trois parties, et tout ce qui précède le premier "-" et supposé être le eid. Par exemple une colonne nommée 19991001_ab_cd-ef_gh-ij_kl sera analysée comme suit :

• le premier - est le séparateur (ignoré)
• ce qui précède le séparation sera le eid : 19991001_ab_cd
• tout le reste sera considéré comme la description desc : ef_gh-ij_kl

Exemples réel de noms de colonnes dans un fichier d'inventaire.

• 20220910b-mare-aux-evees
  La description ne correspondant pas à un sid (qui vaut ftb_mare_aux_evees) mais c'est sans importance car cette partie n'est considérée que comme une description.
• 20221019b-isatis
  Le sid associé est ici ftb_franchard_isatis

Organisation actuelle et future des données

Historique les seules données existantes lisible par le site sontles table events et sites décrite en YAML.

Par ailleurs un script Ruby lit les fichier Excels (table amrefs et recoltes) et contruit une base de données (qui contient aussi la table taxref).

Deopuis debut 2023, cette bases de données est lue par PHP, ce qui permet d'afficher des informations sur chaque amref et de faire la connnexion avec les évènements et les récoltes.

À terme, les fichiers Excel pourront être importés dirctement par PHP et l'import pourra se faire directement en ligne, donc par plusieurs personnes.

Quelques statistiques sur les récoltes

Permet aussi de dépister les incohérences des inventaires our du code php.

• Nombre de amf_id dans rrp.findAllAmfIds() : 1352.

  • Valeur du premier élément : amf_id = 145,
  • Nom du premier amref : amref.validName = Agaricus bitorquis

• le champ desc (représentant plus ou moins un site)

  • nombre des champs desc différents findAllDesc : 43
  • nombre des champs desc différents desc_sids_map : 43

• Nombre de sid (sites) connus (même sans récoltes) : srp.findAll() | length = 54

• Nombre d'évènements avec récolte dans rrp.findAllEvents() : 212.

• TODO : créer des listes supplémentaires, mais dans une autre page :

  • Mettre en valeur dans cette liste les sid associés à aucun un évènement (e.d les lieu de réunion AG ou formation)
  • Mettre en valeur dans cette liste les sid associés à aucune réculte
  • Compléter avec les champs desc qui ressemblent à des sid de site (pour dépister les erreurs : serait pratique mais difficile)

Liste des champs desc des récoltes et des sid ressemblants à desc

Nombre de résultats affichés : 43.

Colonne Excel :	sid candidat(s) (alias `site_name` dans les `amf_events_2NNN.yaml`)
canche :	m3p_canche,
8_routes :	vfm_8_routes,
courances :	m3p_courances,
sachot :	sachot,
bleau :
mennecy :	mennecy,
le_vaudoue :	m3p_le_vaudoue,
expo :	exposition,
orleans :	orleans, orleans_7_routes, orleans_caillettes,
barbeau :	barbeau, ftb_petit_barbeau,
monts_girards :	ftb_monts_girards,
rougeau_bois_arqueil :	rougeau_bois_arqueil,
rumilly-temple :
champagne :	champagne_sur_seine, we_champagne, we_champagne_rumilly,
ru_guerin :	vfm_ru_guerin,
mare_aux_evees :	ftb_mare_aux_evees,
boulains :	vfm_boulains,
toulouse :	ftb_toulouse,
isatis :	ftb_franchard_isatis,
we_perche :	we_perche,
mare-aux-evees :
we_morvan :	we_morvan,
rougeau-arqueil :
nanteau2 :
sologne :	we_sologne,
rougeau :	rougeau_bois_arqueil, rougeau_pav_royal,
barriere_noire :	barriere_noire,
senart :	senart_faisanderie, senart_mf_montgeron,
feuillardiere :	m3p_feuillardiere,
morvan :	we_morvan,
courtilleraies :	courtilleraies,
perche :	we_perche,
bourgogne :	we_bourgogne,
grands-feuillards :
sourdun :	sourdun,
poligny :	poligny,
othe :	othe_cerisiers, othe_st_ange,
bois_rond :	ftb_bois_rond,
nanteau1 :
avaux :	grands_avaux,
st_jerome :	m3p_st_jerome,
temple :
chambord :	we_chambord,

Liste des sids disponibles

• TODO :
  • lister ici les sites (sid) dont aucun évènement n'est associé à une récolte

ag_annuelle :
barbeau :
barriere_noire :
champagne_sur_seine :
courtilleraies :
exposition :
ftb_bois_rond :
ftb_chanfroy :
ftb_franchard_isatis :
ftb_grands_feuillards :
ftb_mare_aux_evees :
ftb_monts_girards :
ftb_petit_barbeau :
ftb_printemps :
ftb_recloses :
ftb_toulouse :
grands_avaux :
initiation :
m3p_canche :
m3p_courances :
m3p_feuillardiere :
m3p_le_vaudoue :
m3p_st_jerome :
mennecy :
nanteau_allee_pavee :
nanteau_commanderie :
orleans :
orleans_7_routes :
orleans_caillettes :
othe_cerisiers :
othe_st_ange :
poligny :
rougeau_bois_arqueil :
rougeau_pav_royal :
sachot :
senart_faisanderie :
senart_mf_montgeron :
sfg_ponthierry_26_couleurs :
sfg_ponthierry_club_house :
sfg_ponthierry_salle_assoc :
sfg_ponthierry_salle_henry_chaudey :
sfg_ponthierry_salle_riviere :
sourdun :
undef_sid :
vfm_8_routes :
vfm_boulains :
vfm_ru_guerin :
we_bourgogne :
we_chambord :
we_champagne :
we_champagne_rumilly :
we_morvan :
we_perche :
we_sologne :

Liste des date-eid (À COMPLÉTER)