= !License/Availability


There seems to be a lot of confusion what the two facets should contain.
Cleaning up and consolidating this information in VLO is scheduled for the upcoming [https://trac.clarin.eu/milestone/VLO-3.4 VLO-3.4] release. Please consult also issues #812, #813, #814 and notes from meeting at ["Taskforces/Curation/Meeting20151015" CAC2015]. 

== !Facet/Concept Definitions

The three facets and their descriptions/definitions as stated in the [https://github.com/clarin-eric/VLO/blob/master/vlo-commons/src/main/resources/facetConcepts.xml facetConcepts.xml] mapping file

||= facet =||= description =||= definition =||
|| availability  ||  The usage conditions for the resource or tool  || A rough description of the conditions under which the resource or tool can be used  ||
|| license  ||  The licensing conditions for the resource or tool  || The name of the license or a very brief description of the licensing conditions under which the resource or tool can be used  ||
|| accessInfo  ||  TODO...  ||  TODO...  ||


=== Concept Links
||==||==||||=used for facet=||==||==||==||
||= prefLabel (CCR) =||=Isocat =||= `Availability` =||= `Licence` =||= `accessInfo` =||= comment in `facetConcepts.xml` =||= CCR definition =||
||  [http://hdl.handle.net/11459/CCR_C-2453_1f0c3ea5-7966-ae11-d3c6-448424d4e6e8 availability] ||  [http://www.isocat.org/rest/dc/2453 DC-2453]  ||  yes   ||  yes   ||  yes   || A description of the terms of availability of the resource in simple words  || A description of the terms of availability of the resource in simple words. (source: CLARIN) ||
||  [http://hdl.handle.net/11459/CCR_C-2457_45bbaa1a-7002-2ecd-ab9d-57a189f694a6 license ] ||  [http://www.isocat.org/rest/dc/2457 DC-2457]  ||  yes   ||  yes   ||  no  || A description of the licensing conditions  || A description of the licensing conditions under which the resource can be used. (source: CLARIN) ||
||  [http://hdl.handle.net/11459/CCR_C-3800_12a79edd-0ffe-8d82-9831-45d125c54aee licence type] ||  [http://www.isocat.org/rest/dc/3800 DC-3800]  ||  yes  ||  yes  ||  yes  || licenceType: Indication of the type of a copyright licence  || Indication of the type of a copyright licence. (source: !NaLiDa) ||
||  [http://hdl.handle.net/11459/CCR_C-5439_98bb103d-476a-7f62-54b4-bf9de24d2229 license type] ||  [http://www.isocat.org/rest/dc/5439 DC-5439]  ||  yes   ||  no  ||  no (commented out)  || The DC is used in the distributionType facet || A rights-based classification of language resources and tools, indicating the scope of the target audience (source: CLARIN Deliverable: D7S-2.1, "A report including Model Licensing Templates and Authorization and Authentication Scheme") ||
|| [http://hdl.handle.net/11459/CCR_C-6586_2c79d86a-5a75-0890-d407-7d9cb86b9beb licence URL ] ||  [http://www.isocat.org/rest/dc/6586 DC-6586]  ||  yes  ||  yes  ||  no  || URL of a licence (see DC-2457), representing a web location at which the licence text is available.  || URL of a licence (see DC-2457), representing a web location at which the licence text is available. ||
||  [http://hdl.handle.net/11459/CCR_C-6846_d6adb99c-15ac-fac7-7911-f64c48298ce3 rights] ||  [http://www.isocat.org/rest/dc/6846 DC-6846]  ||  (yes) - only isocat link  ||  no  ||  yes  || DASISH from DC Rights  || Any rights information for this resource. (source: DASISH) ||
||  ||  [http://purl.org/dc/terms/license dcterms:license ] ||  no (commented out)  ||  no  ||  no (commented out)  || A legal document giving official permission to do something with the resource. (source: dcmi) ||

[https://clarin.oeaw.ac.at/exist/apps/smc-browser/index.html?graph=smc-graph-groups-profiles-datcats-rr.js&depth-before=7&depth-after=2&link-distance=120&charge=250&friction=75&gravity=10&node-size=4&link-width=1&labels=show&curve=straight-arrow&layout=horizontal-tree&selected=httpZZwww_isocat_orgZdatcatZDC_5439,httpZZwww_isocat_orgZdatcatZDC_3800 Snapshot from SMC-browser] showing which profiles use which of the two concepts: `license type` vs. `licence type`:

[[Image(smc_licenseType_licenceType_profile_dc_groups_2016-01-21.PNG)]]

== Normalization of values 

There is already a [https://github.com/clarin-eric/VLO/blob/master/vlo-vocabularies/maps/uniform_maps/LicenseAvailabilityMap.xml normalisation map used in production] (committed 19/02/2016). But there are new values that are not mapped yet. 
[https://drive.google.com/open?id=1Pf8Jk_P7RaA-7-dj8fcLOKNH5DjprraFEWXgQ3FvVtQ Normalisation map as gsheet] with already existing mappings (see normalisation map above) + new values encountered not yet normalized; [[BR]]
Values come from elements annotated with concepts linked to one of the two facets !License/Availability.

See also the [http://clarin.eu/content/license-categories license categories ] as proposed by the ''Legal Issues Committee''.

We propose to map the values to the license categories in decomposed fashion.
I.e. License `CC-BY-SA` would become `["PUB", "BY", "SA"]`.

Allowing multiple possible values for the facet in each record in combination with the (already implemented) multi-select feature in VLO this should cover for all use cases and be more ergonomic (e.g. if I am interested only in the Non-Commercial clause, I need to select only one facet value and don’t have to search for all the combination that contain NC.)

== Missing values

Curently all the mapped concepts only cover around 60.000 records! [http://minerva.arz.oeaw.ac.at/vlo/search?fq=availability:%5Bmissing+value%5D Records with missing value for availability]

Here we have 3 possible situations:
1.	Profile does not have any information about licensing/availability (worst case)
2.	Profile has information about L/A, but is not linked to a concept, or the concept is not in the facet mapping
3.	Profile is well defined, with linking to one of the concepts in the facet mapping, but the information is simply not filled in the record.


Overview of [https://docs.google.com/spreadsheets/d/1eeOr0ShOWxdY8BLzp62LDyfGgHo0gZ95Myw0qauzLxU/edit#gid=0&vpid=A1 profile/facet coverage] with special considerations of availability and licensing facet. Especially also the individual concepts contributing to the facet are plotted (see the `c-*` columns)

== What is done for VLO 3.4 release
* [https://github.com/clarin-eric/VLO/blob/master/vlo-commons/src/main/resources/facetConcepts.xml facetConcepts.xml] is restructured and has a new facet called `accessInfo`.
* new concept [https://openskos.meertens.knaw.nl/ccr/browser/index.php?id=http://hdl.handle.net/11459/CCR_C-6586_2c79d86a-5a75-0890-d407-7d9cb86b9beb licence URL] has been added to the availability and license facets.
* [https://drive.google.com/open?id=1Pf8Jk_P7RaA-7-dj8fcLOKNH5DjprraFEWXgQ3FvVtQ normalisation map] is updated with new values and CLIC did the mapping for new values.
* another normalisation map containing mappings from license values to license URIs is introduced, [https://github.com/clarin-eric/VLO/blob/master/vlo-vocabularies/maps/uniform_maps/LicenseURIMap.xml LicenseURIMap.xml]
*  In VLO GUI `Availability` facet is separated from others. This facet allows multi-selection of four values corresponding to the recommendations from CLIC PUB/ACA/RES/UNSPECIFIED. This values are represented with checkboxes followed by an icon and description in a tooltip. By deselecting all of them user gets records with OTHER category. In the list of results for each record user can see corresponding icons for licenses under which the CMD record is published. By selecting one record user will get detailed information about license in a separate section including explanation, links to licenses when available, original values from CMD record and disclaimer.