Difference between revisions of "Vectors/home"
(→Background) |
(→Repository Contents) |
||
Line 20: | Line 20: | ||
= Repository Contents = | = Repository Contents = | ||
+ | The on-line browser dynamically presents parts of the information encoded | ||
+ | for programmatic access in the repository ''catalogue'', which is represented | ||
+ | as a JSON file in the top-level repository directory, with catalogue names | ||
+ | corresponding to each repository version, e.g. <tt>/projects/nlpl/data/vectors/10.json</tt> | ||
+ | for the initial repository release. | ||
+ | |||
+ | The catalogue contains three top-level section, one each for <tt>corpora</tt> | ||
+ | (data sources), <tt>algorithms</tt> (model creation tools), and | ||
+ | <tt>models</tt> (resulting sets of word vectors). | ||
+ | NLPL users with access to Abel (or Taito, once the repository is | ||
+ | replicated there) can read the catalogue file directly from the | ||
+ | project directory, for example when executing a series of experiments | ||
+ | that make use of different pre-trained sets of word vectors. | ||
= Using NLPL Models In-Situ = | = Using NLPL Models In-Situ = |
Revision as of 21:15, 23 January 2018
Background
The purpose of the NLPL repository of word vectors (which can comprise both ‘classic’, count-based and ‘modern’, dense models) is to make available a large and carefully curated collection of large-scale distributional models for many languages. For general background, please see Fares et al. (2017).
For interactive exploration and download of the repository, there is an on-line explorer. The underlying data is stored in the NLPL project directory below /projects/nlpl/data/vectors/. The repository is versioned, in the sense of assining release numbers to different stages of repository construction. The initial release (providing some two dozen models) was released in May 2017 as version 1.0. In early 2018, version 1.1 supersedes this initial release, adding a large number of models and languages and re-packaging the models from the original release in a more standardized format (see below).
Repository Contents
The on-line browser dynamically presents parts of the information encoded for programmatic access in the repository catalogue, which is represented as a JSON file in the top-level repository directory, with catalogue names corresponding to each repository version, e.g. /projects/nlpl/data/vectors/10.json for the initial repository release.
The catalogue contains three top-level section, one each for corpora (data sources), algorithms (model creation tools), and models (resulting sets of word vectors). NLPL users with access to Abel (or Taito, once the repository is replicated there) can read the catalogue file directly from the project directory, for example when executing a series of experiments that make use of different pre-trained sets of word vectors.
Using NLPL Models In-Situ
To avoid data duplication, it is recommended to load models from the NLPL repository directly from the NLPL project directory, when working on Abel (or Taito, once the repository is replicated there). Repository entries are uniformly packaged as .zip compressed archives, but the uniform naming scheming makes it possible to directly read one or more of the model files from the archive.
In Python, for example, something along the following lines should work
import zipfile repository = "/projects/nlpl/data/vectors/11" with ZipFile(repository + "/30.zip", "r") as archive: with archive.open("model.txt") as stream: for entry in stream: