Changes

Jump to navigation Jump to search
Line 5: Line 5:     
This page gives an overview of the taxonomies and some guiding principles that are valid for all taxonomies. For each specific taxonomy there is a specific wikipage.
 
This page gives an overview of the taxonomies and some guiding principles that are valid for all taxonomies. For each specific taxonomy there is a specific wikipage.
  −
== Overview ==
  −
The list of taxonomies in use is:
  −
* ''Additives classes taxonomy''
  −
* ''Brands taxonomy'' for the producers of products and their corresponding brands. This taxonomy is not in use and still under construction (5-oct-2022);
  −
* ''Categories taxonomy'' used to put similar products together, so that they can be compared, averages calculated and analysed as a group. For instance an orange juice of a specific brand can be compared to all orange juices;
  −
* ''Countries taxonomy'' has a list of all countries, regions, areas, etc. in the world;
  −
* ''Ingredients taxonomy'' for ingredients found on product ingredients lists. Some specific ingredients have been put into separate taxonomies, as these need special handling due to legal requirements:
  −
** ''Additives taxonomy''
  −
** ''Allergens taxonomy''
  −
** ''Amino acids taxonomy''
  −
** ''[[Ingredients processing taxonomy]]''
  −
** ''Minerals taxonomy''
  −
** ''Nucleotides taxonomy''
  −
** ''Other nutritional substances taxonomy''
  −
** ''Vitamins taxonomy''
  −
* ''[[Labels taxonomy]]'' for every logo and claim by producer about product quality, supply chain, sourcing, diets, etc.;
  −
* ''[[Languages taxonomy]]'' with a list of world languages in multiple languages;
  −
* ''NOVA groups taxonomy''
  −
* ''Packaging/recycling taxonomies'' have been spread out over several specific taxonomies:
  −
** ''Materials taxonomy'' with a list of all possible materials that can be used;
  −
** ''Shapes taxonomy'' which describe all the packaging parts the packaging can consist of;
  −
** ''Recycling taxonomy'' with all ways packaging can be recycled;
  −
* ''States taxonomy'' which describe how complete the data of a product on OFF is;
      
== Presentations ==
 
== Presentations ==
 
There are several other presentation and descriptions on taxonomies, which you might to look at, before diving into the details:
 
There are several other presentation and descriptions on taxonomies, which you might to look at, before diving into the details:
 
* [https://docs.google.com/presentation/d/1zL2fA3d_fuPvKKKmCGJ5aV_Ug-R-gXQbwSCcxf3dbo4/edit?usp=sharing Quick presentation of the taxonomies]
 
* [https://docs.google.com/presentation/d/1zL2fA3d_fuPvKKKmCGJ5aV_Ug-R-gXQbwSCcxf3dbo4/edit?usp=sharing Quick presentation of the taxonomies]
 +
* [https://www.youtube.com/watch?v=b0xRwU_De9Q Lightning talk about taxonomies by Léonore] (Open Food Facts days 2023) and [https://docs.google.com/presentation/d/1_QPKTCyDXNK6HgwHQ0W-ebYCfkB3U3NcL0xLQJJZ9TU/edit#slide=id.p the slides]
 
* A [https://yuktea.wordpress.com/2022/06/22/three-generations/ short intro by Yukti on her blog].
 
* A [https://yuktea.wordpress.com/2022/06/22/three-generations/ short intro by Yukti on her blog].
   Line 79: Line 56:     
=== Structure ===
 
=== Structure ===
Each term section
+
The taxonomy is not a strict hierarchy: sections can have multiple parents. But cycles are not allowed. Formally it can be seen as a [https://en.wikipedia.org/wiki/Directed_acyclic_graph Directed Acyclic Graph].
The taxonomy is not a strict hierarchy: values can have multiple parents. But cycles are not allowed.
+
 
 +
For instance in the categories taxonomy the category '''Apricots''', can have the parent '''Fresh Food''' and the parent '''Fruit'''.
    
== Implementation ==
 
== Implementation ==
 
Each taxonomy is implemented as simple text file. See [[Taxonomy implementation]]
 
Each taxonomy is implemented as simple text file. See [[Taxonomy implementation]]
 +
 +
== Maintenance ==
 +
Anyone can contribute to the maintenance of these taxonomies. You might want to add a translation, add synonyms, new entries or parents. Have a look at [[Taxonomy Maintenance]].
 +
 +
== Taxonomy editor ==
 +
We have [https://ui.taxonomy.openfoodfacts.net/ a prototype to allow editing taxonomies]. The source code and bug report/feature requests are [https://github.com/openfoodfacts/taxonomy-editor located on GitHub]. We would welcome feedback on it.
 +
 +
== Overview ==
 +
The list of taxonomies in use is (these are the files in the [https://github.com/openfoodfacts/openfoodfacts-server/tree/main/taxonomies taxonomies folder] on Github:
 +
* ''Additives classes taxonomy''
 +
* ''Brands taxonomy'' for the producers of products and their corresponding brands. This taxonomy is not in use and still under construction (5-oct-2022);
 +
* ''Categories taxonomy'' used to put similar products together, so that they can be compared, averages calculated and analysed as a group. For instance an orange juice of a specific brand can be compared to all orange juices;
 +
* ''Countries taxonomy'' has a list of all countries, regions, areas, etc. in the world;
 +
* ''Ingredients taxonomy'' for ingredients found on product ingredients lists. Some specific ingredients have been put into separate taxonomies, as these need special handling due to legal requirements:
 +
** ''Additives taxonomy''
 +
** ''Allergens taxonomy''
 +
** ''Amino acids taxonomy''
 +
** ''[[Ingredients processing taxonomy]]''
 +
** ''Minerals taxonomy''
 +
** ''Nucleotides taxonomy''
 +
** ''Other nutritional substances taxonomy''
 +
** ''Vitamins taxonomy''
 +
* ''[[Labels taxonomy]]'' for every logo and claim by producer about product quality, supply chain, sourcing, diets, etc.;
 +
* ''[[Languages taxonomy]]'' with a list of world languages in multiple languages;
 +
* ''NOVA groups taxonomy''
 +
* ''Packaging/recycling taxonomies'' have been spread out over several specific taxonomies:
 +
** ''Materials taxonomy'' with a list of all possible materials that can be used;
 +
** ''Shapes taxonomy'' which describe all the packaging parts the packaging can consist of;
 +
** ''Recycling taxonomy'' with all ways packaging can be recycled;
 +
* ''States taxonomy'' which describe how complete the data of a product on OFF is;
    
== Ideas ==
 
== Ideas ==
Line 94: Line 102:  
* [[Global IGP taxonomy]]
 
* [[Global IGP taxonomy]]
 
* [[Global EC marks taxonomy]]
 
* [[Global EC marks taxonomy]]
 +
* [[Diets taxonomy]]
 +
 
== Access ==
 
== Access ==
 
The taxonomies can be viewed on Github, via the products on the website and with an API. This is detailed on a separate page:
 
The taxonomies can be viewed on Github, via the products on the website and with an API. This is detailed on a separate page:
 
[[Taxonomy access]].
 
[[Taxonomy access]].
 
+
[[Category:Taxonomies]]
== Building and deploying taxonomies ==
  −
 
  −
Changes to taxonomies on GitHub are not deployed instantly, the need to be built, deployed, and products need to be re-processed with the new taxonomy.
  −
 
  −
* [[How to build and deploy taxonomies]]
 

Navigation menu