diff --git a/1.1/DMP.md b/1.1/DMP.md new file mode 100644 index 0000000000000000000000000000000000000000..790bb95caa859bf43c496d8a2b718cf65367a4d0 --- /dev/null +++ b/1.1/DMP.md @@ -0,0 +1,340 @@ +--- +layout: default +#title: Definitions +has_children: false +nav_order: 2 +--- + +# The LAGO Data Management Plan (DMP) document +{: .no_toc } + +|Version| Updated | Date |Contributors| +|-------|---------|------|------------| +| 1.1 develop | {{ site.time }} | 2020-06-01 - today | LAGO Collaboration | + + +## Table of contents +{: .no_toc .text-delta } + +- TOC +{:toc} + +## A. Data summary + +This section presents the main issues on how the project deals with data as established in the LAGO Data Management Plan (DMP). + +#### **Purpose of the data collection/generation**. + +The [Latin American Giant Observatory (LAGO)](https://lagoproject.net) is an extended cosmic ray observatory composed of a network of water-Cherenkov detectors (WCD) spanning over different sites located at significantly different altitudes and latitudes. + +The measurements collected from these detectors are processed and analysed in subsequent steps. Additionally, scientists continuously generate simulated data. The final purpose is to enable the long-term curation and re-use of data within and outside the LAGO Collaboration through a Virtual Observatory. + +#### **Relation to the objectives of the project**. + +The objective is to enable the long-term curation and re-use of generated data within and outside LAGO Collaboration through a Virtual Observatory, being of interest in areas as HEP, space weather, life sciences, aerospatial security, computer science,... + +On the other hand, the European Commission requires open access to the results obtained from their funded projects meanwhile, EOSC-Synergy being a H2020 project (RIA 857647) encourages the implementation of FAIR policies as an additional standard in research. Since LAGO computations are included in the EOSC-Synergy project as one of their Thematic Services, the generated or stored data within the project resources must observe these guidelines, being also beneficial for the success of both initiatives. + +#### **Types and formats of generated/collected data**. + +Every generated **file** is considered **the minimum data-set** to be linked and processed, while **a collection** of related files is grouped in a **catalog**, which should be referenced with a persistent and unique identifier (PID). As the different LAGO activities generate only one data sub-type, **catalogs will only contain files belonging to one sub-type activity**, with exception of checking or correction procedures. + +There are two main kinds of data managed by the LAGO Collaboration. The first one is the data measured (L) by the water-Cherenkov detectors (WCD), and the second is the data obtained from simulations (S). + +The measured (raw) data is pipelined for correction and analysis, obtaining the following data sub-types according to their quality and processing level: + - **L0. Raw data**: data as acquired from detectors. Including onboard telemetry. Data directly acquired and transferred from the LAGO [ACQUA system](https://github.com/lagoproject/acqua). + - **L1. Preliminary data<sup>*</sup>**: low temporal resolution data processed in almost real-time. Only includes atmospheric pressure corrections. First processing level in the LAGO [ANNA framework](https://github.com/lagoproject/anna). + - **L2: Quality for Astrophysics<sup>*</sup>**. Ensures quality data to be used by experts from the Astrophysics Community: fixed level scalers by atmospheric parameters and the detector efficiency. This corresponds to the second level of processing in the [ANNA framework](https://github.com/lagoproject/anna). + - **L3. Quality for the general public<sup>*</sup>**. Ensures high quality data to be used by researchers from other subjects or the general public. Charge histograms of the detectors are also processed/corrected. This is the third level of processing in the [ANNA framework](https://github.com/lagoproject/anna). + +On the other hand, users can perform their own simulations of extensive atmospheric showers (EAS), the cascades of secondary particles are produced when a high-energy particle coming from the space interacts with the atmosphere. By using the LAGO [ARTI framework](https://github.com/lagoproject/arti), it is possible to simulate the expected flux on signals at the detector level including different geomagnetic, atmospheric and detector conditions. By using ARTI, users are able to generate different types of hierarchical data-sets: + - **S0. Plain simulations**: CORSIKA outputs, which are described in the official documentation [D. Heck and T. Pierog, "Extensive Air Shower Simulation with CORSIKA: A User’s Guide". Version 7.7100 from December 17, 2019](https://web.ikp.kit.edu/corsika/usersguide/usersguide.pdf), section 10, page 121. + - **S1. Analyzed simulations<sup>*</sup>**: ARTI analysis and outputs of the S0 data-set, containing the expected flux of secondary particles at the ground. + - **S2. Detector response simulations<sup>*</sup>**: ARTI detector simulation module, containing a complete, detailed and adjustable [Geant4](https://geant4.web.cern.ch/) model of the LAGO detectors. The main output is the expected signals in the detector, allowing site characterization and comparison with L2 and L3 data sets at each site. + +<sup>*</sup>(_Not supported by EOSC-Synergy. They are added for completeness and future projects._) + +#### **Re-used previous data**. + +Measurements from WCDs gathered in previous years and relevant simulations stored at the old centralized repository at UIS (Universidad Industrial de Santander, Colombia). This is, ~ 6.6TB, mainly measurements. Additionally, previous simulations performed by users in private clusters will be considered if it implies high CPU consumption. + +#### **Origin of the data**. + +| Data Type | Source | +|-----------|--------| +| Raw (L0) | measurements of Water-Cherenkov detectors (WCDs) | +| Preliminary (L1) | cleaning raw data (L0) | +| Quality for Astrophysics (L2)| fixed scalers from preliminary data (L1) | +| Quality for public (L3)| fixed scalers from histograms in quality data (L2) | +| Simulated (S0) | from standalone CORSIKA runs | +| Analyzed (S1) | ARTI analysis of plain simulated data (S0) | +| Analyzed (S2) | ARTI analysis including simulated detector response | + +#### **Expected size of the data**. + +Minimal data-set is one hour of measurement or simulation: + - Raw data (L0): ~200MB + - Preliminary data (L1): ~100MB + - Quality data (L2, L3): ~ 30 MB + - Simulated background (S0+S1+S2): ~ 10GB + - Simulated event (S0+S1+S2): ~ 110GB + +Typically, every WCD generates one measurement per hour producing files of ~ 200MB each, this is ~ 150GB of raw data per month for a total of 720 files. These files can originate 70-120GB of cleaned data (L1) and 10-40GB of quality data (L2 and L3). The one-hour interval is kept as the reference unit, resulting in 2160 files (between 2-160MB each). The necessary amount of CPU resources to generate these files is small; around 35 minutes on a Gold 6138 Intel core (2 GHz). However, all data-sets should be preserved for reprocessing if software errors appear in the future. + +On the other hand, users can perform their own simulations, which should be re-usable and reproducible by other collaborators. A standard simulation using only CORSIKA (i.e. s background simulation), results in a data-set of 4-10 GB (usually ~ 6 GB), but the simulation of one event could take up to 100 GB. Geant4 files output does not change these estimated figures. + +To keep the one-hour convention, both types of simulations are usually split into 60 runs, with an interval lasting from 15 minutes to 10 hours. One task per minute. Thus, the complete workload of a background simulation is over 640 CPU/hours (Gold Intel core, 2 GHz). Additionally, to assure reproducibility, every input and output file of each run should be in the data-set comprising 180 files. + +Currently, there are 10 detectors installed (plus 11 planned), that can potentially transfer 18 TB/year of raw data. Members of the Collaboration (~ 85 researchers) are also allowed to run simulations. Thus, the entire collaboration could generate up to 27 TB of raw, cleaned, and analyzed data, plus 12-120 TB of simulated data in one year. Nevertheless, the availability of detectors can be an issue, an active user could submit 10 or 20 simulations per month, but actually researchers do not regularly submit simulations, and even some may only run simulations sporadically. Therefore, a realistic estimation of the storage consumption could be around 3.6 TB/year of L(0-3) data corresponding to 4 WCDs and 2-8 TB/year corresponding to 25 active users. + +| Data Type | triggered | Size | +|-----------|--------|------| +| Raw (L0) | Water-Cherenkov detector (WCD) | 150GB/month (per WCD) | +| Preliminary (L1) | robot (mainly) or researcher | 70-120GB/month (per WCD) | +| Quality (L2 and L3)| robot (mainly) or researcher | 10-40GB/month (per WCD) | +| Simulated (S0, S1, and S2)| robot or researcher (mainly) | Estimated per 1 user: 1-4 sim. per month (72-300 GB/year) Max: 120GB/month | + +#### **The utility of the data: to whom will they be useful**. + +Data are of interest for the Astrophysics community but also for other scientific or industrial areas such as High Energy Physics, Life Sciences, Weather Forecasting, Geophysics, Aero-spatial security or Computer Science, among others, because of the effects of cosmic radiation on natural life, materials, or climate change, or its novel application in Geophysics. + +## B. FAIR data + +### B.1. Making data findable, including provisions for metadata: + +#### **Discoverability of data (metadata provision)**. + +The LAGO data repository will be based on [OneData](https://onedata.org). OneData supports storing catalogs and datasets with enriched metadata, as well as publishing catalogs with persistent identifiers (PIDs) to allow gathering by services such as [B2FIND](https://eudat.eu/services/b2find). Thus **the discoverability** will be technically guaranteed, through: +- OneData: + - for LAGO members: web browser (without search engine), CDMI API, proprietary API and FUSE mount; + - for the general public: web browser (link to a public PID). +- B2FIND: web interface (with search engine), for LAGO members and the general public. +- Other discovery services: customized CKAN based (for Comprehensive Knowledge Archive Network) could better benefit from metadata provided than B2FIND, and they will be explored in the future. Anyway, when the data become public, any discovery service can gather metadata, even not specific engines such as Google. + +Some of these services will be supported by the EOSC infrastructure as they are included in its [marketplace](https://marketplace.eosc-portal.eu/): +- OneData is [provided](https://marketplace.eosc-portal.eu/services/egi-datahub) through the [EGI DataHub service](https://datahub.egi.eu). +- B2FIND is also [offered](https://marketplace.eosc-portal.eu/services/b2find) through an unified [web page](http://b2find.eudat.eu/). + +Specific LAGO wrappers execute the processing or simulation and, at a subsequent stage, check every data-set and store them in the LAGO repository, always together with their metadata. These wrappers are packed into Docker images and released at the [official LAGO code repository](https://github.com/lagoproject) in GitHub. + +To assure the **metadata provision**, the only way to directly store and publish data-sets in the LAGO repository (by LAGO members) is by making use of these wrappers from the official Docker releases. Any other data to be included in the repository must be supervised and checked by the LAGO organization. + +#### **Identifiability of data and standard identification mechanisms (PIDs)** + +There are two kinds of standard identifiers: +1. Resolvable IRIs [(IETF RFC 3987)](https://tools.ietf.org/html/rfc3987) that univocally identifies every JSON-LD [(W3C Recomm.)](https://www.w3.org/TR/json-ld11/) object (datasets, catalogs and others) over the Internet. They build the network of standards-based, machine-readable linked-data across websites, actually allowing the provenance and reuse of the data. +2. [Handle.net](http://handle.net) PIDs that only points to catalogs or to repository providers. The first ones are used as shortcuts for publication (as cheaper [DOIs](https://doi.org)), but the second are for assuring the accessibility to the whole data through provider migrations (changes of name/domain), being part of the aforementioned IRIs. + +For clarification, the Internationalized Resource Identifier (IRI) is an internet protocol standard [IETF RFC 3987](https://tools.ietf.org/html/rfc3987) that unambiguously identifies an object, but a resolvable IRI corresponds to the one that can be publicly accessed on Internet, preferably through conventional protocols such as HTTP. The basis of JSON-LD syntax [(W3C Recomm.)](https://www.w3.org/TR/json-ld11/) is always to refer to related objects and descriptions with IRIs to discover new data by simply following those links. This creates a metadata grid linking objects. These objects describe datasets, catalogs as well as provenance elements (activities, actors, owners) following a certain vocabulary. + +On the other hand, repository providers are physical servers, with certain DNS name/IP. However, these addresses could change through time due to migrations of data, maintenance or changes of their domains. To preserve the linked grid and the univocal identification, absolute IRIs should use persistent and unique identifiers (PIDs) from [Handle.net](http://handle.net) to resolve these addresses, and even a catalog service. The preferred way to state this in JSON-LD is using the `@base` property in the `@context`, becoming the needed IRIs relative to the `@base` PID. + +As commented above, every generated file is considered a dataset, but only collections of related datasets compose the catalogs. Catalogs should be directly referenced with PIDs from Handle.net, but datasets should not. The reason is that there is no necessity for a dataset reference in a publication. For example, an input file without the output. Moreover, every file (i.e. dataset) can also be identified with a relative path to its catalog's PID. When a Catalog is complete and verified, the corresponding PID for being published will be automatically requested by the checker tool to the EOSC B2Handle service. + +#### **Naming conventions**. + +Any dataset or catalog will be referenced by its absolute IRI, composed by its provider PID, its internal path and its name. Note that a catalog corresponds to a directory and a dataset to a file in the repositories. + +In general, files (i.e datasets) generated by WCDs or base software will maintain their names when they are stored in repositories, but naming catalogs will follow a different approach. In order to be distinguishable, the catalog name will be based on the data type (L0-L3, S0-S2) by adding meaningful parameters used by the software, splitted by the `_` character. + +| Data Type | Source | Catalog Name | +|-----------|--------|------| +| Raw (L0) | Water-Cherenkov detector (WCD) | TBD. `L0_<site name>` | +| Preliminary (L1) | Raw data from WCD | (_TBD<sup>*</sup>._) `L1_<site name>` | +| Quality (L2) | Cleaned data from WCD | (_TBD<sup>*</sup>._) `L2_<site name>` | +| Quality (L3) | Cleaned data from WCD | (_TBD<sup>*</sup>._) `L3_<site name>` | +| Simulated (S0) | researchers | `S0_<site>_<flux time>_<altitude>_ <CORSIKA version>_<HE model>[_LE model][_volu][_flat][_Cherenk][_HEcuts][_GDASmodel]_[defaults]` | +| Analyzed (S1) | Analisyed data from S0 | (_TBD<sup>*</sup>._) `S1__<site>_<flux time>__<altitude>_ <CORSIKA version>_...` | +| Analyzed (S2) | Simulation model from S1 | (_TBD<sup>*</sup>._) `S2__<site>_<flux time>__<altitude>_ <CORSIKA version>_...` | + +<sup>*</sup>(_Not supported by EOSC-Synergy. It is added for completeness and future projects._) + +Moreover, versioning is only allowed for catalogs by adding a `_v<number>` at the end of the catalog´s name. + +#### **Approach towards search keywords**. + +Searching should be based on any metadata value, but there are technical limitations of the discovery services (i.e., B2FIND) and repositories (i.e., OneData). Therefore, the main search keywords that enable minimal SPARQL queries are the ones related to: +- the location (virtual or real) of the site: name, magnetic field, atmosphere, observation level and GPS coordinates; +- the measured period or the simulated flux time. + +#### **Approach for clear versioning**. + +To save on computational costs, versioning (i.e the same generation of files without modifiying the input parameters) only is allowed if corrections have been done by the software used for generating them. It implies that every file should be calculated again. Thus, it is more clear to build a new catalog for storing them together with their new metadata. It will be declared by adding a `_v<number>` at the end of the catalog's name, where `<number>` is a consecutive number indicating the version and starting with 2. + +Therefore, versioning directly the files (i.e. datasets) is not allowed, and the decision about versioning any catalog will be based on the metadata previously stored (related to parameters and software version). + + +#### **Standards for metadata creation (in your discipline)**. +(_If there are no standards in your discipline describe what metadata will be created and how_) + +| Data Type | related standards | previous metadata | new metadata specification | +|-----------|-------------------|-------------------|--------| +| Raw (L0) | JSON for GEANT4/ROOT validator. Freyermuth et. al, DOI: [10.1051/epjconf/201921405002](https://doi.org/10.1051/epjconf/201921405002) | key:value [(ACQUA docs)](https://github.com/lagoproject/acqua) and XML/DublinCore. Asorey H. et al, DOI: [10.1109/CCGrid.2016.110](https://doi.org/10.1109/CCGrid.2016.110) | JSON-LD/DCAT-AP based [profile](/DMP/schema/) and [definitions](/DMP/defs) | +| Preliminary (L1) | None | None | (_TBD<sup>*</sup>._) JSON-LD/DCAT-AP based [profile](/DMP/schema/) and [definitions](/DMP/defs) | +| Quality for Astrophysics (L2) | None | None | (_TBD<sup>*</sup>._) JSON-LD/DCAT-AP based [profile](/DMP/schema/) and [definitions](/DMP/defs) | +| Quality for public (L3) | None | None | (_TBD<sup>*</sup>._) JSON-LD/DCAT-AP based [profile](/DMP/schema/) and [definitions](/DMP/defs) | +| Simulated (S0) | None | XML/DublinCore: Asorey H. et al, DOI: [10.1109/CCGrid.2016.110](https://doi.org/10.1109/CCGrid.2016.110) | JSON-LD/DCAT-AP based [profile](/DMP/schema/) and [definitions](/DMP/defs) | +| Analyzed (S1) | JSON for GEANT4/ROOT validator: Freyermuth et. al, DOI: [10.1051/epjconf/201921405002](https://doi.org/10.1051/epjconf/201921405002) | None | ((_TBD<sup>*</sup>._) JSON-LD/DCAT-AP based [profile](/DMP/schema/) and [definitions](/DMP/defs) | +| Analyzed (S2) | None | None | (_TBD<sup>*</sup>._) JSON-LD/DCAT-AP based [profile](/DMP/schema/) and [definitions](/DMP/defs) | + +<sup>*</sup>(_Not supported by EOSC-Synergy. It is added for completeness and future projects._) + +### B.2. Making data openly accessible: + +#### **Which data will be made openly available**. + +(_If some data is kept closed provide rationale for doing so_). + +Data will be made publicly available after a variable waiting (embargo) period similar to the established ones for other large experiments. + +#### **Specify how the data will be made available**. + +Consolidated datasets (grouped by catalogs) will be exposed together with their metadata through the [EGI DataHub, https://datahub.egi.eu](https://datahub.egi.eu) service to be gathered by discovery services such as B2FIND, thus: + +- General public: B2FIND web interface at [http://b2find.eudat.eu](http://b2find.eudat.eu) (search engine of metadata published), a web browser to the page of some published catalog (link to a public PID). Additionally, as metadata follow a linked-data syntaxis and standards, other discovery services, even Google could find them. +- LAGO members: the aforementioned ones for general public plus, browser whole data repository at [https://datahub.egi.eu](https://datahub.egi.eu) (without search engine), +CDMI API, proprietary API and FUSE mount on a local system of the repository tree. + + +#### **Methods or software tools needed to access the data**. + +(_Is documentation about the software needed to access the data included?_) +(_Is it possible to include the relevant software (e.g. in open source code)?_) + +To profit from the published data, researchers should use the CORSIKA tools included in the source code and described in the official documentation in section 10, page 121 at +https://web.ikp.kit.edu/corsika/usersguide/usersguide.pdf + +#### **Where the data and associated metadata, documentation and code are deposited**. + +As commented above, data and metadata will be stored in providers associated to [EGI DataHub, https://datahub.egi.eu](https://datahub.egi.eu) service (relying in [OneData](https://onedata.org/) technology), while the documentation and codes: + +| Data Type | Docs and code URLs | +|-----------|--------| +| Raw (L0) | [ACQUA](https://github.com/lagoproject/acqua) | +| <sup>*</sup>Preliminary (L1), Quality for Astrophysics (L2) and for public (L3) | [ANNA](https://github.com/lagoproject/anna) | +| Simulated (S0) | [onedataSim](https://github/lagoproject/onedataSim), [ARTI](https://github/lagoproject/arti), [CORSIKA](https://web.ikp.kit.edu/corsika/) | +| <sup>*</sup>Simulated (S1, S2) | [onedataSim](https://github/lagoproject/onedataSim), [ARTI](https://github/lagoproject/arti), [CORSIKA](https://web.ikp.kit.edu/corsika), [GEANT4](https://geant4.web.cern.ch), [ROOT](https://root.cern.ch) and [geant-val](https://geant-val.cern.ch) | + +<sup>*</sup>(_Not supported by EOSC-Synergy. They are added for completeness and future projects._) + +#### **Specify how access will be provided in case there are any restrictions**. + +The data will be only accessible by the author and/or the Collaboration during the embargo period with the corresponding OpenID credentials. These will be obtained after login into the LAGO Virtual Organisation, supported by eduTEAMs (https://eduteams.org/), a service provided by GEANT in Europe and associated with RedClara. + +A manual for joining to the LAGO VO is published at: +- [https://lagoproject.github.io/DMP/docs/howtos/how_to_join_LAGO_VO/](https://lagoproject.github.io/DMP/docs/howtos/how_to_join_LAGO_VO/), + +while a manual to login into EGI DataHub, visualise datasets and obtain tokens is at: +- [https://lagoproject.github.io/DMP/docs/howtos/how_to_login_OneData/](https://lagoproject.github.io/DMP/docs/howtos/how_to_login_OneData/). + + +### B.3. Making data interoperable: + +#### **Interoperability of data (general vocabularies, standards or methodologies)** + +(_Specify what data and metadata vocabularies, standards or methodologies you will follow to facilitate interoperability_) + +Metadata: +- Language syntax: [JSON-LD 1.1, W3C](https://json-ld.org/spec/latest/json-ld/) +- Main vocabulary: [DCAT-AP2, European Commission](https://joinup.ec.europa.eu/collection/semantic-interoperability-community-semic/solution/dcat-application-profile-data-portals-europe), which is a specific profile of [DCAT2, W3C](https://www.w3.org/TR/vocab-dcat-2/) recommended for repositories, content aggregators or data consumers related to the public sector (goverments, rearch centers, funded projects). +- LAGO vocabulary: It is re-profile of [DCAT-AP2, European Commission](https://joinup.ec.europa.eu/collection/semantic-interoperability-community-semic/solution/dcat-application-profile-data-portals-europe), extending the existing classes and adding properties needed for the LAGO computation. The [re-profile](/DMP/schema/) and specific [definitions](/DMP/defs) are available at [https://lagoproject.github.io/DMP/](https://lagoproject.github.io/DMP/). + + +Data: +- Unfortunately, the generated data follow propietary formats. +- Interesting parameter or summarised results will be extracted from data-sets and then represented in their metadata using terms belonging LAGO vocabulary. + + +#### **Inter-disciplinary interoperability** + +(_Specify whether you will be using standard vocabulary for all data types present in your data set, to allow inter-disciplinary interoperability? If not, will you provide mapping to more commonly used ontologies?_) + +In principle, only supports [CORSIKA](https://web.ikp.kit.edu/corsika), inputs/outputs as described in the official documentation, which widely used in several disciplines. +However, rest of data currently follows a proprietary format. Translating files to standardised formats in the future can be considered. For now, the only alternative identified could be translate these files to the [ROOT](https://root.cern.ch) format and make use the vocabulary for [GEANT4/ROOT](https://geant-val.cern.ch) validator (Freyermuth et. al, DOI: [10.1051/epjconf/201921405002](https://doi.org/10.1051/epjconf/201921405002)), but it does not accomplishes all the requirements of LAGO. + + +### B.4. Increase data re-use (through clarifying licenses): + +#### **How the data will be licensed**. + +- Related code: [BSD-3 clause](https://opensource.org/licenses/BSD-3-Clause) +- Documentation (including DMP): [CC BY-NC-SA 4.0](https://creativecommons.org/licenses/by-nc-sa/4.0/legalcode) +- Metadata specifications: [CC BY-NC-SA 4.0](https://creativecommons.org/licenses/by-nc-sa/4.0/legalcode) +- Data: [CC BY-NC-SA 4.0](https://creativecommons.org/licenses/by-nc-sa/4.0/legalcode) +- Metadata: [CC BY-NC-SA 4.0](https://creativecommons.org/licenses/by-nc-sa/4.0/legalcode) +- Databases derived from metadata or data: [CC BY-NC-SA 4.0](https://creativecommons.org/licenses/by-nc-sa/4.0/legalcode) + +A compilation of common rights and acceptable use policies are available for reference at [https://lagoproject.github.io/DMP/rights/](https://lagoproject.github.io/DMP/rights/). + +#### **When the data will be made available for reuse**. + +(_Specify why and for what period a data embargo is needed_). + +LAGO Collaboration requires a waiting period similar to the established ones for other large experiments. Such a period should be set not only to properly exploit results by the Consortium before their availability, but because measured raw data must be pre-processed by the Consortium to make them 'understandable’. Simulations will be available too, but it would be valuable that the waiting period could be set by the user, as the data owner. The recommended embargo period is set as one year in general, but depends on the data type, specifically: + +| Data Type | embargo period | +|-----------|--------| +| L0 | private while quality data (L2,L3) are not publicly available. | +| L1 | should be released almost in real-time as it is important for operative space weather forecasting. Should include a disclaimer about quality and usage. | +| L2, L3 | one year.| +| S0, S1, S2 | one year maximum, the owner can decide to open the data before the end of this period.| + +#### **Usability by third parties (restricted data)**. + +(_Specify whether the data produced and/or used in the project is usable by third parties, in particular after the end of the project? If the re-use of some data is restricted, explain why_). + +There is no restriction after the embargo period with exception of the [CC BY-NC-SA 4.0](https://creativecommons.org/licenses/by-nc-sa/4.0/legalcode) clauses. + +#### **Data quality assurance processes**. + +Only the data measured by WCDs or generated using software versions officially released by LAGO will be stored and exposed in the repositories. Previously to the publication, a robot of the Virtual Organization will check the minimal accuracy of the data. + +#### **Length of time for which the data will remain re-usable**. + +Indefinitely, after the waiting period. + +## C. Allocation of resources + +Cloud storage is based on OneData techonology, and the architecture will count on: +- The OneZone service at [EGI DataHub](https://datahub.egi.eu), supported by the EOSC infrastructure. +- A network of OneProviders, supported by LAGO participating institutions: + - Tier 1 OneProviders: the high capacity ones will store all data generated, backing up other tiers and among them. + - Tier 2 OneProviders: mid-capacity servers assuring long-term availability, used to improve the performance in a region. + - Tier 3 OneProviders: temporal deployments for local caching before consolidate data in upper tiers. + +The architecture is deeply described at [https://lagoproject.github.io/DMP/Architecture/](https://lagoproject.github.io/DMP/Architecture/). + +#### **Costs for making your data FAIR**. + +The process of making the data FAIR will be supported by the EOSC-Synergy project. The cost of the management (human resources) will be supported by the LAGO Collaboration and its participating institutions. + +#### **Responsibilities for data management in your project**. + +Computing as data management will be structured as a Virtual Organization with specific roles for data acquisition and processing. + +| Roles | Responsability | +|-------|-----------------| +| Head of data management | Administrative account, only for enabling new resources or modifiying permissions of main roles. | +| System admnistrators of OneProviders | To maintain the availability and preserve the data and metadata stored. | +| Members of standardisation group | To establish data organisation and metadata definition. | +| Country representative/delegate | To authorise or ban local members in the VO. | +| Task coordination delegates | To assure the accurancy of a spcific kind of data and metadata automatially (robots) or manually generated (for example the raw data (L0)). | +| LAGO members | They must follow the rules of data generation/storing and they must not abuse of the services. | + +#### **Costs and potential value of long-term preservation**. + +Preservation of data-sets is essential for the sustainability of LAGO. Every active WCD should generate 300GB/month of L0-L3 data. Currently, due to the number of active WCDs, the Collaboration will generate up to 27 TB of L0-L3 data, plus 12-120 TB of simulated data throughout the year. Data should be replicated, at least, in two locations of a distributed repository (in this case OneData). + +Considering an average generation of 60TB/year, the costs of a 4-years long-term data preservation are related to hardware (two generic RAID servers ~240TB = ~30k€, prices in 2019), consumption (3.68KW max. power for 2 servers, ~ 0.1 €/kWh industrial price average in 2019 = max. 13k€) and human resources (technician: 1 person/month, scientific: 2 p/m, ~10k€). + +## D. Data security + +(_Address data recovery as well as secure storage and transfer of sensitive data_). + +There is no sensitive data, thus anonymity and encryption are not required. + +Data recovery should be guaranteed by using replication, at least, in two locations of a distributed repository or filesystem, in this case OneData. Thus, following the classification in tiers, every space supported by an OneProvider must be replicated in any other OneProvider that holds Tier level 1. The backup architecture is described at [https://lagoproject.github.io/DMP/Architecture/](https://lagoproject.github.io/DMP/Architecture/). + +## E. Ethical aspects + +Data do not contain protected records that could present ethical or security issues. The only personal data included are the required by FAIR policies in metadata, i.e., the name and the identifier of the author of the data-set. On the other hand, there are no issues with reusing previous raw data generated in LAGO, as well as the data belonging to the Collaboration. diff --git a/1.1/LICENSE b/1.1/LICENSE new file mode 100644 index 0000000000000000000000000000000000000000..0992616ef460d847dda0ff9de7ce0c30b2996a6a --- /dev/null +++ b/1.1/LICENSE @@ -0,0 +1,104 @@ +Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International Public License + +By exercising the Licensed Rights (defined below), You accept and agree to be bound by the terms and conditions of this Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International Public License ("Public License"). To the extent this Public License may be interpreted as a contract, You are granted the Licensed Rights in consideration of Your acceptance of these terms and conditions, and the Licensor grants You such rights in consideration of benefits the Licensor receives from making the Licensed Material available under these terms and conditions. + +Section 1 – Definitions. + + Adapted Material means material subject to Copyright and Similar Rights that is derived from or based upon the Licensed Material and in which the Licensed Material is translated, altered, arranged, transformed, or otherwise modified in a manner requiring permission under the Copyright and Similar Rights held by the Licensor. For purposes of this Public License, where the Licensed Material is a musical work, performance, or sound recording, Adapted Material is always produced where the Licensed Material is synched in timed relation with a moving image. + Adapter's License means the license You apply to Your Copyright and Similar Rights in Your contributions to Adapted Material in accordance with the terms and conditions of this Public License. + BY-NC-SA Compatible License means a license listed at creativecommons.org/compatiblelicenses, approved by Creative Commons as essentially the equivalent of this Public License. + Copyright and Similar Rights means copyright and/or similar rights closely related to copyright including, without limitation, performance, broadcast, sound recording, and Sui Generis Database Rights, without regard to how the rights are labeled or categorized. For purposes of this Public License, the rights specified in Section 2(b)(1)-(2) are not Copyright and Similar Rights. + Effective Technological Measures means those measures that, in the absence of proper authority, may not be circumvented under laws fulfilling obligations under Article 11 of the WIPO Copyright Treaty adopted on December 20, 1996, and/or similar international agreements. + Exceptions and Limitations means fair use, fair dealing, and/or any other exception or limitation to Copyright and Similar Rights that applies to Your use of the Licensed Material. + License Elements means the license attributes listed in the name of a Creative Commons Public License. The License Elements of this Public License are Attribution, NonCommercial, and ShareAlike. + Licensed Material means the artistic or literary work, database, or other material to which the Licensor applied this Public License. + Licensed Rights means the rights granted to You subject to the terms and conditions of this Public License, which are limited to all Copyright and Similar Rights that apply to Your use of the Licensed Material and that the Licensor has authority to license. + Licensor means the individual(s) or entity(ies) granting rights under this Public License. + NonCommercial means not primarily intended for or directed towards commercial advantage or monetary compensation. For purposes of this Public License, the exchange of the Licensed Material for other material subject to Copyright and Similar Rights by digital file-sharing or similar means is NonCommercial provided there is no payment of monetary compensation in connection with the exchange. + Share means to provide material to the public by any means or process that requires permission under the Licensed Rights, such as reproduction, public display, public performance, distribution, dissemination, communication, or importation, and to make material available to the public including in ways that members of the public may access the material from a place and at a time individually chosen by them. + Sui Generis Database Rights means rights other than copyright resulting from Directive 96/9/EC of the European Parliament and of the Council of 11 March 1996 on the legal protection of databases, as amended and/or succeeded, as well as other essentially equivalent rights anywhere in the world. + You means the individual or entity exercising the Licensed Rights under this Public License. Your has a corresponding meaning. + +Section 2 – Scope. + + License grant. + Subject to the terms and conditions of this Public License, the Licensor hereby grants You a worldwide, royalty-free, non-sublicensable, non-exclusive, irrevocable license to exercise the Licensed Rights in the Licensed Material to: + reproduce and Share the Licensed Material, in whole or in part, for NonCommercial purposes only; and + produce, reproduce, and Share Adapted Material for NonCommercial purposes only. + Exceptions and Limitations. For the avoidance of doubt, where Exceptions and Limitations apply to Your use, this Public License does not apply, and You do not need to comply with its terms and conditions. + Term. The term of this Public License is specified in Section 6(a). + Media and formats; technical modifications allowed. The Licensor authorizes You to exercise the Licensed Rights in all media and formats whether now known or hereafter created, and to make technical modifications necessary to do so. The Licensor waives and/or agrees not to assert any right or authority to forbid You from making technical modifications necessary to exercise the Licensed Rights, including technical modifications necessary to circumvent Effective Technological Measures. For purposes of this Public License, simply making modifications authorized by this Section 2(a)(4) never produces Adapted Material. + Downstream recipients. + Offer from the Licensor – Licensed Material. Every recipient of the Licensed Material automatically receives an offer from the Licensor to exercise the Licensed Rights under the terms and conditions of this Public License. + Additional offer from the Licensor – Adapted Material. Every recipient of Adapted Material from You automatically receives an offer from the Licensor to exercise the Licensed Rights in the Adapted Material under the conditions of the Adapter’s License You apply. + No downstream restrictions. You may not offer or impose any additional or different terms or conditions on, or apply any Effective Technological Measures to, the Licensed Material if doing so restricts exercise of the Licensed Rights by any recipient of the Licensed Material. + No endorsement. Nothing in this Public License constitutes or may be construed as permission to assert or imply that You are, or that Your use of the Licensed Material is, connected with, or sponsored, endorsed, or granted official status by, the Licensor or others designated to receive attribution as provided in Section 3(a)(1)(A)(i). + + Other rights. + Moral rights, such as the right of integrity, are not licensed under this Public License, nor are publicity, privacy, and/or other similar personality rights; however, to the extent possible, the Licensor waives and/or agrees not to assert any such rights held by the Licensor to the limited extent necessary to allow You to exercise the Licensed Rights, but not otherwise. + Patent and trademark rights are not licensed under this Public License. + To the extent possible, the Licensor waives any right to collect royalties from You for the exercise of the Licensed Rights, whether directly or through a collecting society under any voluntary or waivable statutory or compulsory licensing scheme. In all other cases the Licensor expressly reserves any right to collect such royalties, including when the Licensed Material is used other than for NonCommercial purposes. + +Section 3 – License Conditions. + +Your exercise of the Licensed Rights is expressly made subject to the following conditions. + + Attribution. + If You Share the Licensed Material (including in modified form), You must: + retain the following if it is supplied by the Licensor with the Licensed Material: + identification of the creator(s) of the Licensed Material and any others designated to receive attribution, in any reasonable manner requested by the Licensor (including by pseudonym if designated); + a copyright notice; + a notice that refers to this Public License; + a notice that refers to the disclaimer of warranties; + a URI or hyperlink to the Licensed Material to the extent reasonably practicable; + indicate if You modified the Licensed Material and retain an indication of any previous modifications; and + indicate the Licensed Material is licensed under this Public License, and include the text of, or the URI or hyperlink to, this Public License. + You may satisfy the conditions in Section 3(a)(1) in any reasonable manner based on the medium, means, and context in which You Share the Licensed Material. For example, it may be reasonable to satisfy the conditions by providing a URI or hyperlink to a resource that includes the required information. + If requested by the Licensor, You must remove any of the information required by Section 3(a)(1)(A) to the extent reasonably practicable. + + ShareAlike. + In addition to the conditions in Section 3(a), if You Share Adapted Material You produce, the following conditions also apply. + The Adapter’s License You apply must be a Creative Commons license with the same License Elements, this version or later, or a BY-NC-SA Compatible License. + You must include the text of, or the URI or hyperlink to, the Adapter's License You apply. You may satisfy this condition in any reasonable manner based on the medium, means, and context in which You Share Adapted Material. + You may not offer or impose any additional or different terms or conditions on, or apply any Effective Technological Measures to, Adapted Material that restrict exercise of the rights granted under the Adapter's License You apply. + +Section 4 – Sui Generis Database Rights. + +Where the Licensed Rights include Sui Generis Database Rights that apply to Your use of the Licensed Material: + + for the avoidance of doubt, Section 2(a)(1) grants You the right to extract, reuse, reproduce, and Share all or a substantial portion of the contents of the database for NonCommercial purposes only; + if You include all or a substantial portion of the database contents in a database in which You have Sui Generis Database Rights, then the database in which You have Sui Generis Database Rights (but not its individual contents) is Adapted Material, including for purposes of Section 3(b); and + You must comply with the conditions in Section 3(a) if You Share all or a substantial portion of the contents of the database. + +For the avoidance of doubt, this Section 4 supplements and does not replace Your obligations under this Public License where the Licensed Rights include other Copyright and Similar Rights. + +Section 5 – Disclaimer of Warranties and Limitation of Liability. + + Unless otherwise separately undertaken by the Licensor, to the extent possible, the Licensor offers the Licensed Material as-is and as-available, and makes no representations or warranties of any kind concerning the Licensed Material, whether express, implied, statutory, or other. This includes, without limitation, warranties of title, merchantability, fitness for a particular purpose, non-infringement, absence of latent or other defects, accuracy, or the presence or absence of errors, whether or not known or discoverable. Where disclaimers of warranties are not allowed in full or in part, this disclaimer may not apply to You. + To the extent possible, in no event will the Licensor be liable to You on any legal theory (including, without limitation, negligence) or otherwise for any direct, special, indirect, incidental, consequential, punitive, exemplary, or other losses, costs, expenses, or damages arising out of this Public License or use of the Licensed Material, even if the Licensor has been advised of the possibility of such losses, costs, expenses, or damages. Where a limitation of liability is not allowed in full or in part, this limitation may not apply to You. + + The disclaimer of warranties and limitation of liability provided above shall be interpreted in a manner that, to the extent possible, most closely approximates an absolute disclaimer and waiver of all liability. + +Section 6 – Term and Termination. + + This Public License applies for the term of the Copyright and Similar Rights licensed here. However, if You fail to comply with this Public License, then Your rights under this Public License terminate automatically. + + Where Your right to use the Licensed Material has terminated under Section 6(a), it reinstates: + automatically as of the date the violation is cured, provided it is cured within 30 days of Your discovery of the violation; or + upon express reinstatement by the Licensor. + For the avoidance of doubt, this Section 6(b) does not affect any right the Licensor may have to seek remedies for Your violations of this Public License. + For the avoidance of doubt, the Licensor may also offer the Licensed Material under separate terms or conditions or stop distributing the Licensed Material at any time; however, doing so will not terminate this Public License. + Sections 1, 5, 6, 7, and 8 survive termination of this Public License. + +Section 7 – Other Terms and Conditions. + + The Licensor shall not be bound by any additional or different terms or conditions communicated by You unless expressly agreed. + Any arrangements, understandings, or agreements regarding the Licensed Material not stated herein are separate from and independent of the terms and conditions of this Public License. + +Section 8 – Interpretation. + + For the avoidance of doubt, this Public License does not, and shall not be interpreted to, reduce, limit, restrict, or impose conditions on any use of the Licensed Material that could lawfully be made without permission under this Public License. + To the extent possible, if any provision of this Public License is deemed unenforceable, it shall be automatically reformed to the minimum extent necessary to make it enforceable. If the provision cannot be reformed, it shall be severed from this Public License without affecting the enforceability of the remaining terms and conditions. + No term or condition of this Public License will be waived and no failure to comply consented to unless expressly agreed to by the Licensor. + Nothing in this Public License constitutes or may be interpreted as a limitation upon, or waiver of, any privileges and immunities that apply to the Licensor or You, including from the legal processes of any jurisdiction or authority. + diff --git a/1.1/README.md b/1.1/README.md new file mode 100644 index 0000000000000000000000000000000000000000..644315b0a907bbc23ddb19e9a7cd8279705596f2 --- /dev/null +++ b/1.1/README.md @@ -0,0 +1,22 @@ +--- +layout: default +title: Contributing +has_children: false +nav_order: 8 +--- + +## Description of this repository + +This repository contains the Data Management Plan (DMP) for [Latin American Giant Observatory (LAGO)](http://lagoproject.net/) Collaboration. It is a dynamic document that describes data, metadata, and how they are produced, accessed and managed: + +[https://lagoproject.github.io/DMP/](https://lagoproject.github.io/DMP/) + +## Contributing + +- All LAGO members can contribute to the *dev* branch of DMP through pull requests. +- Members of standardisation group can authorise pull requests to the *dev* branch, but not `merge` their own modifications to the *master* branch without an additional authorisation. +- Only managers or administrators of the repository can directly `merge` the contribution to the *master* branch and publish stable releases. + +## License + +All contents of this repository are under the terms of the Creative Common [CC BY-NC-SA 4.0](./LICENSE) license, with exception of some code needed for rendering the web page, which has its own license declared at the head of the code. diff --git a/1.1/_config.yml b/1.1/_config.yml new file mode 100644 index 0000000000000000000000000000000000000000..43c54318e1e12bba2d124d910f3ff327d0f895a3 --- /dev/null +++ b/1.1/_config.yml @@ -0,0 +1,104 @@ +# Minimun config +title: "LAGO Data Management Plan" +remote_theme: pmarsceill/just-the-docs +# Color scheme supports "light" (default) and "dark" +color_scheme: "light" +# logo: "/images/lago.png" +# baseurl: "/DMP" # the subpath of your site, e.g. /blog +# url: "https://lagoproject.github.io/DMP" # the base hostname & protocol for your site, e.g. http://example.com +permalink: pretty +# exclude: ["node_modules/", "*.gemspec", "*.gem", "Gemfile", "Gemfile.lock", "package.json", "package-lock.json", "script/", "LICENSE.txt", "lib/", "bin/", "README.md", "Rakefile", "docs/tests/"] + +# Regression tests +# By default, the pages in /docs/tests are excluded when the ste is built. +# To include them, comment-out the relevant line above. +# Uncommenting the following line doesn't work - see https://github.com/jekyll/jekyll/issues/4791 +# include: ["docs/tests/"] + +# +# +# Enable or disable the site search +# Supports true (default) or false +search_enabled: true +search: + # Split pages into sections that can be searched individually + # Supports 1 - 6, default: 2 + heading_level: 2 + # Maximum amount of previews per search result + # Default: 3 + previews: 3 + # Maximum amount of words to display before a matched word in the preview + # Default: 5 + preview_words_before: 5 + # Maximum amount of words to display after a matched word in the preview + # Default: 10 + preview_words_after: 10 + # Set the search token separator + # Default: /[\s\-/]+/ + # Example: enable support for hyphenated search words + tokenizer_separator: /[\s/]+/ + # Display the relative url in search results + # Supports true (default) or false + rel_url: true + # Enable or disable the search button that appears in the bottom right corner of every page + # Supports true or false (default) + button: false +# +# +# Aux links for the upper right navigation +aux_links: + "LAGO DMP on GitHub": + - "https://github.com/lagoproject/DMP/" +# Makes Aux links open in a new tab. Default is false +aux_links_new_tab: false +# +# +# Heading anchor links appear on hover over h1-h6 tags in page content +# allowing users to deep link to a particular heading on a page. +# Supports true (default) or false +heading_anchors: true +# +# Footer content +# appears at the bottom of every page's main content +footer_content: "Copyright © 2020, The LAGO Collaboration. Distributed by an <a href=\"https://github.com/lagoproject/DMP/tree/master/LICENSE\">CC BY-NC-SA 4.0</a>" +# Footer last edited timestamp +last_edit_timestamp: true # show or hide edit time - page must have `last_modified_date` defined in the frontmatter +last_edit_time_format: "%b %e %Y at %I:%M %p" # uses ruby's time format: https://ruby-doc.org/stdlib-2.7.0/libdoc/time/rdoc/Time.html +# Footer "Edit this page on GitHub" link text +gh_edit_link: true # show or hide edit this page link +gh_edit_link_text: "Edit this page on GitHub." +gh_edit_repository: "https://github.com/lagoproject/DMP/" # the github URL for your repo +gh_edit_branch: "develop" # the branch that your docs is served from +# gh_edit_source: docs # the source that your files originate from +gh_edit_view_mode: "tree" # "tree" or "edit" if you want the user to jump into the editor immediately +# +# +# Google Analytics Tracking (optional) +# e.g, UA-1234567-89 +# ga_tracking: UA-5555555-55 +# ga_tracking_anonymize_ip: true # Use GDPR compliant Google Analytics settings (true by default) +# +# +# Define Jekyll collections +# collections: + # Define a collection named "docs", its documents reside in the "_docs" directory + #docs: + # permalink: "/:collection/:path/" + # output: true +# just_the_docs: + # Define which collections are used in just-the-docs + #collections: + # # Reference the "docs" collection + # docs: + # # Give the collection a name + # name: Documentation + # # Exclude the collection from the navigation + # # Supports true or false (default) + # nav_exclude: false + # # Exclude the collection from the search + # # Supports true or false (default) + # search_exclude: false + + + + diff --git a/1.1/_includes/generate_html_for_sites.html b/1.1/_includes/generate_html_for_sites.html new file mode 100644 index 0000000000000000000000000000000000000000..c1d9d2d7294b8be06e83dc33ec06a69bbfa0808c --- /dev/null +++ b/1.1/_includes/generate_html_for_sites.html @@ -0,0 +1,156 @@ +<!-- +################################################################################ +# Original Author: A.J. Rubio-Montero (http://orcid.org/0000-0001-6497-753X), # +# CIEMAT - Sci-Track Group (http://rdgroups.ciemat.es/web/sci-track), # +# for the EOSC-Synergy project (EU H2020 RI Grant No 857647). # +# License (SPDX): BSD-3-Clause (https://opensource.org/licenses/BSD-3-Clause) # +# Copyright (c): 2020-today, The LAGO Collaboration (http://lagoproject.net) # +################################################################################ +--> +<script src="https://code.jquery.com/jquery-3.2.1.min.js"></script> +<script> +function itemnize_json( json, context, link ) { + var html =''; + if ( (link == false) || (typeof(json) === 'boolean') ) return json; + if ( typeof(json) === 'string' ) { + var element = json.split(':'); + var innid = element[0]; + var vocab = "@vocab"; + if (element.length == 2) { + if ( (element[0] !== "http") && (element[0] !== "https") ) { + innid = element[1]; + vocab = element[0]; + } else return '<a href="'+ json +'">'+ json +'</a>'; + } else return json; + var contexturl = context[vocab]; + if ( vocab == "lago" ) { + contexturl = 'https://lagoproject.github.io/DMP/schema/lagoSchema/'; + innid = json; + }; + if ( contexturl[contexturl.length-1] !== '#' ) contexturl = contexturl + '#'; + if ( vocab == "sdo" ) contexturl = context[vocab]; + html = '<a href="'+ contexturl + innid +'">'+ json +'</a>'; + } else { + if ( !(Array.isArray(json)) ) { + var json_aux = []; + json_aux.push(json); + json = json_aux; + }; + for (var j=0; j<json.length; j++) { + var inner_json = json[j]; + if ( !(typeof(json[j]) === 'string') ) { + if ("@id" in json[j]) { + inner_json = json[j]["@id"]; + } else { + inner_json = JSON.stringify(json[j]); + link = false; + }; + }; + html = html + '<br />' + itemnize_json(inner_json, context, link); + }; + }; + return html; +}; +function gmap_static(lat, long, type) { + return '<div style="width: 100%"><iframe class="iframe" src="https://maps.google.com/?ll='+lat+','+long+'&z=13&t='+type+'amp;iwloc=B&output=embed" height="200" allowfullscreen></iframe></div>'; +}; +$().ready(function(){ + $.getJSON( "{{ include.folder }}", function( data ) { + var graphelements = data["@graph"]; + for (var i=0; i<graphelements.length; i++) { + var element = graphelements[i]; + var id = element["@id"]; + var indexhtml = '<li><a href="#'+id+'"><strong>'+id+'</strong> ['+element["name"]+'].'+'</a></li>'; + var headerhtml = '<h5 id="'+id+'"><a href="#'+id+'" class="anchor-heading" aria-labelledby="'+id+'"><svg viewBox="0 0 16 16" aria-hidden="true"><use xlink:href="#svg-link"></use></svg></a><strong>'+id+'</strong></h5>'; + headerhtml = headerhtml+'<p>'+'Site located in '+element["name"]; + if (["qualifiedAttribution"]["name"] !== "") { + headerhtml = headerhtml+' and managed by '+element["qualifiedAttribution"]["name"]; + }; + headerhtml = headerhtml+'.'+'</p>'; + if ("comment" in element) { + headerhtml = headerhtml+'<p>'+ element["comment"][0]["@value"]+'</p>'; + }; + headerhtml = headerhtml+gmap_static(element["geometry"]["geo:latitude"],element["geometry"]["geo:longitude"],"k"); + if (element["lago:belongsLago"]) { + $('#iproperties').append(indexhtml); + $('#properties').append(headerhtml); + } else { + $('#iclasses').append(indexhtml); + $('#classes').append(headerhtml); + }; + var keysUP = Object.keys(element); + keysUP.splice(keysUP.indexOf("@id"),1); + keysUP.splice(keysUP.indexOf("@type"),1); + keysUP.splice(keysUP.indexOf("comment"),1); + keysUP.splice(keysUP.indexOf("name"),1); + keysUP.splice(keysUP.indexOf("lago:belongsLago"),1); + keysUP.splice(keysUP.indexOf("qualifiedAttribution"),1); + table = '<ul> The default propierties defined for <strong>'+ id + '</strong> site are:' ; + for (var up=0; up<keysUP.length; up++) { + var keys = Object.keys(element[keysUP[up]]); + table = table + '<li>'+ itemnize_json(keysUP[up], data["@context"], true )+' :'; + table = table + '<table class="grid" style="width: 100%"> + <thead> + <tr class="header">'; + for (var k=0; k<keys.length; k++) { + table = table + ' <th>'+ itemnize_json([keys[k]], data["@context"], true ) + '</th>'; + }; + table = table +' </tr> + </thead> + <tbody> + <tr>'; + for (var k=0; k<keys.length; k++) { + table = table +' <td>'+ itemnize_json(element[keysUP[up]][keys[k]] , data["@context"], true ) +'</td>'; + }; + table = table +' </tr> + </tbody> + </table>'; + table = table + '</li>'; + }; + table = table + '</ul>'; + if (element["lago:belongsLago"]) { + $('#properties').append(table); + } else { + $('#classes').append(table); + }; + }; + }); +}); +</script> + +{% if include.vocabulary == "true" %} + +- [**Classes**](#classes) + <ul id="iclasses"></ul> + +- [**Properties**](#properties) + <ul id="iproperties"></ul> + +### Classes + +<div id="classes"></div> + +### Properties + +<div id="properties"></div> + +{% else %} + +- [**Official LAGO sites**](#lago) + <ul id="iproperties"></ul> +- [**non-LAGO sites**](#non-lago) + <ul id="iclasses"></ul> + + +### Official LAGO sites + +<div id="properties"></div> + + +### non-LAGO sites + +<div id="classes"></div> + + +{% endif %} + diff --git a/1.1/_includes/generate_html_for_vocab.html b/1.1/_includes/generate_html_for_vocab.html new file mode 100644 index 0000000000000000000000000000000000000000..9caa0b3aa897f593d8f213e22cad49109dfe53e7 --- /dev/null +++ b/1.1/_includes/generate_html_for_vocab.html @@ -0,0 +1,128 @@ +<!-- +################################################################################ +# Original Author: A.J. Rubio-Montero (http://orcid.org/0000-0001-6497-753X), # +# CIEMAT - Sci-Track Group (http://rdgroups.ciemat.es/web/sci-track), # +# for the EOSC-Synergy project (EU H2020 RI Grant No 857647). # +# License (SPDX): BSD-3-Clause (https://opensource.org/licenses/BSD-3-Clause) # +# Copyright (c): 2020-today, The LAGO Collaboration (http://lagoproject.net) # +################################################################################ +--> +<script src="https://code.jquery.com/jquery-3.2.1.min.js"></script> +<script> +function itemnize_json( json, context, link ) { + var html =''; + if ( (link == false) || (typeof(json) === 'boolean') ) return json; + if ( typeof(json) === 'string' ) { + var element = json.split(':'); + var innid = element[0]; + var vocab = "@vocab"; + if (element.length == 2) { + if ( (element[0] !== "http") && (element[0] !== "https") ) { + innid = element[1]; + vocab = element[0]; + } else return '<a href="'+ json +'">'+ json +'</a>'; + } else return json; + var contexturl = context[vocab]; + if ( vocab == "lago" ) { + contexturl = 'https://lagoproject.github.io/DMP/schema/lagoSchema/'; + innid = json; + }; + if ( contexturl[contexturl.length-1] !== '#' ) contexturl = contexturl + '#'; + if ( vocab == "sdo" ) contexturl = context[vocab]; + html = '<a href="'+ contexturl + innid +'">'+ json +'</a>'; + } else { + if ( !(Array.isArray(json)) ) { + var json_aux = []; + json_aux.push(json); + json = json_aux; + }; + for (var j=0; j<json.length; j++) { + var inner_json = json[j]; + if ( !(typeof(json[j]) === 'string') ) { + if ("@id" in json[j]) { + inner_json = json[j]["@id"]; + } else { + inner_json = JSON.stringify(json[j]); + link = false; + }; + }; + html = html + '<br />' + itemnize_json(inner_json, context, link); + }; + }; + return html; +}; +$().ready(function(){ + $.getJSON( "{{ include.folder }}", function( data ) { + var graphelements = data["@graph"]; + for (var i=0; i<graphelements.length; i++) { + if ("@id" in graphelements[i]) { + var id = graphelements[i]["@id"]; + var indexhtml = '<li><a href="#'+id+'">'+id+'</a></li>'; + var headerhtml = '<h5 id="'+id+'"><a href="#'+id+'" class="anchor-heading" aria-labelledby="'+id+'"><svg viewBox="0 0 16 16" aria-hidden="true"><use xlink:href="#svg-link"></use></svg></a><strong>'+id+'</strong></h5>'; + if ("comment" in graphelements[i]) { + headerhtml = headerhtml + '<p><small>'+ graphelements[i]["comment"][0]["@value"]+'</small></p>'; + }; + var keys = Object.keys(graphelements[i]); + keys.splice(keys.indexOf("@id"),1); + keys.splice(keys.indexOf("@type"),1); + keys.splice(keys.indexOf("comment"),1); + var table = '<table class="grid" style="width: 100%"> + <thead> + <tr class="header"> + <th>@type</th>'; + for (var k=0; k<keys.length; k++) { + table = table + ' <th>'+ itemnize_json(keys[k] , data["@context"], true ) + '</th>'; + }; + table = table +' </tr> + </thead> + <tbody> + <tr> + <td>'+ itemnize_json(graphelements[i]["@type"] , data["@context"], true ) +'</td>'; + for (var k=0; k<keys.length; k++) { + table = table + ' <td>'+ itemnize_json(graphelements[i][keys[k]] , data["@context"], true ) +'</td>'; + }; + table = table +' </tr> + </tbody> + </table>'; + if ("dcat:domain" in graphelements[i]) { + $('#iproperties').append(indexhtml); + $('#properties').append(headerhtml); + $('#properties').append(table); + } else { + $('#iclasses').append(indexhtml); + $('#classes').append(headerhtml); + $('#classes').append(table); + }; + }; + }; + }); +}); +</script> + +{% if include.vocabulary == "true" %} + +- [**Classes**](#classes) + <ul id="iclasses"></ul> + +- [**Properties**](#properties) + <ul id="iproperties"></ul> + +### Classes + +<div id="classes"></div> + +### Properties + +<div id="properties"></div> + +{% else %} + +- [**Items**](#items) + <ul id="iclasses"></ul> + +### Items + +<div id="classes"></div> + +{% endif %} + diff --git a/1.1/_includes/head_custom.html b/1.1/_includes/head_custom.html new file mode 100644 index 0000000000000000000000000000000000000000..a19750d28deb880125c16c0c283959aae635e6d0 --- /dev/null +++ b/1.1/_includes/head_custom.html @@ -0,0 +1,5 @@ +{% if page.jsonldinhead %} + <script type="application/ld+json"> + {% include_relative {{page.jsonldinhead}} %} + </script> +{% endif %} \ No newline at end of file diff --git a/1.1/defs/index.md b/1.1/defs/index.md new file mode 100644 index 0000000000000000000000000000000000000000..a5ccece0f229d14b9dc48e9c326a43f062c90810 --- /dev/null +++ b/1.1/defs/index.md @@ -0,0 +1,11 @@ +--- +layout: default +title: Definitions +has_children: true +permalink: /defs/ +nav_order: 4 +--- + +# Established definitions + +This section fixes the definition of certain LAGO actors following the [metadata schema](/schema/lagoSchema). The objective is to allow linking metadata with public URIs. diff --git a/1.1/defs/lagoCollaboration.jsonld b/1.1/defs/lagoCollaboration.jsonld new file mode 100644 index 0000000000000000000000000000000000000000..6673a5dfdcf526de9215d0f6527fa54f2d869c22 --- /dev/null +++ b/1.1/defs/lagoCollaboration.jsonld @@ -0,0 +1,3 @@ +{ + "TBD" : "TBD." +} diff --git a/1.1/defs/lagoCollaboration.md b/1.1/defs/lagoCollaboration.md new file mode 100644 index 0000000000000000000000000000000000000000..07397c5834c0f20ef2bc5339fd6f80af3e05a0fd --- /dev/null +++ b/1.1/defs/lagoCollaboration.md @@ -0,0 +1,65 @@ +--- +layout: default +parent: Definitions +nav_order: 2 +--- + +# LAGO Collaboration +{: .no_toc } + +|Version| Updated | Date |Contributors| +|-------|---------|------|------------| +| 1.1 develop | {{ site.time }} | 2020-06-01 - today | LAGO Collaboration | + + +## Table of contents +{: .no_toc .text-delta } + +- TOC +{:toc} + +## What is defined? + +[lagoCollaboration.jsonld](./lagoCollaboration.jsonld) unifies the definition of the LAGO Collaboration following the official LAGO schema vocabulary. + +The purpose of the definition is to univocally identify the LAGO Collaboration employing a public URI for being linked by any metadata. + +## How should an item be referenced? + +To preserve the provenance of the linked metadata through time, the GitHub raw link of a certain release of this document must be used: + +`https://raw.githubusercontent.com/lagoproject/DMP/`*\<tag release\>*`/defs/lagoCollaboration.jsonld` + +For example: + +[https://raw.githubusercontent.com/lagoproject/DMP/1.1/defs/lagoCollaboration.jsonld](https://raw.githubusercontent.com/lagoproject/DMP/1.1/defs/lagoCollaboration.jsonld) + + +As a real example, the metadata´s catalog of a simulation should include the reference to the [DCAT-AP2](https://joinup.ec.europa.eu/collection/semantic-interoperability-community-semic/solution/dcat-application-profile-data-portals-europe) property [publisher](https://raw.githubusercontent.com/SEMICeu/DCAT-AP/2.0.0/releases/2.0.0/dcat-ap_2.0.0.jsonld#publisher): + +```json +{ +"@context":{ +... + "lago":"https://raw.githubusercontent.com/lagoproject/DMP/1.1/schema/lagoSchema.jsonld", + "@vocab":"https://raw.githubusercontent.com/SEMICeu/DCAT-AP/2.0.0/releases/2.0.0/dcat-ap_2.0.0.jsonld", +... + }, +"@id":"/sac_60_100.0_75600_QGSII_flat", +"@type":"Catalog", +"title":"sac_60_100.0_75600_QGSII_flat", +"description":"A Complete Corsika Simulation", +"publisher":{ + "@id":"https://raw.githubusercontent.com/lagoproject/DMP/1.1/defs/lagoCollaboration.jsonld", + "@type":"lago:Organization" + }, +... +... +``` + +## Plain JSON-LD file + +```json +{% include_relative lagoCollaboration.jsonld %} +``` + diff --git a/1.1/defs/sitesLago.jsonld b/1.1/defs/sitesLago.jsonld new file mode 100644 index 0000000000000000000000000000000000000000..651ce6e371522ab280c346145db22ff22802db68 --- /dev/null +++ b/1.1/defs/sitesLago.jsonld @@ -0,0 +1,2253 @@ +{ + "@context": { + "dct": "http://purl.org/dc/terms/", + "geo": "http://www.w3.org/2003/01/geo/wgs84_pos#", + "lago": "https://raw.githubusercontent.com/lagoproject/DMP/1.1/schema/lagoSchema.jsonld", + "@base": "https://raw.githubusercontent.com/lagoproject/DMP/1.1/defs/sitesLago.jsonld#", + "@vocab": "https://raw.githubusercontent.com/SEMICeu/DCAT-AP/2.0.0/releases/2.0.0/dcat-ap_2.0.0.jsonld", + "_dcatap": "https://raw.githubusercontent.com/SEMICeu/DCAT-AP/2.0.0/releases/2.0.0/dcat-ap_2.0.0.jsonld", + "_dcatap_landing_page": "http://data.europa.eu/r5r/" + }, + "@graph": [ + { + "@id": "and", + "@type": "lago:DetectorSite", + "name": "Andes, Argentina", + "lago:belongsLago": false, + "qualifiedAttribution": { + "@type": "lago:Organisation", + "name": "" + }, + "geometry": { + "@id": "and#geometry", + "@type": "geo:Point", + "geo:latitude": "-30.19", + "geo:longitude": "-69.82", + "geo:altitude": "4200" + }, + "lago:obsLev": { + "@default": "420000" + }, + "lago:atmcrd": { + "@type": { + "@default": "lago:Atmod" + }, + "lago:modatm": { + "@default": "E2" + } + }, + "lago:magnet": { + "@default": { + "lago:bDate": "2021-04-08", + "conformsTo": { + "@id": "https://doi.org/10.1186/s40623-020-01288-x", + "@type": [ + "dct:Standard", + "DataSet" + ], + "title": "IGRF", + "description": "International Geomagnetic Reference Field", + "landingpage": "https://www.ngdc.noaa.gov/IAGA/vmod/igrf.html", + "version": "13", + "dataservice": { + "title": "Geomagnetic Model Web Service", + "endpointURL": "http://geomag.bgs.ac.uk/web_service/GMModels/" + }, + "temporalCoverage": { + "startDate": "2020-01-01", + "endDate": "2024-12-31" + }, + "temporalResolution": "P1D" + }, + "lago:bx": "19.658", + "lago:bz": "-11.951", + "lago:bi": "23.011" + } + } + }, + { + "@id": "asu", + "@type": "lago:DetectorSite", + "name": "Asuncion-Paraguay, Paraguay", + "lago:belongsLago": true, + "qualifiedAttribution": { + "@type": "lago:Organisation", + "name": "UNA" + }, + "geometry": { + "@id": "asu#geometry", + "@type": "geo:Point", + "geo:latitude": "-25.19", + "geo:longitude": "-57.3", + "geo:altitude": "136" + }, + "lago:obsLev": { + "@default": "13600" + }, + "lago:atmcrd": { + "@type": { + "@default": "lago:Atmod" + }, + "lago:modatm": { + "@default": "E1" + } + }, + "lago:magnet": { + "@default": { + "lago:bDate": "2021-04-08", + "conformsTo": { + "@id": "https://doi.org/10.1186/s40623-020-01288-x", + "@type": [ + "dct:Standard", + "DataSet" + ], + "title": "IGRF", + "description": "International Geomagnetic Reference Field", + "landingpage": "https://www.ngdc.noaa.gov/IAGA/vmod/igrf.html", + "version": "13", + "dataservice": { + "title": "Geomagnetic Model Web Service", + "endpointURL": "http://geomag.bgs.ac.uk/web_service/GMModels/" + }, + "temporalCoverage": { + "startDate": "2020-01-01", + "endDate": "2024-12-31" + }, + "temporalResolution": "P1D" + }, + "lago:bx": "18.233", + "lago:bz": "-11.73", + "lago:bi": "22.22" + } + } + }, + { + "@id": "ata", + "@type": "lago:DetectorSite", + "name": "Atacama, Chile", + "lago:belongsLago": true, + "qualifiedAttribution": { + "@type": "lago:Organisation", + "name": "UVAL" + }, + "geometry": { + "@id": "ata#geometry", + "@type": "geo:Point", + "geo:latitude": "-23.005778", + "geo:longitude": "-67.759167", + "geo:altitude": "5105" + }, + "lago:obsLev": { + "@default": "510500" + }, + "lago:atmcrd": { + "@type": { + "@default": "lago:Atmod" + }, + "lago:modatm": { + "@default": "E1" + } + }, + "lago:magnet": { + "@default": { + "lago:bDate": "2021-10-28", + "conformsTo": { + "@id": "https://doi.org/10.1186/s40623-020-01288-x", + "@type": [ + "dct:Standard", + "DataSet" + ], + "title": "IGRF", + "description": "International Geomagnetic Reference Field", + "landingpage": "https://www.ngdc.noaa.gov/IAGA/vmod/igrf.html", + "version": "13", + "dataservice": { + "title": "Geomagnetic Model Web Service", + "endpointURL": "http://geomag.bgs.ac.uk/web_service/GMModels/" + }, + "temporalCoverage": { + "startDate": "2020-01-01", + "endDate": "2024-12-31" + }, + "temporalResolution": "P1D" + }, + "lago:bx": "20.638", + "lago:bz": "-8.598", + "lago:bi": "22.5" + } + } + }, + { + "@id": "ber", + "@type": "lago:DetectorSite", + "name": "Berlin, Colombia", + "lago:belongsLago": true, + "qualifiedAttribution": { + "@type": "lago:Organisation", + "name": "UIS" + }, + "geometry": { + "@id": "ber#geometry", + "@type": "geo:Point", + "geo:latitude": "7.19", + "geo:longitude": "-72.88", + "geo:altitude": "3450" + }, + "lago:obsLev": { + "@default": "345000" + }, + "lago:atmcrd": { + "@type": { + "@default": "lago:Atmod" + }, + "lago:modatm": { + "@default": "E1" + } + }, + "lago:magnet": { + "@default": { + "lago:bDate": "2021-04-08", + "conformsTo": { + "@id": "https://doi.org/10.1186/s40623-020-01288-x", + "@type": [ + "dct:Standard", + "DataSet" + ], + "title": "IGRF", + "description": "International Geomagnetic Reference Field", + "landingpage": "https://www.ngdc.noaa.gov/IAGA/vmod/igrf.html", + "version": "13", + "dataservice": { + "title": "Geomagnetic Model Web Service", + "endpointURL": "http://geomag.bgs.ac.uk/web_service/GMModels/" + }, + "temporalCoverage": { + "startDate": "2020-01-01", + "endDate": "2024-12-31" + }, + "temporalResolution": "P1D" + }, + "lago:bx": "26.751", + "lago:bz": "16.029", + "lago:bi": "31.467" + } + } + }, + { + "@id": "bga", + "@type": "lago:DetectorSite", + "name": "Bucaramanga, Colombia", + "lago:belongsLago": true, + "qualifiedAttribution": { + "@type": "lago:Organisation", + "name": "UIS" + }, + "geometry": { + "@id": "bga#geometry", + "@type": "geo:Point", + "geo:latitude": "7.14", + "geo:longitude": "-73.12", + "geo:altitude": "956" + }, + "lago:obsLev": { + "@default": "95000" + }, + "lago:atmcrd": { + "@type": { + "@default": "lago:Atmod" + }, + "lago:modatm": { + "@default": "E1" + } + }, + "lago:magnet": { + "@default": { + "lago:bDate": "2021-04-08", + "conformsTo": { + "@id": "https://doi.org/10.1186/s40623-020-01288-x", + "@type": [ + "dct:Standard", + "DataSet" + ], + "title": "IGRF", + "description": "International Geomagnetic Reference Field", + "landingpage": "https://www.ngdc.noaa.gov/IAGA/vmod/igrf.html", + "version": "13", + "dataservice": { + "title": "Geomagnetic Model Web Service", + "endpointURL": "http://geomag.bgs.ac.uk/web_service/GMModels/" + }, + "temporalCoverage": { + "startDate": "2020-01-01", + "endDate": "2024-12-31" + }, + "temporalResolution": "P1D" + }, + "lago:bx": "26.793", + "lago:bz": "16.055", + "lago:bi": "31.506" + } + } + }, + { + "@id": "brc", + "@type": "lago:DetectorSite", + "name": "Bariloche, Argentina", + "lago:belongsLago": true, + "qualifiedAttribution": { + "@type": "lago:Organisation", + "name": "CNEA" + }, + "geometry": { + "@id": "brc#geometry", + "@type": "geo:Point", + "geo:latitude": "-41.15", + "geo:longitude": "-71.3", + "geo:altitude": "850" + }, + "lago:obsLev": { + "@default": "86500" + }, + "lago:atmcrd": { + "@type": { + "@default": "lago:Atmod" + }, + "lago:modatm": { + "@default": "E3" + } + }, + "lago:magnet": { + "@default": { + "lago:bDate": "2021-04-08", + "conformsTo": { + "@id": "https://doi.org/10.1186/s40623-020-01288-x", + "@type": [ + "dct:Standard", + "DataSet" + ], + "title": "IGRF", + "description": "International Geomagnetic Reference Field", + "landingpage": "https://www.ngdc.noaa.gov/IAGA/vmod/igrf.html", + "version": "13", + "dataservice": { + "title": "Geomagnetic Model Web Service", + "endpointURL": "http://geomag.bgs.ac.uk/web_service/GMModels/" + }, + "temporalCoverage": { + "startDate": "2020-01-01", + "endDate": "2024-12-31" + }, + "temporalResolution": "P1D" + }, + "lago:bx": "18.952", + "lago:bz": "-17.05", + "lago:bi": "25.58" + } + } + }, + { + "@id": "bue", + "@type": "lago:DetectorSite", + "name": "Buenos Aires, Argentina", + "lago:belongsLago": true, + "qualifiedAttribution": { + "@type": "lago:Organisation", + "name": "IAFE" + }, + "geometry": { + "@id": "bue#geometry", + "@type": "geo:Point", + "geo:latitude": "-34.54", + "geo:longitude": "-58.44", + "geo:altitude": "10" + }, + "lago:obsLev": { + "@default": "1000" + }, + "lago:atmcrd": { + "@type": { + "@default": "lago:Atmod" + }, + "lago:modatm": { + "@default": "E2" + } + }, + "lago:magnet": { + "@default": { + "lago:bDate": "2021-04-08", + "conformsTo": { + "@id": "https://doi.org/10.1186/s40623-020-01288-x", + "@type": [ + "dct:Standard", + "DataSet" + ], + "title": "IGRF", + "description": "International Geomagnetic Reference Field", + "landingpage": "https://www.ngdc.noaa.gov/IAGA/vmod/igrf.html", + "version": "13", + "dataservice": { + "title": "Geomagnetic Model Web Service", + "endpointURL": "http://geomag.bgs.ac.uk/web_service/GMModels/" + }, + "temporalCoverage": { + "startDate": "2020-01-01", + "endDate": "2024-12-31" + }, + "temporalResolution": "P1D" + }, + "lago:bx": "17.09", + "lago:bz": "-14.673", + "lago:bi": "22.705" + } + } + }, + { + "@id": "casp", + "@type": "lago:DetectorSite", + "name": "Casposo, Argentina", + "lago:belongsLago": false, + "qualifiedAttribution": { + "@type": "lago:Organisation", + "name": "" + }, + "geometry": { + "@id": "casp#geometry", + "@type": "geo:Point", + "geo:latitude": "-31.22", + "geo:longitude": "-69.63", + "geo:altitude": "2600" + }, + "lago:obsLev": { + "@default": "260000" + }, + "lago:atmcrd": { + "@type": { + "@default": "lago:Atmod" + }, + "lago:modatm": { + "@default": "E2" + } + }, + "lago:magnet": { + "@default": { + "lago:bDate": "2021-05-18", + "conformsTo": { + "@id": "https://doi.org/10.1186/s40623-020-01288-x", + "@type": [ + "dct:Standard", + "DataSet" + ], + "title": "IGRF", + "description": "International Geomagnetic Reference Field", + "landingpage": "https://www.ngdc.noaa.gov/IAGA/vmod/igrf.html", + "version": "13", + "dataservice": { + "title": "Geomagnetic Model Web Service", + "endpointURL": "http://geomag.bgs.ac.uk/web_service/GMModels/" + }, + "temporalCoverage": { + "startDate": "2020-01-01", + "endDate": "2024-12-31" + }, + "temporalResolution": "P1D" + }, + "lago:bx": "19.473", + "lago:bz": "-12.436", + "lago:bi": "23.109" + } + } + }, + { + "@id": "cha", + "@type": "lago:DetectorSite", + "name": "Chacaltaya, Bolivia", + "lago:belongsLago": true, + "qualifiedAttribution": { + "@type": "lago:Organisation", + "name": "UMSA" + }, + "geometry": { + "@id": "cha#geometry", + "@type": "geo:Point", + "geo:latitude": "-16.35", + "geo:longitude": "-68.13", + "geo:altitude": "5230" + }, + "lago:obsLev": { + "@default": "523000" + }, + "lago:atmcrd": { + "@type": { + "@default": "lago:Atmod" + }, + "lago:modatm": { + "@default": "E2" + } + }, + "lago:magnet": { + "@default": { + "lago:bDate": "2021-04-08", + "conformsTo": { + "@id": "https://doi.org/10.1186/s40623-020-01288-x", + "@type": [ + "dct:Standard", + "DataSet" + ], + "title": "IGRF", + "description": "International Geomagnetic Reference Field", + "landingpage": "https://www.ngdc.noaa.gov/IAGA/vmod/igrf.html", + "version": "13", + "dataservice": { + "title": "Geomagnetic Model Web Service", + "endpointURL": "http://geomag.bgs.ac.uk/web_service/GMModels/" + }, + "temporalCoverage": { + "startDate": "2020-01-01", + "endDate": "2024-12-31" + }, + "temporalResolution": "P1D" + }, + "lago:bx": "22.38", + "lago:bz": "-4.62", + "lago:bi": "23.112" + } + } + }, + { + "@id": "chi", + "@type": "lago:DetectorSite", + "name": "Chimborazo, Ecuador", + "lago:belongsLago": true, + "qualifiedAttribution": { + "@type": "lago:Organisation", + "name": "EPOCH" + }, + "geometry": { + "@id": "chi#geometry", + "@type": "geo:Point", + "geo:latitude": "-1.47", + "geo:longitude": "-78.82", + "geo:altitude": "5000" + }, + "lago:obsLev": { + "@default": "500000" + }, + "lago:atmcrd": { + "@type": { + "@default": "lago:Atmod" + }, + "lago:modatm": { + "@default": "E1" + } + }, + "lago:magnet": { + "@default": { + "lago:bDate": "2021-10-28", + "conformsTo": { + "@id": "https://doi.org/10.1186/s40623-020-01288-x", + "@type": [ + "dct:Standard", + "DataSet" + ], + "title": "IGRF", + "description": "International Geomagnetic Reference Field", + "landingpage": "https://www.ngdc.noaa.gov/IAGA/vmod/igrf.html", + "version": "13", + "dataservice": { + "title": "Geomagnetic Model Web Service", + "endpointURL": "http://geomag.bgs.ac.uk/web_service/GMModels/" + }, + "temporalCoverage": { + "startDate": "2020-01-01", + "endDate": "2024-12-31" + }, + "temporalResolution": "P1D" + }, + "lago:bx": "26.56", + "lago:bz": "8.758", + "lago:bi": "28.019" + } + } + }, + { + "@id": "chia", + "@type": "lago:DetectorSite", + "name": "Chiapas, Mexico", + "lago:belongsLago": true, + "qualifiedAttribution": { + "@type": "lago:Organisation", + "name": "UNACH" + }, + "geometry": { + "@id": "chia#geometry", + "@type": "geo:Point", + "geo:latitude": "16.75", + "geo:longitude": "-93.12", + "geo:altitude": "522" + }, + "lago:obsLev": { + "@default": "52200" + }, + "lago:atmcrd": { + "@type": { + "@default": "lago:Atmod" + }, + "lago:modatm": { + "@default": "E2" + } + }, + "lago:magnet": { + "@default": { + "lago:bDate": "2021-04-08", + "conformsTo": { + "@id": "https://doi.org/10.1186/s40623-020-01288-x", + "@type": [ + "dct:Standard", + "DataSet" + ], + "title": "IGRF", + "description": "International Geomagnetic Reference Field", + "landingpage": "https://www.ngdc.noaa.gov/IAGA/vmod/igrf.html", + "version": "13", + "dataservice": { + "title": "Geomagnetic Model Web Service", + "endpointURL": "http://geomag.bgs.ac.uk/web_service/GMModels/" + }, + "temporalCoverage": { + "startDate": "2020-01-01", + "endDate": "2024-12-31" + }, + "temporalResolution": "P1D" + }, + "lago:bx": "27.405", + "lago:bz": "27.024", + "lago:bi": "38.497" + } + } + }, + { + "@id": "cop", + "@type": "lago:DetectorSite", + "name": "Copahue, Argentina", + "lago:belongsLago": false, + "qualifiedAttribution": { + "@type": "lago:Organisation", + "name": "" + }, + "geometry": { + "@id": "cop#geometry", + "@type": "geo:Point", + "geo:latitude": "-37.85", + "geo:longitude": "-71.17", + "geo:altitude": "2000" + }, + "lago:obsLev": { + "@default": "200000" + }, + "lago:atmcrd": { + "@type": { + "@default": "lago:Atmod" + }, + "lago:modatm": { + "@default": "E2" + } + }, + "lago:magnet": { + "@default": { + "lago:bDate": "2021-05-18", + "conformsTo": { + "@id": "https://doi.org/10.1186/s40623-020-01288-x", + "@type": [ + "dct:Standard", + "DataSet" + ], + "title": "IGRF", + "description": "International Geomagnetic Reference Field", + "landingpage": "https://www.ngdc.noaa.gov/IAGA/vmod/igrf.html", + "version": "13", + "dataservice": { + "title": "Geomagnetic Model Web Service", + "endpointURL": "http://geomag.bgs.ac.uk/web_service/GMModels/" + }, + "temporalCoverage": { + "startDate": "2020-01-01", + "endDate": "2024-12-31" + }, + "temporalResolution": "P1D" + }, + "lago:bx": "19.04", + "lago:bz": "-15.493", + "lago:bi": "24.586" + } + } + }, + { + "@id": "cpv", + "@type": "lago:DetectorSite", + "name": "Campina Grande, Brazil", + "lago:belongsLago": true, + "qualifiedAttribution": { + "@type": "lago:Organisation", + "name": "UFCG" + }, + "geometry": { + "@id": "cpv#geometry", + "@type": "geo:Point", + "geo:latitude": "-7.23", + "geo:longitude": "-35.88", + "geo:altitude": "550" + }, + "lago:obsLev": { + "@default": "55000" + }, + "lago:atmcrd": { + "@type": { + "@default": "lago:Atmod" + }, + "lago:modatm": { + "@default": "E1" + } + }, + "lago:magnet": { + "@default": { + "lago:bDate": "2021-04-08", + "conformsTo": { + "@id": "https://doi.org/10.1186/s40623-020-01288-x", + "@type": [ + "dct:Standard", + "DataSet" + ], + "title": "IGRF", + "description": "International Geomagnetic Reference Field", + "landingpage": "https://www.ngdc.noaa.gov/IAGA/vmod/igrf.html", + "version": "13", + "dataservice": { + "title": "Geomagnetic Model Web Service", + "endpointURL": "http://geomag.bgs.ac.uk/web_service/GMModels/" + }, + "temporalCoverage": { + "startDate": "2020-01-01", + "endDate": "2024-12-31" + }, + "temporalResolution": "P1D" + }, + "lago:bx": "21.174", + "lago:bz": "-12.612", + "lago:bi": "26.025" + } + } + }, + { + "@id": "cuz", + "@type": "lago:DetectorSite", + "name": "Cusco, Peru", + "lago:belongsLago": true, + "qualifiedAttribution": { + "@type": "lago:Organisation", + "name": "CONIDA" + }, + "geometry": { + "@id": "cuz#geometry", + "@type": "geo:Point", + "geo:latitude": "-13.52", + "geo:longitude": "-71.96", + "geo:altitude": "3400" + }, + "lago:obsLev": { + "@default": "340000" + }, + "lago:atmcrd": { + "@type": { + "@default": "lago:Atmod" + }, + "lago:modatm": { + "@default": "E1" + } + }, + "lago:magnet": { + "@default": { + "lago:bDate": "2021-04-08", + "conformsTo": { + "@id": "https://doi.org/10.1186/s40623-020-01288-x", + "@type": [ + "dct:Standard", + "DataSet" + ], + "title": "IGRF", + "description": "International Geomagnetic Reference Field", + "landingpage": "https://www.ngdc.noaa.gov/IAGA/vmod/igrf.html", + "version": "13", + "dataservice": { + "title": "Geomagnetic Model Web Service", + "endpointURL": "http://geomag.bgs.ac.uk/web_service/GMModels/" + }, + "temporalCoverage": { + "startDate": "2020-01-01", + "endDate": "2024-12-31" + }, + "temporalResolution": "P1D" + }, + "lago:bx": "23.676", + "lago:bz": "-2.02", + "lago:bi": "23.905" + } + } + }, + { + "@id": "gua", + "@type": "lago:DetectorSite", + "name": "Guatemala, Guatemala", + "lago:belongsLago": true, + "qualifiedAttribution": { + "@type": "lago:Organisation", + "name": "UVG" + }, + "geometry": { + "@id": "gua#geometry", + "@type": "geo:Point", + "geo:latitude": "14.63", + "geo:longitude": "-90.59", + "geo:altitude": "1490" + }, + "lago:obsLev": { + "@default": "149000" + }, + "lago:atmcrd": { + "@type": { + "@default": "lago:Atmod" + }, + "lago:modatm": { + "@default": "E1" + } + }, + "lago:magnet": { + "@default": { + "lago:bDate": "2021-04-08", + "conformsTo": { + "@id": "https://doi.org/10.1186/s40623-020-01288-x", + "@type": [ + "dct:Standard", + "DataSet" + ], + "title": "IGRF", + "description": "International Geomagnetic Reference Field", + "landingpage": "https://www.ngdc.noaa.gov/IAGA/vmod/igrf.html", + "version": "13", + "dataservice": { + "title": "Geomagnetic Model Web Service", + "endpointURL": "http://geomag.bgs.ac.uk/web_service/GMModels/" + }, + "temporalCoverage": { + "startDate": "2020-01-01", + "endDate": "2024-12-31" + }, + "temporalResolution": "P1D" + }, + "lago:bx": "27.532", + "lago:bz": "24.932", + "lago:bi": "37.145" + } + } + }, + { + "@id": "ima", + "@type": "lago:DetectorSite", + "name": "Imata, Peru", + "lago:belongsLago": true, + "qualifiedAttribution": { + "@type": "lago:Organisation", + "name": "CONIDA" + }, + "geometry": { + "@id": "ima#geometry", + "@type": "geo:Point", + "geo:latitude": "-15.841", + "geo:longitude": "-71.091", + "geo:altitude": "4600" + }, + "lago:obsLev": { + "@default": "460000" + }, + "lago:atmcrd": { + "@type": { + "@default": "lago:Atmod" + }, + "lago:modatm": { + "@default": "E1" + } + }, + "lago:magnet": { + "@default": { + "lago:bDate": "2021-05-23", + "conformsTo": { + "@id": "https://doi.org/10.1186/s40623-020-01288-x", + "@type": [ + "dct:Standard", + "DataSet" + ], + "title": "IGRF", + "description": "International Geomagnetic Reference Field", + "landingpage": "https://www.ngdc.noaa.gov/IAGA/vmod/igrf.html", + "version": "13", + "dataservice": { + "title": "Geomagnetic Model Web Service", + "endpointURL": "http://geomag.bgs.ac.uk/web_service/GMModels/" + }, + "temporalCoverage": { + "startDate": "2020-01-01", + "endDate": "2024-12-31" + }, + "temporalResolution": "P1D" + }, + "lago:bx": "22.969", + "lago:bz": "-3.79", + "lago:bi": "23.422" + } + } + }, + { + "@id": "jsc", + "@type": "lago:DetectorSite", + "name": "J\u00fclich, Germany", + "lago:belongsLago": false, + "qualifiedAttribution": { + "@type": "lago:Organisation", + "name": "" + }, + "geometry": { + "@id": "jsc#geometry", + "@type": "geo:Point", + "geo:latitude": "50.92", + "geo:longitude": "6.54", + "geo:altitude": "100" + }, + "lago:obsLev": { + "@default": "10000" + }, + "lago:atmcrd": { + "@type": { + "@default": "lago:Atmod" + }, + "lago:modatm": { + "@default": "E2" + } + }, + "lago:magnet": { + "@default": { + "lago:bDate": "2021-05-18", + "conformsTo": { + "@id": "https://doi.org/10.1186/s40623-020-01288-x", + "@type": [ + "dct:Standard", + "DataSet" + ], + "title": "IGRF", + "description": "International Geomagnetic Reference Field", + "landingpage": "https://www.ngdc.noaa.gov/IAGA/vmod/igrf.html", + "version": "13", + "dataservice": { + "title": "Geomagnetic Model Web Service", + "endpointURL": "http://geomag.bgs.ac.uk/web_service/GMModels/" + }, + "temporalCoverage": { + "startDate": "2020-01-01", + "endDate": "2024-12-31" + }, + "temporalResolution": "P1D" + }, + "lago:bx": "19.676", + "lago:bz": "44.928", + "lago:bi": "49.055" + } + } + }, + { + "@id": "kna", + "@type": "lago:DetectorSite", + "name": "Vina Del Mar, Chile", + "lago:belongsLago": true, + "qualifiedAttribution": { + "@type": "lago:Organisation", + "name": "UVM" + }, + "geometry": { + "@id": "kna#geometry", + "@type": "geo:Point", + "geo:latitude": "-33.07", + "geo:longitude": "-71.55", + "geo:altitude": "347" + }, + "lago:obsLev": { + "@default": "34700" + }, + "lago:atmcrd": { + "@type": { + "@default": "lago:Atmod" + }, + "lago:modatm": { + "@default": "E2" + } + }, + "lago:magnet": { + "@default": { + "lago:bDate": "2021-04-08", + "conformsTo": { + "@id": "https://doi.org/10.1186/s40623-020-01288-x", + "@type": [ + "dct:Standard", + "DataSet" + ], + "title": "IGRF", + "description": "International Geomagnetic Reference Field", + "landingpage": "https://www.ngdc.noaa.gov/IAGA/vmod/igrf.html", + "version": "13", + "dataservice": { + "title": "Geomagnetic Model Web Service", + "endpointURL": "http://geomag.bgs.ac.uk/web_service/GMModels/" + }, + "temporalCoverage": { + "startDate": "2020-01-01", + "endDate": "2024-12-31" + }, + "temporalResolution": "P1D" + }, + "lago:bx": "19.56", + "lago:bz": "-13.333", + "lago:bi": "23.679" + } + } + }, + { + "@id": "lim", + "@type": "lago:DetectorSite", + "name": "Lima, Peru", + "lago:belongsLago": true, + "qualifiedAttribution": { + "@type": "lago:Organisation", + "name": "CONIDA" + }, + "geometry": { + "@id": "lim#geometry", + "@type": "geo:Point", + "geo:latitude": "-12.1", + "geo:longitude": "-77.02", + "geo:altitude": "150" + }, + "lago:obsLev": { + "@default": "16800" + }, + "lago:atmcrd": { + "@type": { + "@default": "lago:Atmod" + }, + "lago:modatm": { + "@default": "E1" + } + }, + "lago:magnet": { + "@default": { + "lago:bDate": "2021-04-08", + "conformsTo": { + "@id": "https://doi.org/10.1186/s40623-020-01288-x", + "@type": [ + "dct:Standard", + "DataSet" + ], + "title": "IGRF", + "description": "International Geomagnetic Reference Field", + "landingpage": "https://www.ngdc.noaa.gov/IAGA/vmod/igrf.html", + "version": "13", + "dataservice": { + "title": "Geomagnetic Model Web Service", + "endpointURL": "http://geomag.bgs.ac.uk/web_service/GMModels/" + }, + "temporalCoverage": { + "startDate": "2020-01-01", + "endDate": "2024-12-31" + }, + "temporalResolution": "P1D" + }, + "lago:bx": "24.723", + "lago:bz": "-0.476", + "lago:bi": "24.751" + } + } + }, + { + "@id": "lpb", + "@type": "lago:DetectorSite", + "name": "La Paz, Bolivia", + "lago:belongsLago": true, + "qualifiedAttribution": { + "@type": "lago:Organisation", + "name": "UMSA" + }, + "geometry": { + "@id": "lpb#geometry", + "@type": "geo:Point", + "geo:latitude": "-16.49", + "geo:longitude": "-68.15", + "geo:altitude": "3630" + }, + "lago:obsLev": { + "@default": "363000" + }, + "lago:atmcrd": { + "@type": { + "@default": "lago:Atmod" + }, + "lago:modatm": { + "@default": "E2" + } + }, + "lago:magnet": { + "@default": { + "lago:bDate": "2021-04-08", + "conformsTo": { + "@id": "https://doi.org/10.1186/s40623-020-01288-x", + "@type": [ + "dct:Standard", + "DataSet" + ], + "title": "IGRF", + "description": "International Geomagnetic Reference Field", + "landingpage": "https://www.ngdc.noaa.gov/IAGA/vmod/igrf.html", + "version": "13", + "dataservice": { + "title": "Geomagnetic Model Web Service", + "endpointURL": "http://geomag.bgs.ac.uk/web_service/GMModels/" + }, + "temporalCoverage": { + "startDate": "2020-01-01", + "endDate": "2024-12-31" + }, + "temporalResolution": "P1D" + }, + "lago:bx": "22.362", + "lago:bz": "-4.708", + "lago:bi": "23.109" + } + } + }, + { + "@id": "lsc", + "@type": "lago:DetectorSite", + "name": "La Serena, Chile", + "lago:belongsLago": true, + "qualifiedAttribution": { + "@type": "lago:Organisation", + "name": "USERENA" + }, + "geometry": { + "@id": "lsc#geometry", + "@type": "geo:Point", + "geo:latitude": "-29.9", + "geo:longitude": "-71.25", + "geo:altitude": "28" + }, + "lago:obsLev": { + "@default": "2800" + }, + "lago:atmcrd": { + "@type": { + "@default": "lago:Atmod" + }, + "lago:modatm": { + "@default": "E2" + } + }, + "lago:magnet": { + "@default": { + "lago:bDate": "2021-04-08", + "conformsTo": { + "@id": "https://doi.org/10.1186/s40623-020-01288-x", + "@type": [ + "dct:Standard", + "DataSet" + ], + "title": "IGRF", + "description": "International Geomagnetic Reference Field", + "landingpage": "https://www.ngdc.noaa.gov/IAGA/vmod/igrf.html", + "version": "13", + "dataservice": { + "title": "Geomagnetic Model Web Service", + "endpointURL": "http://geomag.bgs.ac.uk/web_service/GMModels/" + }, + "temporalCoverage": { + "startDate": "2020-01-01", + "endDate": "2024-12-31" + }, + "temporalResolution": "P1D" + }, + "lago:bx": "19.975", + "lago:bz": "-11.826", + "lago:bi": "23.213" + } + } + }, + { + "@id": "mad", + "@type": "lago:DetectorSite", + "name": "MAD, Spain", + "lago:belongsLago": false, + "qualifiedAttribution": { + "@type": "lago:Organisation", + "name": "" + }, + "geometry": { + "@id": "mad#geometry", + "@type": "geo:Point", + "geo:latitude": "40.5", + "geo:longitude": "-3.67", + "geo:altitude": "700" + }, + "lago:obsLev": { + "@default": "70000" + }, + "lago:atmcrd": { + "@type": { + "@default": "lago:Atmod" + }, + "lago:modatm": { + "@default": "E2" + } + }, + "lago:magnet": { + "@default": { + "lago:bDate": "2021-05-18", + "conformsTo": { + "@id": "https://doi.org/10.1186/s40623-020-01288-x", + "@type": [ + "dct:Standard", + "DataSet" + ], + "title": "IGRF", + "description": "International Geomagnetic Reference Field", + "landingpage": "https://www.ngdc.noaa.gov/IAGA/vmod/igrf.html", + "version": "13", + "dataservice": { + "title": "Geomagnetic Model Web Service", + "endpointURL": "http://geomag.bgs.ac.uk/web_service/GMModels/" + }, + "temporalCoverage": { + "startDate": "2020-01-01", + "endDate": "2024-12-31" + }, + "temporalResolution": "P1D" + }, + "lago:bx": "25.647", + "lago:bz": "36.933", + "lago:bi": "44.965" + } + } + }, + { + "@id": "mapi", + "@type": "lago:DetectorSite", + "name": "Machu Picchu, Antarctica", + "lago:belongsLago": true, + "qualifiedAttribution": { + "@type": "lago:Organisation", + "name": "CONIDA" + }, + "geometry": { + "@id": "mapi#geometry", + "@type": "geo:Point", + "geo:latitude": "-62.09", + "geo:longitude": "-58.47", + "geo:altitude": "10" + }, + "lago:obsLev": { + "@default": "1000" + }, + "lago:atmcrd": { + "@type": { + "@default": "lago:Atmod" + }, + "lago:modatm": { + "@default": "E5" + } + }, + "lago:magnet": { + "@default": { + "lago:bDate": "2021-04-08", + "conformsTo": { + "@id": "https://doi.org/10.1186/s40623-020-01288-x", + "@type": [ + "dct:Standard", + "DataSet" + ], + "title": "IGRF", + "description": "International Geomagnetic Reference Field", + "landingpage": "https://www.ngdc.noaa.gov/IAGA/vmod/igrf.html", + "version": "13", + "dataservice": { + "title": "Geomagnetic Model Web Service", + "endpointURL": "http://geomag.bgs.ac.uk/web_service/GMModels/" + }, + "temporalCoverage": { + "startDate": "2020-01-01", + "endDate": "2024-12-31" + }, + "temporalResolution": "P1D" + }, + "lago:bx": "19.309", + "lago:bz": "-28.693", + "lago:bi": "34.763" + } + } + }, + { + "@id": "mge", + "@type": "lago:DetectorSite", + "name": "Malargue, Argentina", + "lago:belongsLago": true, + "qualifiedAttribution": { + "@type": "lago:Organisation", + "name": "CNEA" + }, + "geometry": { + "@id": "mge#geometry", + "@type": "geo:Point", + "geo:latitude": "-35.45", + "geo:longitude": "-69.57", + "geo:altitude": "1450" + }, + "lago:obsLev": { + "@default": "145000" + }, + "lago:atmcrd": { + "@type": { + "@default": "lago:Atmod" + }, + "lago:modatm": { + "@default": "E2" + } + }, + "lago:magnet": { + "@default": { + "lago:bDate": "2021-04-08", + "conformsTo": { + "@id": "https://doi.org/10.1186/s40623-020-01288-x", + "@type": [ + "dct:Standard", + "DataSet" + ], + "title": "IGRF", + "description": "International Geomagnetic Reference Field", + "landingpage": "https://www.ngdc.noaa.gov/IAGA/vmod/igrf.html", + "version": "13", + "dataservice": { + "title": "Geomagnetic Model Web Service", + "endpointURL": "http://geomag.bgs.ac.uk/web_service/GMModels/" + }, + "temporalCoverage": { + "startDate": "2020-01-01", + "endDate": "2024-12-31" + }, + "temporalResolution": "P1D" + }, + "lago:bx": "18.987", + "lago:bz": "-14.326", + "lago:bi": "23.79" + } + } + }, + { + "@id": "pam", + "@type": "lago:DetectorSite", + "name": "Pamplona, Colombia", + "lago:belongsLago": true, + "qualifiedAttribution": { + "@type": "lago:Organisation", + "name": "UNIPAM" + }, + "geometry": { + "@id": "pam#geometry", + "@type": "geo:Point", + "geo:latitude": "7.22", + "geo:longitude": "-72.39", + "geo:altitude": "2342" + }, + "lago:obsLev": { + "@default": "234200" + }, + "lago:atmcrd": { + "@type": { + "@default": "lago:Atmod" + }, + "lago:modatm": { + "@default": "E1" + } + }, + "lago:magnet": { + "@default": { + "lago:bDate": "2021-04-08", + "conformsTo": { + "@id": "https://doi.org/10.1186/s40623-020-01288-x", + "@type": [ + "dct:Standard", + "DataSet" + ], + "title": "IGRF", + "description": "International Geomagnetic Reference Field", + "landingpage": "https://www.ngdc.noaa.gov/IAGA/vmod/igrf.html", + "version": "13", + "dataservice": { + "title": "Geomagnetic Model Web Service", + "endpointURL": "http://geomag.bgs.ac.uk/web_service/GMModels/" + }, + "temporalCoverage": { + "startDate": "2020-01-01", + "endDate": "2024-12-31" + }, + "temporalResolution": "P1D" + }, + "lago:bx": "26.743", + "lago:bz": "15.955", + "lago:bi": "31.443" + } + } + }, + { + "@id": "ppet", + "@type": "lago:DetectorSite", + "name": "Peteroa, Argentina", + "lago:belongsLago": false, + "qualifiedAttribution": { + "@type": "lago:Organisation", + "name": "" + }, + "geometry": { + "@id": "ppet#geometry", + "@type": "geo:Point", + "geo:latitude": "-35.25", + "geo:longitude": "-70.57", + "geo:altitude": "3500" + }, + "lago:obsLev": { + "@default": "350000" + }, + "lago:atmcrd": { + "@type": { + "@default": "lago:Atmod" + }, + "lago:modatm": { + "@default": "E2" + } + }, + "lago:magnet": { + "@default": { + "lago:bDate": "2021-05-18", + "conformsTo": { + "@id": "https://doi.org/10.1186/s40623-020-01288-x", + "@type": [ + "dct:Standard", + "DataSet" + ], + "title": "IGRF", + "description": "International Geomagnetic Reference Field", + "landingpage": "https://www.ngdc.noaa.gov/IAGA/vmod/igrf.html", + "version": "13", + "dataservice": { + "title": "Geomagnetic Model Web Service", + "endpointURL": "http://geomag.bgs.ac.uk/web_service/GMModels/" + }, + "temporalCoverage": { + "startDate": "2020-01-01", + "endDate": "2024-12-31" + }, + "temporalResolution": "P1D" + }, + "lago:bx": "19.139", + "lago:bz": "-14.27", + "lago:bi": "23.883" + } + } + }, + { + "@id": "psnc", + "@type": "lago:DetectorSite", + "name": "Poznam, Poland", + "lago:belongsLago": false, + "qualifiedAttribution": { + "@type": "lago:Organisation", + "name": "" + }, + "geometry": { + "@id": "psnc#geometry", + "@type": "geo:Point", + "geo:latitude": "52.41", + "geo:longitude": "16.92", + "geo:altitude": "100" + }, + "lago:obsLev": { + "@default": "10000" + }, + "lago:atmcrd": { + "@type": { + "@default": "lago:Atmod" + }, + "lago:modatm": { + "@default": "E2" + } + }, + "lago:magnet": { + "@default": { + "lago:bDate": "2021-05-18", + "conformsTo": { + "@id": "https://doi.org/10.1186/s40623-020-01288-x", + "@type": [ + "dct:Standard", + "DataSet" + ], + "title": "IGRF", + "description": "International Geomagnetic Reference Field", + "landingpage": "https://www.ngdc.noaa.gov/IAGA/vmod/igrf.html", + "version": "13", + "dataservice": { + "title": "Geomagnetic Model Web Service", + "endpointURL": "http://geomag.bgs.ac.uk/web_service/GMModels/" + }, + "temporalCoverage": { + "startDate": "2020-01-01", + "endDate": "2024-12-31" + }, + "temporalResolution": "P1D" + }, + "lago:bx": "18.598", + "lago:bz": "46.45", + "lago:bi": "50.066" + } + } + }, + { + "@id": "quie", + "@type": "lago:DetectorSite", + "name": "Quito-EPN, Ecuador", + "lago:belongsLago": true, + "qualifiedAttribution": { + "@type": "lago:Organisation", + "name": "EPN" + }, + "geometry": { + "@id": "quie#geometry", + "@type": "geo:Point", + "geo:latitude": "-0.2", + "geo:longitude": "-78.5", + "geo:altitude": "2850" + }, + "lago:obsLev": { + "@default": "285000" + }, + "lago:atmcrd": { + "@type": { + "@default": "lago:Atmod" + }, + "lago:modatm": { + "@default": "E1" + } + }, + "lago:magnet": { + "@default": { + "lago:bDate": "2021-04-08", + "conformsTo": { + "@id": "https://doi.org/10.1186/s40623-020-01288-x", + "@type": [ + "dct:Standard", + "DataSet" + ], + "title": "IGRF", + "description": "International Geomagnetic Reference Field", + "landingpage": "https://www.ngdc.noaa.gov/IAGA/vmod/igrf.html", + "version": "13", + "dataservice": { + "title": "Geomagnetic Model Web Service", + "endpointURL": "http://geomag.bgs.ac.uk/web_service/GMModels/" + }, + "temporalCoverage": { + "startDate": "2020-01-01", + "endDate": "2024-12-31" + }, + "temporalResolution": "P1D" + }, + "lago:bx": "26.717", + "lago:bz": "9.971", + "lago:bi": "28.579" + } + } + }, + { + "@id": "sac", + "@type": "lago:DetectorSite", + "name": "San Antonio de los Cobres, Argentina", + "lago:belongsLago": true, + "qualifiedAttribution": { + "@type": "lago:Organisation", + "name": "CNEA" + }, + "geometry": { + "@id": "sac#geometry", + "@type": "geo:Point", + "geo:latitude": "-24.71", + "geo:longitude": "-66.38", + "geo:altitude": "4820" + }, + "lago:obsLev": { + "@default": "482000" + }, + "lago:atmcrd": { + "@type": { + "@default": "lago:Atmod" + }, + "lago:modatm": { + "@default": "E2" + } + }, + "lago:magnet": { + "@default": { + "lago:bDate": "2021-04-08", + "conformsTo": { + "@id": "https://doi.org/10.1186/s40623-020-01288-x", + "@type": [ + "dct:Standard", + "DataSet" + ], + "title": "IGRF", + "description": "International Geomagnetic Reference Field", + "landingpage": "https://www.ngdc.noaa.gov/IAGA/vmod/igrf.html", + "version": "13", + "dataservice": { + "title": "Geomagnetic Model Web Service", + "endpointURL": "http://geomag.bgs.ac.uk/web_service/GMModels/" + }, + "temporalCoverage": { + "startDate": "2020-01-01", + "endDate": "2024-12-31" + }, + "temporalResolution": "P1D" + }, + "lago:bx": "20.06", + "lago:bz": "-9.616", + "lago:bi": "22.398" + } + } + }, + { + "@id": "sao", + "@type": "lago:DetectorSite", + "name": "Sao Paulo-UFABC, Brazil", + "lago:belongsLago": true, + "qualifiedAttribution": { + "@type": "lago:Organisation", + "name": "UFABC" + }, + "geometry": { + "@id": "sao#geometry", + "@type": "geo:Point", + "geo:latitude": "-23.38", + "geo:longitude": "-46.31", + "geo:altitude": "760" + }, + "lago:obsLev": { + "@default": "76000" + }, + "lago:atmcrd": { + "@type": { + "@default": "lago:Atmod" + }, + "lago:modatm": { + "@default": "E1" + } + }, + "lago:magnet": { + "@default": { + "lago:bDate": "2021-04-08", + "conformsTo": { + "@id": "https://doi.org/10.1186/s40623-020-01288-x", + "@type": [ + "dct:Standard", + "DataSet" + ], + "title": "IGRF", + "description": "International Geomagnetic Reference Field", + "landingpage": "https://www.ngdc.noaa.gov/IAGA/vmod/igrf.html", + "version": "13", + "dataservice": { + "title": "Geomagnetic Model Web Service", + "endpointURL": "http://geomag.bgs.ac.uk/web_service/GMModels/" + }, + "temporalCoverage": { + "startDate": "2020-01-01", + "endDate": "2024-12-31" + }, + "temporalResolution": "P1D" + }, + "lago:bx": "16.484", + "lago:bz": "-14.48", + "lago:bi": "22.905" + } + } + }, + { + "@id": "sawb", + "@type": "lago:DetectorSite", + "name": "Marambio, Antarctica", + "lago:belongsLago": true, + "qualifiedAttribution": { + "@type": "lago:Organisation", + "name": "UBA" + }, + "geometry": { + "@id": "sawb#geometry", + "@type": "geo:Point", + "geo:latitude": "-64.24", + "geo:longitude": "-56.62", + "geo:altitude": "200" + }, + "lago:obsLev": { + "@default": "20000" + }, + "lago:atmcrd": { + "@type": { + "@default": "lago:Atmod" + }, + "lago:modatm": { + "@default": "E5" + } + }, + "lago:magnet": { + "@default": { + "lago:bDate": "2021-04-08", + "conformsTo": { + "@id": "https://doi.org/10.1186/s40623-020-01288-x", + "@type": [ + "dct:Standard", + "DataSet" + ], + "title": "IGRF", + "description": "International Geomagnetic Reference Field", + "landingpage": "https://www.ngdc.noaa.gov/IAGA/vmod/igrf.html", + "version": "13", + "dataservice": { + "title": "Geomagnetic Model Web Service", + "endpointURL": "http://geomag.bgs.ac.uk/web_service/GMModels/" + }, + "temporalCoverage": { + "startDate": "2020-01-01", + "endDate": "2024-12-31" + }, + "temporalResolution": "P1D" + }, + "lago:bx": "19.366", + "lago:bz": "-30.222", + "lago:bi": "36.077" + } + } + }, + { + "@id": "serb", + "@type": "lago:DetectorSite", + "name": "Riobamba-EPOSCH, Ecuador", + "lago:belongsLago": true, + "qualifiedAttribution": { + "@type": "lago:Organisation", + "name": "EPOCH" + }, + "geometry": { + "@id": "serb#geometry", + "@type": "geo:Point", + "geo:latitude": "-1.81", + "geo:longitude": "-78.74", + "geo:altitude": "2750" + }, + "lago:obsLev": { + "@default": "275000" + }, + "lago:atmcrd": { + "@type": { + "@default": "lago:Atmod" + }, + "lago:modatm": { + "@default": "E1" + } + }, + "lago:magnet": { + "@default": { + "lago:bDate": "2021-04-08", + "conformsTo": { + "@id": "https://doi.org/10.1186/s40623-020-01288-x", + "@type": [ + "dct:Standard", + "DataSet" + ], + "title": "IGRF", + "description": "International Geomagnetic Reference Field", + "landingpage": "https://www.ngdc.noaa.gov/IAGA/vmod/igrf.html", + "version": "13", + "dataservice": { + "title": "Geomagnetic Model Web Service", + "endpointURL": "http://geomag.bgs.ac.uk/web_service/GMModels/" + }, + "temporalCoverage": { + "startDate": "2020-01-01", + "endDate": "2024-12-31" + }, + "temporalResolution": "P1D" + }, + "lago:bx": "26.577", + "lago:bz": "8.499", + "lago:bi": "27.952" + } + } + }, + { + "@id": "sgd", + "@type": "lago:DetectorSite", + "name": "Sierra Grande, Argentina", + "lago:belongsLago": false, + "qualifiedAttribution": { + "@type": "lago:Organisation", + "name": "" + }, + "geometry": { + "@id": "sgd#geometry", + "@type": "geo:Point", + "geo:latitude": "-41.668", + "geo:longitude": "-65.365", + "geo:altitude": "250" + }, + "lago:obsLev": { + "@default": "25000" + }, + "lago:atmcrd": { + "@type": { + "@default": "lago:Atmod" + }, + "lago:modatm": { + "@default": "E2" + } + }, + "lago:magnet": { + "@default": { + "lago:bDate": "2021-06-02", + "conformsTo": { + "@id": "https://doi.org/10.1186/s40623-020-01288-x", + "@type": [ + "dct:Standard", + "DataSet" + ], + "title": "IGRF", + "description": "International Geomagnetic Reference Field", + "landingpage": "https://www.ngdc.noaa.gov/IAGA/vmod/igrf.html", + "version": "13", + "dataservice": { + "title": "Geomagnetic Model Web Service", + "endpointURL": "http://geomag.bgs.ac.uk/web_service/GMModels/" + }, + "temporalCoverage": { + "startDate": "2020-01-01", + "endDate": "2024-12-31" + }, + "temporalResolution": "P1D" + }, + "lago:bx": "18.108", + "lago:bz": "-16.917", + "lago:bi": "24.785" + } + } + }, + { + "@id": "sng", + "@type": "lago:DetectorSite", + "name": "Sierra Negra, Mexico", + "lago:belongsLago": true, + "qualifiedAttribution": { + "@type": "lago:Organisation", + "name": "BUAP" + }, + "geometry": { + "@id": "sng#geometry", + "@type": "geo:Point", + "geo:latitude": "18.16", + "geo:longitude": "-97.95", + "geo:altitude": "4550" + }, + "lago:obsLev": { + "@default": "455000" + }, + "lago:atmcrd": { + "@type": { + "@default": "lago:Atmod" + }, + "lago:modatm": { + "@default": "E2" + } + }, + "lago:magnet": { + "@default": { + "lago:bDate": "2021-04-08", + "conformsTo": { + "@id": "https://doi.org/10.1186/s40623-020-01288-x", + "@type": [ + "dct:Standard", + "DataSet" + ], + "title": "IGRF", + "description": "International Geomagnetic Reference Field", + "landingpage": "https://www.ngdc.noaa.gov/IAGA/vmod/igrf.html", + "version": "13", + "dataservice": { + "title": "Geomagnetic Model Web Service", + "endpointURL": "http://geomag.bgs.ac.uk/web_service/GMModels/" + }, + "temporalCoverage": { + "startDate": "2020-01-01", + "endDate": "2024-12-31" + }, + "temporalResolution": "P1D" + }, + "lago:bx": "27.358", + "lago:bz": "28.038", + "lago:bi": "39.217" + } + } + }, + { + "@id": "sudb", + "@type": "lago:DetectorSite", + "name": "Chreighton, Canada", + "lago:belongsLago": false, + "qualifiedAttribution": { + "@type": "lago:Organisation", + "name": "" + }, + "geometry": { + "@id": "sudb#geometry", + "@type": "geo:Point", + "geo:latitude": "46.46", + "geo:longitude": "-81.17", + "geo:altitude": "2100" + }, + "lago:obsLev": { + "@default": "210000" + }, + "lago:atmcrd": { + "@type": { + "@default": "lago:Atmod" + }, + "lago:modatm": { + "@default": "E2" + } + }, + "lago:magnet": { + "@default": { + "lago:bDate": "2021-05-18", + "conformsTo": { + "@id": "https://doi.org/10.1186/s40623-020-01288-x", + "@type": [ + "dct:Standard", + "DataSet" + ], + "title": "IGRF", + "description": "International Geomagnetic Reference Field", + "landingpage": "https://www.ngdc.noaa.gov/IAGA/vmod/igrf.html", + "version": "13", + "dataservice": { + "title": "Geomagnetic Model Web Service", + "endpointURL": "http://geomag.bgs.ac.uk/web_service/GMModels/" + }, + "temporalCoverage": { + "startDate": "2020-01-01", + "endDate": "2024-12-31" + }, + "temporalResolution": "P1D" + }, + "lago:bx": "17.037", + "lago:bz": "51.991", + "lago:bi": "54.79" + } + } + }, + { + "@id": "tac", + "@type": "lago:DetectorSite", + "name": "Tacana, Guatemala", + "lago:belongsLago": true, + "qualifiedAttribution": { + "@type": "lago:Organisation", + "name": "UVG" + }, + "geometry": { + "@id": "tac#geometry", + "@type": "geo:Point", + "geo:latitude": "15.13", + "geo:longitude": "-92.11", + "geo:altitude": "4060" + }, + "lago:obsLev": { + "@default": "406000" + }, + "lago:atmcrd": { + "@type": { + "@default": "lago:Atmod" + }, + "lago:modatm": { + "@default": "E1" + } + }, + "lago:magnet": { + "@default": { + "lago:bDate": "2021-04-08", + "conformsTo": { + "@id": "https://doi.org/10.1186/s40623-020-01288-x", + "@type": [ + "dct:Standard", + "DataSet" + ], + "title": "IGRF", + "description": "International Geomagnetic Reference Field", + "landingpage": "https://www.ngdc.noaa.gov/IAGA/vmod/igrf.html", + "version": "13", + "dataservice": { + "title": "Geomagnetic Model Web Service", + "endpointURL": "http://geomag.bgs.ac.uk/web_service/GMModels/" + }, + "temporalCoverage": { + "startDate": "2020-01-01", + "endDate": "2024-12-31" + }, + "temporalResolution": "P1D" + }, + "lago:bx": "27.53", + "lago:bz": "25.353", + "lago:bi": "37.432" + } + } + }, + { + "@id": "truj", + "@type": "lago:DetectorSite", + "name": "Trujillo, Spain", + "lago:belongsLago": false, + "qualifiedAttribution": { + "@type": "lago:Organisation", + "name": "" + }, + "geometry": { + "@id": "truj#geometry", + "@type": "geo:Point", + "geo:latitude": "39.47", + "geo:longitude": "-5.88", + "geo:altitude": "560" + }, + "lago:obsLev": { + "@default": "56000" + }, + "lago:atmcrd": { + "@type": { + "@default": "lago:Atmod" + }, + "lago:modatm": { + "@default": "E2" + } + }, + "lago:magnet": { + "@default": { + "lago:bDate": "2021-05-18", + "conformsTo": { + "@id": "https://doi.org/10.1186/s40623-020-01288-x", + "@type": [ + "dct:Standard", + "DataSet" + ], + "title": "IGRF", + "description": "International Geomagnetic Reference Field", + "landingpage": "https://www.ngdc.noaa.gov/IAGA/vmod/igrf.html", + "version": "13", + "dataservice": { + "title": "Geomagnetic Model Web Service", + "endpointURL": "http://geomag.bgs.ac.uk/web_service/GMModels/" + }, + "temporalCoverage": { + "startDate": "2020-01-01", + "endDate": "2024-12-31" + }, + "temporalResolution": "P1D" + }, + "lago:bx": "26.223", + "lago:bz": "35.844", + "lago:bi": "44.413" + } + } + }, + { + "@id": "tuc", + "@type": "lago:DetectorSite", + "name": "Tucuman, Argentina", + "lago:belongsLago": true, + "qualifiedAttribution": { + "@type": "lago:Organisation", + "name": "UNT" + }, + "geometry": { + "@id": "tuc#geometry", + "@type": "geo:Point", + "geo:latitude": "-26.5", + "geo:longitude": "-65.11", + "geo:altitude": "430" + }, + "lago:obsLev": { + "@default": "43000" + }, + "lago:atmcrd": { + "@type": { + "@default": "lago:Atmod" + }, + "lago:modatm": { + "@default": "E2" + } + }, + "lago:magnet": { + "@default": { + "lago:bDate": "2021-04-08", + "conformsTo": { + "@id": "https://doi.org/10.1186/s40623-020-01288-x", + "@type": [ + "dct:Standard", + "DataSet" + ], + "title": "IGRF", + "description": "International Geomagnetic Reference Field", + "landingpage": "https://www.ngdc.noaa.gov/IAGA/vmod/igrf.html", + "version": "13", + "dataservice": { + "title": "Geomagnetic Model Web Service", + "endpointURL": "http://geomag.bgs.ac.uk/web_service/GMModels/" + }, + "temporalCoverage": { + "startDate": "2020-01-01", + "endDate": "2024-12-31" + }, + "temporalResolution": "P1D" + }, + "lago:bx": "19.487", + "lago:bz": "-10.647", + "lago:bi": "22.365" + } + } + }, + { + "@id": "vcp", + "@type": "lago:DetectorSite", + "name": "Campinas, Brazil", + "lago:belongsLago": true, + "qualifiedAttribution": { + "@type": "lago:Organisation", + "name": "UNICAMP" + }, + "geometry": { + "@id": "vcp#geometry", + "@type": "geo:Point", + "geo:latitude": "-22.9", + "geo:longitude": "-47.06", + "geo:altitude": "640" + }, + "lago:obsLev": { + "@default": "64000" + }, + "lago:atmcrd": { + "@type": { + "@default": "lago:Atmod" + }, + "lago:modatm": { + "@default": "E1" + } + }, + "lago:magnet": { + "@default": { + "lago:bDate": "2021-04-08", + "conformsTo": { + "@id": "https://doi.org/10.1186/s40623-020-01288-x", + "@type": [ + "dct:Standard", + "DataSet" + ], + "title": "IGRF", + "description": "International Geomagnetic Reference Field", + "landingpage": "https://www.ngdc.noaa.gov/IAGA/vmod/igrf.html", + "version": "13", + "dataservice": { + "title": "Geomagnetic Model Web Service", + "endpointURL": "http://geomag.bgs.ac.uk/web_service/GMModels/" + }, + "temporalCoverage": { + "startDate": "2020-01-01", + "endDate": "2024-12-31" + }, + "temporalResolution": "P1D" + }, + "lago:bx": "16.751", + "lago:bz": "-14.104", + "lago:bi": "22.873" + } + } + }, + { + "@id": "viri", + "@type": "lago:DetectorSite", + "name": "Villa Rica, Chile", + "lago:belongsLago": false, + "qualifiedAttribution": { + "@type": "lago:Organisation", + "name": "" + }, + "geometry": { + "@id": "viri#geometry", + "@type": "geo:Point", + "geo:latitude": "-39.42", + "geo:longitude": "-71.94", + "geo:altitude": "2850" + }, + "lago:obsLev": { + "@default": "285000" + }, + "lago:atmcrd": { + "@type": { + "@default": "lago:Atmod" + }, + "lago:modatm": { + "@default": "E2" + } + }, + "lago:magnet": { + "@default": { + "lago:bDate": "2021-05-18", + "conformsTo": { + "@id": "https://doi.org/10.1186/s40623-020-01288-x", + "@type": [ + "dct:Standard", + "DataSet" + ], + "title": "IGRF", + "description": "International Geomagnetic Reference Field", + "landingpage": "https://www.ngdc.noaa.gov/IAGA/vmod/igrf.html", + "version": "13", + "dataservice": { + "title": "Geomagnetic Model Web Service", + "endpointURL": "http://geomag.bgs.ac.uk/web_service/GMModels/" + }, + "temporalCoverage": { + "startDate": "2020-01-01", + "endDate": "2024-12-31" + }, + "temporalResolution": "P1D" + }, + "lago:bx": "19.061", + "lago:bz": "-16.289", + "lago:bi": "25.148" + } + } + } + ] +} \ No newline at end of file diff --git a/1.1/defs/sitesLago.md b/1.1/defs/sitesLago.md new file mode 100644 index 0000000000000000000000000000000000000000..634dd8a7a7e62882695ff8444692e6fa26426ca1 --- /dev/null +++ b/1.1/defs/sitesLago.md @@ -0,0 +1,81 @@ +--- +layout: default +parent: Definitions +nav_order: 1 +--- + +# LAGO sites +{: .no_toc } + +|Version| Updated | Date |Contributors| +|-------|---------|------|------------| +| 1.1 develop | {{ site.time }} | 2020-06-01 - today | LAGO Collaboration | + + +## Table of contents +{: .no_toc .text-delta } + +- TOC +{:toc} + +## What is defined? + +[sitesLago.jsonld](./sitesLago.jsonld) unifies the definition of the LAGO sites following the official LAGO schema vocabulary. + +The purpose of the site's definition is: +- to univocally identify a predefined LAGO site (real or virtual) to be linked by metadata using a public URI; +- to link several related definitions of the site: short codename, name, description, responsible organisation; +- to fix their location, i.e. magnetic field, observation level, GPS coordinates; +- to provide other default configuration parameters, meaningful for applications such as the `arrang` [(ARTI)](https://github.com/lagoproject/arti), `status` [(locationMaps)](https://github.com/lagoproject/locationsMaps), etc. + +Note that the sites give support or have given support (physically or virtually) to one or several Water Cherenkov Detectors (WCDs). Their definitions should not be included in this document, conversely, it is the WCD definition that should be linked to a LAGO site. + +## How should an item be referenced? + +To preserve the provenance of the linked metadata through time, you must use the GitHub raw link to a certain release of this document, plus `#` and the short site codename: + +`https://raw.githubusercontent.com/lagoproject/DMP/`*\<tag release\>*`/defs/sitesLago.jsonld`*#\<site codename\>* + +For example: + +[https://raw.githubusercontent.com/lagoproject/DMP/1.1/defs/sitesLago.jsonld#sac](https://raw.githubusercontent.com/lagoproject/DMP/1.1/defs/sitesLago.jsonld#sac) + + +As a real example, the metadata´s catalog of a simulation should include the site´s reference: + +```json +{ +"@context":{ +... + "lago":"https://raw.githubusercontent.com/lagoproject/DMP/1.1/schema/lagoSchema.jsonld", +... + }, +... +... + { + "@id":"/sac_60_100.0_75600_QGSII_flat#artiParams", + "@type":"lago:ArtiParams", + "lago:cherenkov":False, + "lago:debug":False, + "lago:highEnergyIntModel":"QGSII", + "lago:detectorSite":"https://raw.githubusercontent.com/lagoproject/DMP/1.1/defs/sitesLago.jsonld#sac", + "lago:obsLev":100, + "lago:highEnergyCutsSecondaries": False, + "lago:fluxTime":"Psac_60_100.0_75600_QGSII_flatS", + "lago:flatArray":True + }, +... +... +``` + +## Defined LAGO sites + +{% include generate_html_for_sites.html folder="/DMP/defs/sitesLago.jsonld" %} + + +## Plain JSON-LD file + +```json +{% include_relative sitesLago.jsonld %} +``` + diff --git a/1.1/docs/architecture/index.md b/1.1/docs/architecture/index.md new file mode 100644 index 0000000000000000000000000000000000000000..89b9d4fe894df1def49349b57c1158d520cfa8a9 --- /dev/null +++ b/1.1/docs/architecture/index.md @@ -0,0 +1,9 @@ +--- +layout: default +title: Architecture +has_children: true +permalink: /Architecture/ +nav_order: 6 +--- + +# Architecture diff --git a/1.1/docs/howtos/how_to_enrol_OneData_provider.md b/1.1/docs/howtos/how_to_enrol_OneData_provider.md new file mode 100644 index 0000000000000000000000000000000000000000..021992329ef966f14021b38852528ba834e429d1 --- /dev/null +++ b/1.1/docs/howtos/how_to_enrol_OneData_provider.md @@ -0,0 +1,14 @@ +--- +layout: default +parent: HowTo's +nav_order: 3 +--- + +# How to enrol a OneData provider + +TBD. + +## etc... + +TBD. + diff --git a/1.1/docs/howtos/how_to_join_LAGO_VO.md b/1.1/docs/howtos/how_to_join_LAGO_VO.md new file mode 100644 index 0000000000000000000000000000000000000000..47c5d0600ef994413c0b3007302f3004b89c9ea6 --- /dev/null +++ b/1.1/docs/howtos/how_to_join_LAGO_VO.md @@ -0,0 +1,73 @@ +--- +layout: default +parent: HowTo's +nav_order: 1 +--- + +# How to Join to LAGO Virtual Organisation + +## Table of contents +{: .no_toc} + +- TOC +{:toc} + + +## Introduction + +https://wiki.geant.org/display/eduTEAMS/Services + +## Registering as a new user on the eduTEAMS Service +*(This subsection is copied from the work of Christos Kanellopoulos as eduTEAMs responsible at [https://wiki.geant.org/display/eduTEAMS/Registering+as+a+new+user+on+the+eduTEAMS+Service](https://wiki.geant.org/display/eduTEAMS/Registering+as+a+new+user+on+the+eduTEAMS+Service))*. + +Before joining LAGO you must register in eduTeams. The procedure is as follows: + +{% assign i = 0 %} + +1. To get started with eduTEAMS, all users, regardless of their role, need to register on the eduTEAMS Service at [https://www.eduteams.org/#join](https://www.eduteams.org/#join).{% assign i = i | plus: 1 %} + +1. When you click the "JOIN" button, you will be presented with a screen on which you will have to select your organisation's Identity Provider where you will be authenticated. If your organisation is not listed, you might want to search/choose "ORCID" or "Google".{% assign i = i | plus: 1 %} + +1. You will be redirected to the Identity Provider you have selected. After you have been successfully authenticated, you will be redirected to the eduTEAMS Registration Form, where you have to fill the data. The fields Name and E-mail are pre-filled, based on your account attributes. The field Username should be added and will be used as eduTEAMS nickname.{% assign i = i | plus: 1 %} + +1. Read carefully the Acceptable Usage Policy. To register on eduTEAMS Service you have to click on the "I agree" checkbox and on the "Submit" button.{% assign i = i | plus: 1 %} + +1. Congratulations! You have successfully registered on the eduTEAMS Service. Click on the "Continue" button and you will be redirected to your eduTEAMS Profile page. You can access your profile page on the eduTEAMS Service at any time by visiting [https://mms.eduteams.org/profile/](https://mms.eduteams.org/profile/) +{% assign i = i | plus: 1 %} + + + +Now, you are registered on the eduTEAMS Service, but to access the LAGO services **you must also join some group in the LAGO Virtual Organization**. See the next section. + +## Applying to a LAGO group + +Every collaborator should belong to some LAGO scientific group. To apply for one you should follow the link: + +``https://mms.eduteams.org/fed/registrar/?vo=LAGO-AAI&group=<GROUP>`` + +The collaborations are mainly distributed by countries, where every person corresponds to one group: +{% assign countries = "argentina, colombia, spain" | split: ", " %} +{% for c in countries %} + - {{c}} : [https://mms.eduteams.org/fed/registrar/?vo=LAGO-AAI&group={{c}}](https://mms.eduteams.org/fed/registrar/?vo=LAGO-AAI&group={{c}}) +{% endfor %} + + +For example, after following the corresponding link, you must accept the AUP clauses of LAGO collaboration (also updated on this [page](/DMP/rights/AUP/)): + +{% assign i = i | plus: 1 %} + + +Then, eduTEAMS informs you that the application was sent and is waiting for approval: + +{% assign i = i | plus: 1 %} + + +You can also see that there are two pending registrations, one for the main LAGO-AAI virtual organisation (VO) and other for the group for which you have applied: + +{% assign i = i | plus: 1 %} + + + +The result (accepted or not) will be notified by email. + + diff --git a/1.1/docs/howtos/how_to_join_LAGO_VO_img/RegistrationLAGO1.png b/1.1/docs/howtos/how_to_join_LAGO_VO_img/RegistrationLAGO1.png new file mode 100644 index 0000000000000000000000000000000000000000..24fdff26bce0e06f71c15b4be3f784f3d5c1cfb4 Binary files /dev/null and b/1.1/docs/howtos/how_to_join_LAGO_VO_img/RegistrationLAGO1.png differ diff --git a/1.1/docs/howtos/how_to_join_LAGO_VO_img/RegistrationLAGO2.png b/1.1/docs/howtos/how_to_join_LAGO_VO_img/RegistrationLAGO2.png new file mode 100644 index 0000000000000000000000000000000000000000..0213e9c2e0011759eeee49ccdf9045f4c74c124b Binary files /dev/null and b/1.1/docs/howtos/how_to_join_LAGO_VO_img/RegistrationLAGO2.png differ diff --git a/1.1/docs/howtos/how_to_join_LAGO_VO_img/RegistrationLAGO3.png b/1.1/docs/howtos/how_to_join_LAGO_VO_img/RegistrationLAGO3.png new file mode 100644 index 0000000000000000000000000000000000000000..d9fed374a0fd15e33f732eeea2199a0a3b1d0ce6 Binary files /dev/null and b/1.1/docs/howtos/how_to_join_LAGO_VO_img/RegistrationLAGO3.png differ diff --git a/1.1/docs/howtos/how_to_join_LAGO_VO_img/RegistrationLAGO4.png b/1.1/docs/howtos/how_to_join_LAGO_VO_img/RegistrationLAGO4.png new file mode 100644 index 0000000000000000000000000000000000000000..2d9571401314176ae0cb15b1b9266d05af87e273 Binary files /dev/null and b/1.1/docs/howtos/how_to_join_LAGO_VO_img/RegistrationLAGO4.png differ diff --git a/1.1/docs/howtos/how_to_join_LAGO_VO_img/RegistrationLAGO5.png b/1.1/docs/howtos/how_to_join_LAGO_VO_img/RegistrationLAGO5.png new file mode 100644 index 0000000000000000000000000000000000000000..e114d4aadcb0829a011f3073cd20a218ba0e2686 Binary files /dev/null and b/1.1/docs/howtos/how_to_join_LAGO_VO_img/RegistrationLAGO5.png differ diff --git a/1.1/docs/howtos/how_to_join_LAGO_VO_img/RegistrationLAGO6.png b/1.1/docs/howtos/how_to_join_LAGO_VO_img/RegistrationLAGO6.png new file mode 100644 index 0000000000000000000000000000000000000000..08c05b050deca3162104bf54fab0f5e19b5aa02c Binary files /dev/null and b/1.1/docs/howtos/how_to_join_LAGO_VO_img/RegistrationLAGO6.png differ diff --git a/1.1/docs/howtos/how_to_join_LAGO_VO_img/RegistrationLAGO7.png b/1.1/docs/howtos/how_to_join_LAGO_VO_img/RegistrationLAGO7.png new file mode 100644 index 0000000000000000000000000000000000000000..5a15db8b2081990d1d376aa24ef98f673a7cbc28 Binary files /dev/null and b/1.1/docs/howtos/how_to_join_LAGO_VO_img/RegistrationLAGO7.png differ diff --git a/1.1/docs/howtos/how_to_join_LAGO_VO_img/RegistrationLAGO8.png b/1.1/docs/howtos/how_to_join_LAGO_VO_img/RegistrationLAGO8.png new file mode 100644 index 0000000000000000000000000000000000000000..cc5a11bcc3993897402e0983e1795c440cf278e4 Binary files /dev/null and b/1.1/docs/howtos/how_to_join_LAGO_VO_img/RegistrationLAGO8.png differ diff --git a/1.1/docs/howtos/how_to_join_LAGO_VO_img/RegistrationLAGO9.png b/1.1/docs/howtos/how_to_join_LAGO_VO_img/RegistrationLAGO9.png new file mode 100644 index 0000000000000000000000000000000000000000..fc85b36bdd2ec46fb7bc9d15ba68964b6dbf94ea Binary files /dev/null and b/1.1/docs/howtos/how_to_join_LAGO_VO_img/RegistrationLAGO9.png differ diff --git a/1.1/docs/howtos/how_to_login_into_OneData.md b/1.1/docs/howtos/how_to_login_into_OneData.md new file mode 100644 index 0000000000000000000000000000000000000000..54ef755eebd11eaa3bba725477d94c196a928126 --- /dev/null +++ b/1.1/docs/howtos/how_to_login_into_OneData.md @@ -0,0 +1,53 @@ +--- +layout: default +parent: HowTo's +nav_order: 2 +--- + +# How to Login into LAGO data repositories + +## Table of contents +{: .no_toc} + +- TOC +{:toc} + +## The login process + +You **must be enrolled in the LAGO Virtual Organisation before** accessing the repositories. + +All repositories can be accessed through the single OneZone instance at [https://datahub.egi.eu](https://datahub.egi.eu), which is provided by EGI. + + + +Authentication and authorisation in LAGO are based on single-sign-on (SSO) technologies and delegated credentials. Such credentials (roles and permissions) are managed through the eduTEAMs service. Thus, **when you click on the EGI button, **you must select eduTEAMs*** among the available identification providers (IdPs), although your institution or your e-mail provider might be also listed. If you do not select eduTEAMs, you will only obtain access to the test repositories for EGI users, but not to the LAGO repositories. + +For example, if you enrolled in LAGO VO with a Google account, you will firstly select eduTEAMs service as IdP, and then, within the eduTEAMs screen, you will have to search for the Google provider. Therefore, you will sign in Google (if not already logged in) to be authenticated in eduTEAMS, and eduTEAMS will add your credentials to EGI, respectively: + +{% for i in (2..6) %} +  +{% endfor %} + + +## General OneZone View + +Depending on the browser and the screen size, the menu list on the left can be hidden and the objects at a different position: + +{% for i in (7..8) %} +  +{% endfor %} + + +## Get a usable TOKEN + +If you want to mount locally the repositories or to access them through any application, is needed to generate a personal OneData token. For this purpose, you have to open the TOKENS option in the menu. + +As previously indicated, the menu list can appear permanently on the left: + + + +Although, it could be a drop-down menu hidden at the top-left corner: + +{% for i in (9..11) %} +  +{% endfor %} diff --git a/1.1/docs/howtos/how_to_login_into_OneData_img/datahub.egi.eu_login.png b/1.1/docs/howtos/how_to_login_into_OneData_img/datahub.egi.eu_login.png new file mode 100644 index 0000000000000000000000000000000000000000..0279b0b530a2afc4fd5c1801b7441d9c3551c19f Binary files /dev/null and b/1.1/docs/howtos/how_to_login_into_OneData_img/datahub.egi.eu_login.png differ diff --git a/1.1/docs/howtos/how_to_login_into_OneData_img/datahub.egi.eu_login10.png b/1.1/docs/howtos/how_to_login_into_OneData_img/datahub.egi.eu_login10.png new file mode 100644 index 0000000000000000000000000000000000000000..6aa6221cb2afaee335ff830da470cbe01b84caa1 Binary files /dev/null and b/1.1/docs/howtos/how_to_login_into_OneData_img/datahub.egi.eu_login10.png differ diff --git a/1.1/docs/howtos/how_to_login_into_OneData_img/datahub.egi.eu_login11.png b/1.1/docs/howtos/how_to_login_into_OneData_img/datahub.egi.eu_login11.png new file mode 100644 index 0000000000000000000000000000000000000000..8c25327efd1603c574c4e73e5b8f5a04825d5ec7 Binary files /dev/null and b/1.1/docs/howtos/how_to_login_into_OneData_img/datahub.egi.eu_login11.png differ diff --git a/1.1/docs/howtos/how_to_login_into_OneData_img/datahub.egi.eu_login12.png b/1.1/docs/howtos/how_to_login_into_OneData_img/datahub.egi.eu_login12.png new file mode 100644 index 0000000000000000000000000000000000000000..d92e4ae7c3a8112181cc37e3e409cdd5374f3282 Binary files /dev/null and b/1.1/docs/howtos/how_to_login_into_OneData_img/datahub.egi.eu_login12.png differ diff --git a/1.1/docs/howtos/how_to_login_into_OneData_img/datahub.egi.eu_login2.png b/1.1/docs/howtos/how_to_login_into_OneData_img/datahub.egi.eu_login2.png new file mode 100644 index 0000000000000000000000000000000000000000..a7ecdef076f9873cf4d790bacfd8de8b11c9ec0e Binary files /dev/null and b/1.1/docs/howtos/how_to_login_into_OneData_img/datahub.egi.eu_login2.png differ diff --git a/1.1/docs/howtos/how_to_login_into_OneData_img/datahub.egi.eu_login3.png b/1.1/docs/howtos/how_to_login_into_OneData_img/datahub.egi.eu_login3.png new file mode 100644 index 0000000000000000000000000000000000000000..6129b00a43e952b4c3252adf92f1edcb53de93b6 Binary files /dev/null and b/1.1/docs/howtos/how_to_login_into_OneData_img/datahub.egi.eu_login3.png differ diff --git a/1.1/docs/howtos/how_to_login_into_OneData_img/datahub.egi.eu_login4.png b/1.1/docs/howtos/how_to_login_into_OneData_img/datahub.egi.eu_login4.png new file mode 100644 index 0000000000000000000000000000000000000000..d9fed374a0fd15e33f732eeea2199a0a3b1d0ce6 Binary files /dev/null and b/1.1/docs/howtos/how_to_login_into_OneData_img/datahub.egi.eu_login4.png differ diff --git a/1.1/docs/howtos/how_to_login_into_OneData_img/datahub.egi.eu_login5.png b/1.1/docs/howtos/how_to_login_into_OneData_img/datahub.egi.eu_login5.png new file mode 100644 index 0000000000000000000000000000000000000000..3f67e6441768df724f85fbbb4815ebc56a6ad283 Binary files /dev/null and b/1.1/docs/howtos/how_to_login_into_OneData_img/datahub.egi.eu_login5.png differ diff --git a/1.1/docs/howtos/how_to_login_into_OneData_img/datahub.egi.eu_login6.png b/1.1/docs/howtos/how_to_login_into_OneData_img/datahub.egi.eu_login6.png new file mode 100644 index 0000000000000000000000000000000000000000..508a7fe97e4bb6f1cd134f044dc1ee7909b44f4e Binary files /dev/null and b/1.1/docs/howtos/how_to_login_into_OneData_img/datahub.egi.eu_login6.png differ diff --git a/1.1/docs/howtos/how_to_login_into_OneData_img/datahub.egi.eu_login7.png b/1.1/docs/howtos/how_to_login_into_OneData_img/datahub.egi.eu_login7.png new file mode 100644 index 0000000000000000000000000000000000000000..5734e35e458a99a75ce5584450c81b5062da4d76 Binary files /dev/null and b/1.1/docs/howtos/how_to_login_into_OneData_img/datahub.egi.eu_login7.png differ diff --git a/1.1/docs/howtos/how_to_login_into_OneData_img/datahub.egi.eu_login8.png b/1.1/docs/howtos/how_to_login_into_OneData_img/datahub.egi.eu_login8.png new file mode 100644 index 0000000000000000000000000000000000000000..109bc11509aaedf225f21e58e23554d06942601f Binary files /dev/null and b/1.1/docs/howtos/how_to_login_into_OneData_img/datahub.egi.eu_login8.png differ diff --git a/1.1/docs/howtos/how_to_login_into_OneData_img/datahub.egi.eu_login9.png b/1.1/docs/howtos/how_to_login_into_OneData_img/datahub.egi.eu_login9.png new file mode 100644 index 0000000000000000000000000000000000000000..c36a34c9479425a351e2c6afaefa983cc0727658 Binary files /dev/null and b/1.1/docs/howtos/how_to_login_into_OneData_img/datahub.egi.eu_login9.png differ diff --git a/1.1/docs/howtos/index.md b/1.1/docs/howtos/index.md new file mode 100644 index 0000000000000000000000000000000000000000..66bc1049b72a65b7aac72bd7835286c3ea05f79d --- /dev/null +++ b/1.1/docs/howtos/index.md @@ -0,0 +1,10 @@ +--- +layout: default +title: HowTo's +has_children: true +permalink: /howtos/ +nav_order: 7 +--- + +# HowTo's + diff --git a/1.1/index.md b/1.1/index.md new file mode 100644 index 0000000000000000000000000000000000000000..5598a20d9c6dc69e4a774f0929856d3bed246f74 --- /dev/null +++ b/1.1/index.md @@ -0,0 +1,13 @@ +--- +layout: default +title: Home +nav_order: 1 +--- + +### Introduction to the Data Management Plan + +A Data Management Plan (DMP) is a formal document that outlines how data are to be handled both during a research project and after the project is completed. + +It is the essential reference to assure the Findability, Accessibility, Interoperability, and Reuse [(FAIR)](https://www.go-fair.org/fair-principles/) of digital assets, establishing the format of data and metadata, how they are generated, stored, and accessed, among other issues. Currently, DMPs are mandatory for data-science and e-science funded grants and indispensable for the sustainability of any long-term project. + +DMPs are living documents that will be amended, improved and detailed along the project timeline. Therefore, DMPs should have a clear version number and include a timetable for updates. The DMPs should have been defined according to the template of the [DMP Online tool](https://dmponline.dcc.ac.uk/), but they could derive into structured documents, as long as maintaining their unity. diff --git a/1.1/rights/AUP.md b/1.1/rights/AUP.md new file mode 100644 index 0000000000000000000000000000000000000000..a623714f32ec4801a8c27751c29dfa0f1a79273a --- /dev/null +++ b/1.1/rights/AUP.md @@ -0,0 +1,26 @@ +--- +layout: default +parent: Rights +nav_order: 2 +--- + + +Acceptable Use Policy (AUP) for LAGO VO +------------------------------------------ + +This Acceptable Use Policy applies to all members of LAGO Virtual Organisation (named as "LAGO-AAI" in GEANT/eduTEAMs and "lagoproject.net" in EGI/check-in), hereafter referred to as LAGO VO, concerning the use of the GEANT/eduTEAMs and the EOSC/EGI Infrastructure. The LAGO Collaboration (http://lagoproject.net) owns and gives authority to this policy. + +Description of the LAGO VO +------------------------------------------ + +The LAGO (Latin American Giant Observatory) project is an extended Astroparticle Observatory at a global scale. It is mainly oriented to basic research on three branches of astroparticle physics: the extreme universe, space weather phenomena, and atmospheric radiation at ground level. The LAGO detection network consists of single or small arrays of particle detectors at ground level, spanning over different sites located at significantly different latitudes (currently from Mexico up to the Antarctic region) and different altitudes (from sea level up to more than 5000 meters over sea level), covering a huge range of geomagnetic rigidity cut-offs and atmospheric absorption/reaction levels. The LAGO Project is operated by the LAGO Collaboration, a non-centralized and distributed collaborative network of more than 100 scientists from more than 30 institutions in 11 countries. Finally, detectors installed in various universities are used as a tool to teach students about particle and astroparticle physics, in particular by leading them to the measurement of the muon decay. + +Goal of the LAGO VO +------------------------------------------ + +The LAGO VO objective is to perform, in a collaborative way, simulations of detectors, to process and to analyse the raw information obtained from them, data curation and reproducibility following FAIR principles. + +Acceptance Clause +------------------------------------------ + +Members and Managers of the LAGO VO agree to be bound by the Acceptable Usage Rules, Security Policy and other relevant GEANT, EOSC and EGI Policies, as well as to use the infrastructure only in the furtherance of the stated goal of the LAGO VO. diff --git a/1.1/rights/index.md b/1.1/rights/index.md new file mode 100644 index 0000000000000000000000000000000000000000..793c44b6df08c62beaacc77146a0711e9160e708 --- /dev/null +++ b/1.1/rights/index.md @@ -0,0 +1,9 @@ +--- +layout: default +title: Rights +has_children: true +permalink: /rights/ +nav_order: 5 +--- + +# Rights diff --git a/1.1/rights/lagoCommonRights.jsonld b/1.1/rights/lagoCommonRights.jsonld new file mode 100644 index 0000000000000000000000000000000000000000..995ee176813b1de74542ffa206e811b757af46a0 --- /dev/null +++ b/1.1/rights/lagoCommonRights.jsonld @@ -0,0 +1,31 @@ +{ + "@context" : { + "@base" : "https://raw.githubusercontent.com/lagoproject/DMP/1.1", + "lago" : "https://raw.githubusercontent.com/lagoproject/DMP/1.1/schema/lagoSchema.jsonld#", + "dct" : "http://purl.org/dc/terms/", + "@vocab" : "https://raw.githubusercontent.com/SEMICeu/DCAT-AP/2.0.0/releases/2.0.0/dcat-ap_2.0.0.jsonld#", + "_dcatap" : "https://raw.githubusercontent.com/SEMICeu/DCAT-AP/2.0.0/releases/2.0.0/dcat-ap_2.0.0.jsonld", + "_dcatap_landing_page" : "http://data.europa.eu/r5r/" + }, +"@id" : "/rights/lagoCommonRights.jsonld", +"title": "Data and Metadata Release, Rights and Disclaimer", +"creator" : [{ "@id" : "https://orcid.org/0000-0002-4559-8785" , "@type" : "lago:Person", "name" : "Hernán Asorey" }, + { "@id" : "https://orcid.org/0000-0003-4115-3129" , "@type" : "lago:Person", "name" : "Iván Sidelnik" }], +"releaseDate": "2022-05-10", +"conformsTo": { "@id" : "https://github.github.com/gfm/" , "@type" : "Document", "title": "GitHub Flavored Markdown Spec", "preferredLabel" :"GFM"}, +"relatedResource" : "https://lagoproject.net/FALTA", +"publisher" : { "@id" : "/defs/lagoCollaboration.jsonld" , "@type" : "lago:Organization", "name" : "LAGO Collaboration" }, +"license" : "https://creativecommons.org/licenses/by-nc-sa/4.0/", +"accessRigths" : "@id", +"descprition" : "By using the data provided by the Latin American Giant Observatory (LAGO), you are accepting the following conditions of release and acknowledging the following disclaimers issued by LAGO.", +"@type": "Document", +"landingPage": "https://lagoproject.github.io/DMP/rights/lagoCommonRights/", +"version":"1.1", +"distribution": { "@id": "/rights/lagoCommonRights.md", + "@type": "Distribution", + "accessURL": "/rights/lagoCommonRights/", + "downloadURL": "/rights/lagoCommonRights.md", + "format": "http://publications.europa.eu/resource/authority/file-type/TXT", + "mediaType": "https://www.iana.org/assignments/media-types/text/markdown" + } +} diff --git a/1.1/rights/lagoCommonRights.md b/1.1/rights/lagoCommonRights.md new file mode 100644 index 0000000000000000000000000000000000000000..ba3f9e4aeb161700913d3b50df7586c8e1dee01d --- /dev/null +++ b/1.1/rights/lagoCommonRights.md @@ -0,0 +1,135 @@ +--- +layout: default +parent: Rights +nav_order: 1 +jsonldinhead: lagoCommonRights.jsonld +--- + +# Data and Metadata Releases, Rights and Disclaimer + +|Tag Release | Issued | Updated | Dates |Contributors| +|------------|----- |-------- |------|------------| +| 1.1 | 2022-05-11 | {{ site.time }} | 2020-06-01 - today | [Hernán Asorey](https://orcid.org/0000-0002-4559-8785) | +| | | | | [Iván Sidelnik](https://orcid.org/0000-0003-4115-3129) | +| | | | | for the [LAGO Collaboration](/DMP/defs/lagoCollaboration/) | + +# Data and Metadata Releases, Rights and Disclaimer +{: .no_toc } + +By using the data provided by the Latin American Giant Observatory (LAGO), you are accepting the following conditions of release and acknowledging the following disclaimers issued by LAGO. + +## Table of contents +{: .no_toc .text-delta } + +- TOC +{:toc} + +## A. Definitions + +### a. The Latin American Giant Observatory +The Latin American Giant Observatory hereinafter referred to as “LAGO” or “the LAGO Observatory”, is an astroparticle observatory on a global scale, working as an integrated detection network, hereinafter referred to as “the LAGO detection network” or simply “the LAGO network”, of single or small arrays of detectors, hereinafter referred to as “the LAGO detectors”, that are deployed at different geographical locations, hereinafter referred as “the LAGO sites”. + +### b. The LAGO Collaboration + +The LAGO Collaboration is a non-centralized, distributed and highly collaborative grid of scientific institutions. The main goal of the LAGO Collaboration is the design, installation, commissioning, operation, coordination, maintenance, and, eventually, the decommissioning of the LAGO Observatory. + +### c. The LAGO Data Management Plan (DMP) and the FAIR paradigm +To guarantee the long-term sustainability of LAGO, it is mandatory to accomplish the FAIR paradigm, i.e., to assure the Findability, Accessibility, Interoperability, and Reusability of its digital assets. The LAGO Data Management Plan, hereinafter referred to as “LAGO DMP” or simply “DMP”, is a living document that will be amended, improved and detailed along the project evolution timeline, and it is used to establish the format of the LAGO data and metadata sets, and to describe how they are generated, stored, accessed, and used internally or externally used. The LAGO DMP is publicly available at https://lagoproject.github.io/DMP/ + +### d. The LAGO Datasets +During its normal operation and the different maintenance modes of the LAGO network, LAGO produces datasets containing different types of data, hereinafter collectively referred to as “the LAGO data” and individually as “a LAGO dataset”. All the LAGO datasets follow standardized schemes based on linked data as described in our DMP. +Any LAGO dataset could be considered within one of these categories: + +#### i. Measured data (Ln) +Corresponds to any type of data that was measured in a LAGO site, including measurements of any type of radiation, atmospheric conditions, geomagnetic, solar irradiation, telemetry, and any other type of measurement produced by the LAGO detector and its peripherals. The LAGO measured data includes also any data product derived by any means of the previously described data. All the LAGO measured datasets are hierarchically tagged with the “Ln” label, being n a sequential number, starting by 0, that indicates the level of data processing: L0 corresponds to the raw data, L1 is the first level of analysed data, etc. + +#### ii. Simulated data (Sn) +A LAGO simulated dataset contains data produced by any means, that were produced by the LAGO Observatory or its members and fellows using any of the LAGO simulation tools, that are intended to emulate any physical processes. All the LAGO measured datasets are hierarchically tagged with the “Sn” label, being n a sequential number. + +#### iii. Metadata (MLn/MSn) +Every LAGO metadata dataset is associated with the corresponding Ln or Sn dataset following the JSON-LD 1.1(W3C) language syntax, and a reprofiled LAGO vocabulary based on the DCAT2-AP2 standard vocabulary, as described in the corresponding section of the LAGO DMP. + +## B. General and specific conditions of data release and acknowledgement + +### a. General conditions +The LAGO data, metadata and schema definitions are available by permission of the LAGO Collaboration as the entity in charge of the Latin American Giant Observatory. The use of any LAGO data in publications or any other scientific activity, either digital or hardcopy, must be acknowledged to The Latin American Giant Observatory as well as their authors and referenced through the corresponding PiDs. +The use of any type of LAGO data and metadata is allowed for non-commercial purposes only, and only so long as attribution is given to the creator. Any other usage of the LAGO data without permission is strictly forbidden. The policies of the LAGO data release are defined by the LAGO Collaboration and could change at any moment. + +### b. Specific conditions + +#### i. Measured data (Ln) +At the moment of the writing of this document, all the measured LAGO data is non-public. Specific conditions related to the release of the LAGO measured dataset will be informed by the LAGO Collaboration in the future. + +#### ii. Simulated data (Sn) +LAGO simulated data (Sn) is licenced under the Creative Commons Attribution Non-Commercial Share Alike 4.0 International (CC BY-NC-SA 4.0) and is publicly available after an embargo period of one (1) year since the LAGO data catalogue publication at the LAGO public data repository. Any usage of the LAGO measured data should follow the general data acknowledgement and cite these references: + +- Christian Sarmiento-Cano, Mauricio Suárez-Durán, Rolando Calderón-Ardila, Adriana Vásquez-Ramírez, Andrei Jaimes-Motta, Luis A. Núñez, Sergio Dasso, Iván Sidelnik, Hernán Asorey, “The ARTI Framework: Cosmic Rays Atmospheric Background Simulations”, DOI:10.48550/arXiv.2010.14591 +- A. J. Rubio-Montero, R. Pagán-Muñoz, R. Mayo-García, A. Pardo-Diaz, I. Sidelnik and H. Asorey, "A Novel Cloud-Based Framework For Standardized Simulations In The Latin American Giant Observatory (LAGO)" 2021 Winter Simulation Conference (WSC), 2021, pp. 1-12, DOI:10.1109/WSC52266.2021.9715360 + +#### iii. Medatata data (MLn/MSn) +Measured (Ln) and Simulated (Sn) data have their own metadata, correspondingly, MLn or SLn. Every metadata dataset inherits the specific conditions, acknowledgements, and references from the corresponding LAGO Measured or Simulated dataset. + +## C. Disclaimer of Liability +Neither LAGO nor contributors of data to LAGO shall be held liable for any improper or incorrect use or application of the data provided, and assume no responsibility for the use or application of the data or information derived from interpretation of the data. In no event shall the LAGO or its collaborators be liable for any direct, indirect, or incidental damage arising from the use or application of these data. This disclaimer of liability applies to any damages or injury, including but not limited to those caused by any failure of performance, error, omission, defect, delay in operation or transmission, computer virus, alteration, use, application, analysis, or interpretation of data. + +## D. Disclaimer of Accuracy of Data +No warranty, expressed or implied, is made regarding the accuracy, adequacy, completeness, reliability, or usefulness of any data provided. These data are provided "as is." All warranties of any kind, expressed or implied, including but not limited to fitness for a particular use, freedom from computer viruses, and non-infringement of proprietary rights, are disclaimed. + +## TECHNICAL APPENDIX: how to linking this document + +As stated above, this document unifies the rights, disclaimers and acknolegmentes for this LAGO data and metadata release. + +To accomplish the linked-data requirements, this document has associated metatada in: +- a JSON-LD file [lagoCommonRights.jsonld](./lagoCommonRights.jsonld) +- a block ```<script type="application/ld+json">```, which shows the later JSON-LD in the ```<head>``` section of this HTML page. + +### How should this be embarransingly referenced? + +- ZENODO DOI +- lagoproject page +- github dynamic page... +- CURL... agains the page. + +### How should this be referenced for linked-data? + +To preserve the provenance of the linked metadata through time, the GitHub raw link of a certain release of this document must be used: + +`https://raw.githubusercontent.com/lagoproject/DMP/`*\<tag release\>*`/rights/lagoCommonRights.jsonld` + +For example: + +[https://raw.githubusercontent.com/lagoproject/DMP/1.1/rights/lagoCommonRights.jsonld](https://raw.githubusercontent.com/lagoproject/DMP/1.1/rights/lagoCommonRights.jsonld) + + +As a real example, the metadata´s catalog of a simulation should include the reference as the [DCAT-AP2](https://joinup.ec.europa.eu/collection/semantic-interoperability-community-semic/solution/dcat-application-profile-data-portals-europe) property [*rights*](https://raw.githubusercontent.com/SEMICeu/DCAT-AP/2.0.0/releases/2.0.0/dcat-ap_2.0.0.jsonld#rigths): + +```json +{ +"@context":{ +... + "lago":"https://raw.githubusercontent.com/lagoproject/DMP/1.1/schema/lagoSchema.jsonld", + "@vocab":"https://raw.githubusercontent.com/SEMICeu/DCAT-AP/2.0.0/releases/2.0.0/dcat-ap_2.0.0.jsonld", +... + }, +"@id":"/sac_60_100.0_75600_QGSII_flat", +"@type":"Catalogue", +... +"license":"https://creativecommons.org/licenses/by-nc-sa/4.0/" +"rights":"https://raw.githubusercontent.com/lagoproject/DMP/1.1/rights/lagoCommonRights.jsonld", +"accessRigths":"http://publications.europa.eu/resource/authority/access-right/RESTRICTED", +"creator":{ + "@id":"https://orcid.org/0000-0001-6497-753X", + "@type":"lago:Person" + }, +... +... +``` + +#### The plain JSON-LD file + +```json +{% include_relative lagoCommonRights.jsonld %} +``` + + + diff --git a/1.1/schema/examples/sims/SimulationCatalog.jsonld b/1.1/schema/examples/sims/SimulationCatalog.jsonld new file mode 100644 index 0000000000000000000000000000000000000000..4a6277776df4e2b5f55216b5784e711e05618339 --- /dev/null +++ b/1.1/schema/examples/sims/SimulationCatalog.jsonld @@ -0,0 +1,64 @@ +{ +"@context":{ + "@base":"https://mon01-tic.ciemat.es/api/v3/oneprovider/metadata/json/LAGOsim", + "_@base":"https://hdl.handle.net/21.T11998/0000-001A-6C0D-E?urlappend=", + "@vocab":"https://github.com/SEMICeu/DCAT-AP/blob/2.0.0/releases/2.0.0/dcat-ap_2.0.0.jsonld", + "_dcatap":"https://github.com/SEMICeu/DCAT-AP/blob/2.0.0/releases/2.0.0/dcat-ap_2.0.0.jsonld", + "_dcatap_landing_page":"http://data.europa.eu/r5r/", + "lago":"https://github.com/lagoproject/DMP/blob/0.0.1/schema/lagoSchema.jsonld", + "prov":"http://www.w3.org/ns/prov#", + "dct":"http://purl.org/dc/terms/" + }, +"@id":"/sac_60_100.0_75600_QGSII_flat","@type":"Catalog", +"title":"sac_60_100.0_75600_QGSII_flat", +"description":"A Complete Corsika Simulation", +"publisher":{ + "@id":"https://github.com/lagoproject/DMP/blob/0.0.1/defs/lagocollaboration.jsonld", + "@type":"lago:Organization" + }, +"wasGeneratedBy":"/sac_60_100.0_75600_QGSII_flat#activity", +"license":"https://creativecommons.org/licenses/by-nc-sa/4.0/" +"rights":"https://github.com/lagoproject/DMP/blob/0.0.1/rights/lagoCommonRights.jsonld", +"accessRigths":"http://publications.europa.eu/resource/authority/access-right/RESTRICTED", +"creator":{ + "@id":"https://orcid.org/0000-0001-6497-753X", + "@type":"lago:Person" + }, +"_landing_page":"https://datahub.egi.eu/TOPUBLISH", +"dataset":["/sac_60_100.0_75600_QGSII_flat/DAT080014-0014-00000017573.input", +"/sac_60_100.0_75600_QGSII_flat/DAT080014-0014-00000017573.lst.bz2","/sac_60_100.0_75600_QGSII_flat/DAT080014.bz2","/sac_60_100.0_75600_QGSII_flat/DAT070014-0014-00000017573.input","/sac_60_100.0_75600_QGSII_flat/DAT070014-0014-00000017573.lst.bz2","/sac_60_100.0_75600_QGSII_flat/DAT070014.bz2","/sac_60_100.0_75600_QGSII_flat/DAT060014-0014-00000017573.input","/sac_60_100.0_75600_QGSII_flat/DAT060014-0014-00000017573.lst.bz2","/sac_60_100.0_75600_QGSII_flat/DAT060014.bz2","/sac_60_100.0_75600_QGSII_flat/DAT050014-0014-00000017573.input","/sac_60_100.0_75600_QGSII_flat/DAT050014-0014-00000017573.lst.bz2","/sac_60_100.0_75600_QGSII_flat/DAT050014.bz2","/sac_60_100.0_75600_QGSII_flat/DAT040014-0014-00000017573.input","/sac_60_100.0_75600_QGSII_flat/DAT040014-0014-00000017573.lst.bz2","/sac_60_100.0_75600_QGSII_flat/DAT040014.bz2","/sac_60_100.0_75600_QGSII_flat/DAT030014-0014-00000017573.input","/sac_60_100.0_75600_QGSII_flat/DAT030014-0014-00000017573.lst.bz2","/sac_60_100.0_75600_QGSII_flat/DAT030014.bz2","/sac_60_100.0_75600_QGSII_flat/DAT020014-0014-00000017573.input","/sac_60_100.0_75600_QGSII_flat/DAT020014-0014-00000017573.lst.bz2","/sac_60_100.0_75600_QGSII_flat/DAT020014.bz2","/sac_60_100.0_75600_QGSII_flat/DAT010014-0014-00000017573.input","/sac_60_100.0_75600_QGSII_flat/DAT010014-0014-00000017573.lst.bz2","/sac_60_100.0_75600_QGSII_flat/DAT010014.bz2","/sac_60_100.0_75600_QGSII_flat/DAT010402-0402-00000014149.input","/sac_60_100.0_75600_QGSII_flat/DAT010402-0402-00000014149.lst.bz2","/sac_60_100.0_75600_QGSII_flat/DAT010402.bz2","/sac_60_100.0_75600_QGSII_flat/DAT004521-4521-00000000006.input","/sac_60_100.0_75600_QGSII_flat/DAT004521-4521-00000000006.lst.bz2","/sac_60_100.0_75600_QGSII_flat/DAT004521.bz2","/sac_60_100.0_75600_QGSII_flat/DAT003517-3517-00000000002.input","/sac_60_100.0_75600_QGSII_flat/DAT003517-3517-00000000002.lst.bz2","/sac_60_100.0_75600_QGSII_flat/DAT003517.bz2","/sac_60_100.0_75600_QGSII_flat/DAT003115-3115-00000000003.input","/sac_60_100.0_75600_QGSII_flat/DAT003115-3115-00000000003.lst.bz2","/sac_60_100.0_75600_QGSII_flat/DAT003115.bz2","/sac_60_100.0_75600_QGSII_flat/DAT005123-5123-00000000012.input","/sac_60_100.0_75600_QGSII_flat/DAT005123-5123-00000000012.lst.bz2","/sac_60_100.0_75600_QGSII_flat/DAT005123.bz2","/sac_60_100.0_75600_QGSII_flat/DAT003919-3919-00000000004.input","/sac_60_100.0_75600_QGSII_flat/DAT003919-3919-00000000004.lst.bz2","/sac_60_100.0_75600_QGSII_flat/DAT003919.bz2","/sac_60_100.0_75600_QGSII_flat/DAT005525-5525-00000000015.input","/sac_60_100.0_75600_QGSII_flat/DAT005525-5525-00000000015.lst.bz2","/sac_60_100.0_75600_QGSII_flat/DAT005525.bz2","/sac_60_100.0_75600_QGSII_flat/DAT004822-4822-00000000009.input","/sac_60_100.0_75600_QGSII_flat/DAT004822-4822-00000000009.lst.bz2","/sac_60_100.0_75600_QGSII_flat/DAT004822.bz2","/sac_60_100.0_75600_QGSII_flat/DAT004018-4018-00000000005.input","/sac_60_100.0_75600_QGSII_flat/DAT004018-4018-00000000005.lst.bz2","/sac_60_100.0_75600_QGSII_flat/DAT004018.bz2","/sac_60_100.0_75600_QGSII_flat/DAT005224-5224-00000000014.input","/sac_60_100.0_75600_QGSII_flat/DAT005224-5224-00000000014.lst.bz2","/sac_60_100.0_75600_QGSII_flat/DAT005224.bz2","/sac_60_100.0_75600_QGSII_flat/DAT001909-1909-00000000007.input","/sac_60_100.0_75600_QGSII_flat/DAT001909-1909-00000000007.lst.bz2","/sac_60_100.0_75600_QGSII_flat/DAT001909.bz2","/sac_60_100.0_75600_QGSII_flat/DAT004020-4020-00000000008.input","/sac_60_100.0_75600_QGSII_flat/DAT004020-4020-00000000008.lst.bz2","/sac_60_100.0_75600_QGSII_flat/DAT004020.bz2","/sac_60_100.0_75600_QGSII_flat/DAT002311-2311-00000000010.input","/sac_60_100.0_75600_QGSII_flat/DAT002311-2311-00000000010.lst.bz2","/sac_60_100.0_75600_QGSII_flat/DAT002311.bz2","/sac_60_100.0_75600_QGSII_flat/DAT002713-2713-00000000011.input","/sac_60_100.0_75600_QGSII_flat/DAT002713-2713-00000000011.lst.bz2","/sac_60_100.0_75600_QGSII_flat/DAT002713.bz2","/sac_60_100.0_75600_QGSII_flat/DAT003216-3216-00000000013.input","/sac_60_100.0_75600_QGSII_flat/DAT003216-3216-00000000013.lst.bz2","/sac_60_100.0_75600_QGSII_flat/DAT003216.bz2","/sac_60_100.0_75600_QGSII_flat/DAT000904-0904-00000000042.input","/sac_60_100.0_75600_QGSII_flat/DAT000904-0904-00000000042.lst.bz2","/sac_60_100.0_75600_QGSII_flat/DAT000904.bz2","/sac_60_100.0_75600_QGSII_flat/DAT005626-5626-00000000049.input","/sac_60_100.0_75600_QGSII_flat/DAT005626-5626-00000000049.lst.bz2","/sac_60_100.0_75600_QGSII_flat/DAT005626.bz2","/sac_60_100.0_75600_QGSII_flat/DAT002010-2010-00000000065.input","/sac_60_100.0_75600_QGSII_flat/DAT002010-2010-00000000065.lst.bz2","/sac_60_100.0_75600_QGSII_flat/DAT002010.bz2","/sac_60_100.0_75600_QGSII_flat/DAT001407-1407-00000000074.input","/sac_60_100.0_75600_QGSII_flat/DAT001407-1407-00000000074.lst.bz2","/sac_60_100.0_75600_QGSII_flat/DAT001407.bz2","/sac_60_100.0_75600_QGSII_flat/DAT002814-2814-00000000081.input","/sac_60_100.0_75600_QGSII_flat/DAT002814-2814-00000000081.lst.bz2","/sac_60_100.0_75600_QGSII_flat/DAT002814.bz2","/sac_60_100.0_75600_QGSII_flat/DAT001105-1105-00000000099.input","/sac_60_100.0_75600_QGSII_flat/DAT001105-1105-00000000099.lst.bz2","/sac_60_100.0_75600_QGSII_flat/DAT001105.bz2","/sac_60_100.0_75600_QGSII_flat/DAT002412-2412-00000000084.input","/sac_60_100.0_75600_QGSII_flat/DAT002412-2412-00000000084.lst.bz2","/sac_60_100.0_75600_QGSII_flat/DAT002412.bz2","/sac_60_100.0_75600_QGSII_flat/DAT000703-0703-00000000144.input","/sac_60_100.0_75600_QGSII_flat/DAT000703-0703-00000000144.lst.bz2","/sac_60_100.0_75600_QGSII_flat/DAT000703.bz2","/sac_60_100.0_75600_QGSII_flat/DAT001608-1608-00000000353.input","/sac_60_100.0_75600_QGSII_flat/DAT001608-1608-00000000353.lst.bz2","/sac_60_100.0_75600_QGSII_flat/DAT001608.bz2","/sac_60_100.0_75600_QGSII_flat/DAT001206-1206-00000000365.input","/sac_60_100.0_75600_QGSII_flat/DAT001206-1206-00000000365.lst.bz2","/sac_60_100.0_75600_QGSII_flat/DAT001206.bz2"], +"@graph":[ + { + "@id":"/sac_60_100.0_75600_QGSII_flat#artiParams", + "@type":"lago:ArtiParams", + "lago:cherenkov":False, + "lago:debug":False, + "lago:highEnergyIntModel":"QGSII", + "lago:detectorSite":"https://github.com/lagoproject/DMP/blob/0.0.1/defs/sitesLago.jsonld#sac", + "lago:obsLev":100, + "lago:highEnergyCutsSecondaries": False, + "lago:fluxTime":"Psac_60_100.0_75600_QGSII_flatS", + "lago:flatArray":True + }, + { + "@id":"/sac_60_100.0_75600_QGSII_flat#activity", + "@type":"prov:Activity", + "prov:endedAtTime":"2020-09-07T15:17:51.593134Z", + "prov:startedAtTime":"2020-09-07T15:13:42.073838Z", + "prov:used":"/sac_60_100.0_75600_QGSII_flat#artiParams" + "prov:wasAssociatedWith":{ + "@id":"https://api.github.com/repos/lagoproject/arti/git/commits/a761dfe63e9f72e2dcfe106d314de28b6148b78b", + "@type":"lago:Software", + "name":"arti", + "sdo:codeRepository":"https://github.com/lagoproject/arti/tree/a761dfe63e9f72e2dcfe106d314de28b6148b78b", + "lago:runtimePlatform":{ + "@id:":"https://api.github.com/repos/lagoproject/onedataSim/git/commits/69f665c3f4767699844f95728b6be1fe0c481142", + "@type":"lago:Software", + "name":"onedataSim", + "sdo:codeRepository":"https://github.com/lagoproject/onedataSim/69f665c3f4767699844f95728b6be1fe0c481142" + } + } + + } + ] +} diff --git a/1.1/schema/examples/sims/SimulationInputDataset.jsonld b/1.1/schema/examples/sims/SimulationInputDataset.jsonld new file mode 100644 index 0000000000000000000000000000000000000000..6e751a6b71939c5ed479d35962969351bce066f5 --- /dev/null +++ b/1.1/schema/examples/sims/SimulationInputDataset.jsonld @@ -0,0 +1,96 @@ +{ +"@context":{ + "@base":"https://mon01-tic.ciemat.es/api/v3/oneprovider/metadata/json/LAGOsim", + "_@base":"https://hdl.handle.net/21.T11998/0000-001A-6C0D-E?urlappend=", + "@vocab":"https://github.com/SEMICeu/DCAT-AP/blob/2.0.0/releases/2.0.0/dcat-ap_2.0.0.jsonld", + "_dcatap":"https://github.com/SEMICeu/DCAT-AP/blob/2.0.0/releases/2.0.0/dcat-ap_2.0.0.jsonld", + "_dcatap_landing_page":"http://data.europa.eu/r5r/", + "lago":"https://github.com/lagoproject/DMP/blob/0.0.1/schema/lagoSchema.jsonld", + "prov":"http://www.w3.org/ns/prov#", + "dct":"http://purl.org/dc/terms/" + }, +"@id":"/sac_60_100.0_75600_QGSII_flat/DAT000703-0703-00000000144.input", +"@type":"DataSet", +"description":"CORSIKA DAT000703-0703-00000000144.input", +"title":"sac_60_100.0_75600_QGSII_flat_DAT000703-0703-00000000144.input", +"publisher":{ + "@id":"https://github.com/lagoproject/DMP/blob/0.0.1/defs/lagocollaboration.jsonld", + "@type":"lago:Organization" + }, +"license":"https://creativecommons.org/licenses/by-nc-sa/4.0/", +"rights":"https://github.com/lagoproject/DMP/blob/0.0.1/rights/lagoCommonRights.jsonld", +"accessRigths":"http://publications.europa.eu/resource/authority/access-right/RESTRICTED", +"creator":{ + "@id":"https://orcid.org/0000-0001-6497-753X", + "@type":"lago:Person" + }, +"wasGeneratedBy":"/sac_60_100.0_75600_QGSII_flat/DAT000703-0703-00000000144.input#activity", +"distribution":"/sac_60_100.0_75600_QGSII_flat/DAT000703-0703-00000000144.input#distribution", +"dct:hasFormat":"/sac_60_100.0_75600_QGSII_flat/DAT000703-0703-00000000144.input#corsikainput", +"qualifiedAttribution":{ + "@id":"https://orcid.org/0000-0001-6497-753X", + "@type":"lago:Person" + }, +"@graph":[ + { + "@id" : "//sac_60_100.0_75600_QGSII_flat/DAT000703-0703-00000000144.input#corsikainput", + "@type" : "lago:CorsikaInput", + "dct:isFormatOf" : "/sac_60_100.0_75600_QGSII_flat/DAT000703-0703-00000000144.input", + "lago:atmcrd" : { + "@type": "lago:Atmod", + "lago:modatm" : "10" + }, + "lago:obsLev" : "1e2", + "lago:magnet" : { + "lago:bx" : "20.94", + "lago:bz" : "-8.91" + } + }, + { + "@id":"/sac_60_100.0_75600_QGSII_flat/DAT000703-0703-00000000144.input#dataservice", + "@type":"DataService", + "title":"sac_60_100.0_75600_QGSII_flat_DAT000703-0703-00000000144.input_CDMI", + "endpointURL":"HANDLECDMI/sac_60_100.0_75600_QGSII_flat/DAT000703-0703-00000000144.input", + "conformsTo":"https://www.iana.org/assignments/media-types/application/cdmi-object", + "servesDataset":"/sac_60_100.0_75600_QGSII_flat/DAT000703-0703-00000000144.input" + }, + { + "@id":"/sac_60_100.0_75600_QGSII_flat/DAT000703-0703-00000000144.input#activity", + "@type":"prov:Activity", + "prov:endedAtTime":"2020-09-07T15:14:14.916595Z", + "prov:startedAtTime":"2020-09-07T15:14:09.240080Z", + "prov:used":"/sac_60_100.0_75600_QGSII_flat#artiParams", + "prov:wasAssociatedWith":{ + "@id":"https://api.github.com/repos/lagoproject/arti/git/commits/a761dfe63e9f72e2dcfe106d314de28b6148b78b", + "@type":"lago:Software", + "name":"arti", + "sdo:codeRepository":"https://github.com/lagoproject/arti/tree/a761dfe63e9f72e2dcfe106d314de28b6148b78b", + "lago:runtimePlatform":{ + "@id:":"https://api.github.com/repos/lagoproject/onedataSim/git/commits/69f665c3f4767699844f95728b6be1fe0c481142", + "@type":"lago:Software", + "name":"onedataSim", + "sdo:codeRepository":"https://github.com/lagoproject/onedataSim/69f665c3f4767699844f95728b6be1fe0c481142" + } + } + }, + { + "@id":"/sac_60_100.0_75600_QGSII_flat/DAT000703-0703-00000000144.input#distribution", + "@type":"Distribution", + "accessService":"/sac_60_100.0_75600_QGSII_flat/DAT000703-0703-00000000144.input#dataservice", + "_accessURL": "https://datahub.egi.eu/TOPUBLISH", + "format":"http://publications.europa.eu/resource/authority/file-type/TXT", + "mediaType":"http://www.iana.org/assignments/media-types/text", + "publisher":{ + "@id":"https://github.com/lagoproject/DMP/blob/0.0.1/defs/lagocollaboration.jsonld", + "@type":"lago:Organization" + }, + "license":"https://creativecommons.org/licenses/by-nc-sa/4.0/", + "rights":"https://github.com/lagoproject/DMP/blob/0.0.1/rights/lagoCommonRights.jsonld", + "accessRigths":"http://publications.europa.eu/resource/authority/access-right/RESTRICTED", + "creator":{ + "@id":"https://orcid.org/0000-0001-6497-753X", + "@type":"lago:Person" + } + } + ] +} diff --git a/1.1/schema/examples/sims/SimulationOutBinDataset.jsonld b/1.1/schema/examples/sims/SimulationOutBinDataset.jsonld new file mode 100644 index 0000000000000000000000000000000000000000..097cdebbd6735a469a917a7cb45c4275033c8672 --- /dev/null +++ b/1.1/schema/examples/sims/SimulationOutBinDataset.jsonld @@ -0,0 +1,75 @@ +{ +"@context":{ + "@base":"https://mon01-tic.ciemat.es/api/v3/oneprovider/metadata/json/LAGOsim", + "_@base":"https://hdl.handle.net/21.T11998/0000-001A-6C0D-E?urlappend=", + "@vocab":"https://github.com/SEMICeu/DCAT-AP/blob/2.0.0/releases/2.0.0/dcat-ap_2.0.0.jsonld", + "_dcatap":"https://github.com/SEMICeu/DCAT-AP/blob/2.0.0/releases/2.0.0/dcat-ap_2.0.0.jsonld", + "_dcatap_landing_page":"http://data.europa.eu/r5r/", + "lago":"https://github.com/lagoproject/DMP/blob/0.0.1/schema/lagoSchema.jsonld", + "prov":"http://www.w3.org/ns/prov#", + "dct":"http://purl.org/dc/terms/" + }, +"@id":"/sac_10_100.0_75600_QGSII_flat/DAT000703.bz2","@type":"DataSet", +"description":"CORSIKA DAT000703.bz2","distribution":"/sac_10_100.0_75600_QGSII_flat/DAT000703.bz2#distribution", +"title":"sac_10_100.0_75600_QGSII_flat_DAT000703.bz2", +"publisher":{ + "@id":"https://github.com/lagoproject/DMP/blob/0.0.1/defs/lagoCollaboration.jsonld", + "@type":"lago:Organization" + }, +"license":"https://creativecommons.org/licenses/by-nc-sa/4.0/", +"rights":"https://github.com/lagoproject/DMP/blob/0.0.1/rights/lagoCommonRights.jsonld", +"accessRigths":"http://publications.europa.eu/resource/authority/access-right/RESTRICTED", +"creator":{ + "@id":"https://orcid.org/0000-0001-6497-753X", + "@type":"lago:Person" + }, +"wasGeneratedBy":"/sac_10_100.0_75600_QGSII_flat/DAT000703.bz2#activity", +"distribution":"/sac_60_100.0_75600_QGSII_flat/DAT000703.bz2#distribution", +"qualifiedAttribution":{ + "@id":"https://orcid.org/0000-0001-6497-753X", + "@type":"lago:Person" + }, +"@graph":[ + { + "@id":"/sac_10_100.0_75600_QGSII_flat/DAT000703.bz2#dataservice", + "@type":"DataService", + "title":"sac_10_100.0_75600_QGSII_flat_DAT000703.bz2_CDMI", + "conformsTo":"https://www.iana.org/assignments/media-types/application/cdmi-object", + "endpointURL":"https://mon01-tic.ciemat.es/cdmi/sac_10_100.0_75600_QGSII_flat/DAT000703.bz2", + "servesDataset":"/sac_10_100.0_75600_QGSII_flat/DAT000703.bz2" + }, + { + "@id":"/sac_10_100.0_75600_QGSII_flat/DAT000703.bz2#activity", + "@type":"prov:Activity", + "prov:endedAtTime":"2020-09-07T18:36:00.431229Z", + "prov:startedAtTime":"2020-09-07T18:35:53.630425Z", + "prov:wasAssociatedWith":{ + "@id":"https://mon01-tic.ciemat.es/cdmi/LAGOsoft/corsika/corsika-75600-lago.tar.gz", + "@type":"lago:Software", + "name":"CORSIKA 75600 for LAGO Collaboration", + "lago:runtimePlatform":{ + "@id:":"https://api.github.com/repos/lagoproject/onedataSim/git/commits/69f665c3f4767699844f95728b6be1fe0c481142", + "@type":"lago:Software", + "name":"onedataSim", + "sdo:codeRepository":"https://github.com/lagoproject/onedataSim/69f665c3f4767699844f95728b6be1fe0c481142" + } + }, + "prov:used":"/sac_10_100.0_75600_QGSII_flat/DAT000703-0703-00000000024.input" + }, + { + "@id":"/sac_10_100.0_75600_QGSII_flat/DAT000703.bz2#distribution", + "@type":"Distribution", + "accessService":"/sac_10_100.0_75600_QGSII_flat/DAT000703.bz2#dataservice", + "mediaType":"https://www.iana.org/assignments/media-types/application/octet-stream", + "_accessURL":"https://datahub.egi.eu/TOPUBLISH", + "format":"http://publications.europa.eu/resource/authority/file-type/BIN", + "license":"https://creativecommons.org/licenses/by-nc-sa/4.0/", + "rights":"https://github.com/lagoproject/DMP/blob/0.0.1/rights/lagoCommonRights.jsonld", + "accessRigths":"http://publications.europa.eu/resource/authority/access-right/RESTRICTED", + "creator":{ + "@id":"https://orcid.org/0000-0001-6497-753X", + "@type":"lago:Person" + }, + } + ] +} diff --git a/1.1/schema/examples/sims/SimulationOutLstDataset.jsonld b/1.1/schema/examples/sims/SimulationOutLstDataset.jsonld new file mode 100644 index 0000000000000000000000000000000000000000..d5e2670d416f6711b17158b99ea9e8f907b07942 --- /dev/null +++ b/1.1/schema/examples/sims/SimulationOutLstDataset.jsonld @@ -0,0 +1,80 @@ +{ +"@context":{ + "@base":"https://mon01-tic.ciemat.es/api/v3/oneprovider/metadata/json/LAGOsim", + "_@base":"https://hdl.handle.net/21.T11998/0000-001A-6C0D-E?urlappend=", + "@vocab":"https://github.com/SEMICeu/DCAT-AP/blob/2.0.0/releases/2.0.0/dcat-ap_2.0.0.jsonld", + "_dcatap":"https://github.com/SEMICeu/DCAT-AP/blob/2.0.0/releases/2.0.0/dcat-ap_2.0.0.jsonld", + "_dcatap_landing_page":"http://data.europa.eu/r5r/", + "lago":"https://github.com/lagoproject/DMP/blob/0.0.1/schema/lagoSchema.jsonld", + "prov":"http://www.w3.org/ns/prov#", + "dct":"http://purl.org/dc/terms/" + }, +"@id":"/sac_60_100.0_75600_QGSII_flat/DAT000703-0703-00000000144.lst.bz2", +"@type":"DataSet", +"description":"CORSIKA DAT000703-0703-00000000144.lst.bz2", +"title":"sac_60_100.0_75600_QGSII_flat_DAT000703-0703-00000000144.lst.bz2", +"publisher":{ + "@id":"https://github.com/lagoproject/DMP/blob/0.0.1/defs/lagoCollaboration.jsonld", + "@type":"lago:Organization" + }, +"license":"https://creativecommons.org/licenses/by-nc-sa/4.0/", +"rights":"https://github.com/lagoproject/DMP/blob/0.0.1/rights/lagoCommonRights.jsonld", +"accessRigths":"http://publications.europa.eu/resource/authority/access-right/RESTRICTED", +"creator":{ + "@id":"https://orcid.org/0000-0001-6497-753X", + "@type":"lago:Person" + }, +"wasGeneratedBy":"/sac_60_100.0_75600_QGSII_flat/DAT000703-0703-00000000144.lst.bz2#activity", +"distribution":"/sac_60_100.0_75600_QGSII_flat/DAT000703-0703-00000000144.lst.bz2#distribution", +"qualifiedAttribution":{ + "@id":"https://orcid.org/0000-0001-6497-753X", + "@type":"lago:Person" + }, +"@graph":[ + { + "@id":"/sac_60_100.0_75600_QGSII_flat/DAT000703-0703-00000000144.lst.bz2#dataservice", + "@type":"DataService", + "title":"sac_60_100.0_75600_QGSII_flat_DAT000703-0703-00000000144.lst.bz2_CDMI", + "endpointURL":"https://mon01-tic.ciemat.es/cdmi/LAGOsim/sac_60_100.0_75600_QGSII_flat/DAT000703-0703-00000000144.lst.bz2", + "conformsTo":"https://www.iana.org/assignments/media-types/application/cdmi-object", + "servesDataset":"/sac_60_100.0_75600_QGSII_flat/DAT000703-0703-00000000144.lst.bz2" + }, + { + "@id":"/sac_60_100.0_75600_QGSII_flat/DAT000703-0703-00000000144.lst.bz2#activity", + "@type":"prov:Activity", + "prov:endedAtTime":"2020-09-07T15:14:14.916595Z", + "prov:startedAtTime":"2020-09-07T15:14:09.240080Z", + "prov:wasAssociatedWith":{ + "@id":"https://mon01-tic.ciemat.es/cdmi/LAGOsoft/corsika/corsika-75600-lago.tar.gz", + "@type":"lago:Software", + "name":"CORSIKA 75600 for LAGO Collaboration", + "lago:runtimePlatform":{ + "@id:":"https://api.github.com/repos/lagoproject/onedataSim/git/commits/69f665c3f4767699844f95728b6be1fe0c481142", + "@type":"lago:Software", + "name":"onedataSim", + "sdo:codeRepository":"https://github.com/lagoproject/onedataSim/69f665c3f4767699844f95728b6be1fe0c481142" + } + }, + "prov:used":"/sac_60_100.0_75600_QGSII_flat/DAT000703-0703-00000000144.input" + }, + { + "@id":"/sac_60_100.0_75600_QGSII_flat/DAT000703-0703-00000000144.lst.bz2#distribution", + "@type":"Distribution", + "_accessURL":"https://datahub.egi.eu/TOPUBLISH", + "format":"http://publications.europa.eu/resource/authority/file-type/TXT", + "mediaType":"http://www.iana.org/assignments/media-types/text", + "accessService":"/sac_60_100.0_75600_QGSII_flat/DAT000703-0703-00000000144.lst.bz2#dataservice", + "publisher":{ + "@id":"https://github.com/lagoproject/DMP/blob/0.0.1/defs/lagocollaboration.jsonld", + "@type":"lago:Organization" + }, + "license":"https://creativecommons.org/licenses/by-nc-sa/4.0/", + "rights":"https://github.com/lagoproject/DMP/blob/0.0.1/rights/lagoCommonRights.jsonld", + "accessRigths":"http://publications.europa.eu/resource/authority/access-right/RESTRICTED", + "creator":{ + "@id":"https://orcid.org/0000-0001-6497-753X", + "@type":"lago:Person" + } + } + ] +} diff --git a/1.1/schema/examples/sims/simulationExample.md b/1.1/schema/examples/sims/simulationExample.md new file mode 100644 index 0000000000000000000000000000000000000000..1f72e45c988088fb223e67e427e34aeb52b73212 --- /dev/null +++ b/1.1/schema/examples/sims/simulationExample.md @@ -0,0 +1,38 @@ +--- +layout: default +parent: Metadata Schema +order: 4 +--- + +# Simulation Example + +This is the metadata generated by onedataSim for a complete ARTI/CORSIKA simulation. + +The complete simulation corresponds to a catalog in DCAT-AP2 schema vocabulary, equivalent to a directory in a filesystem. +Every file related to CORSIKA is stored together with the associated metadata to guarantee its provenance. + +## Metadata for the Catalog + +```json +{% include_relative SimulationCatalog.jsonld %} +``` + +## Metadata for a DAT\<filecode\>.input + +```json +{% include_relative SimulationInputDataset.jsonld %} +``` + +## Metadata for a DAT\<prmpar\>.bz2 + +```json +{% include_relative SimulationOutBinDataset.jsonld %} +``` + +## Metadata for a DAT\<filecode\>.lst.bz2 + +```json +{% include_relative SimulationOutLstDataset.jsonld %} +``` + + diff --git a/1.1/schema/index.md b/1.1/schema/index.md new file mode 100644 index 0000000000000000000000000000000000000000..93e016748059d773cf1d5d10edce94c22fc8664e --- /dev/null +++ b/1.1/schema/index.md @@ -0,0 +1,14 @@ +--- +layout: default +title: Metadata Schema +has_children: true +permalink: /schema/ +nav_order: 3 +--- + +# Metadata Vocabulary and examples + +This section deals with the definition of a specific metadata vocabulary for LAGO computation, based on the current standards widely accepted by the scientific community. Additionally, compiles real examples of the use of this schema. + + + diff --git a/1.1/schema/lagoSchema.jsonld b/1.1/schema/lagoSchema.jsonld new file mode 100644 index 0000000000000000000000000000000000000000..d2aacd2c3d1e263a92b5df1c8cf692163b13c65d --- /dev/null +++ b/1.1/schema/lagoSchema.jsonld @@ -0,0 +1,376 @@ +{ +"@graph": [ +{"_comment" : "------ Some prov:Agent that acts in LAGO proccesses : Person, Organization and Software. Defining these claess is not our business far away that were univocally identified and conforms to DCAP-AP --------"}, + { + "@id": "lago:Person", + "@type": "sdo:Person", + "owl:equivalentClass" : "foaf:Person", + "dcat:subClassOf" : "Agent", + "seeAlso" : ["foaf:Person", "sdo:Person", "Agent"], + "comment" : [ { "@language" : "en", "@value" : "You must use the ORCID link as @id of this Class. ORCID is currently only using the Schema.org vocabulary for JSON-LD. sdo:Person is explicitely defined as a equivalent class in Schema.org and can be considered as a extension of foaf:Person. Therefore, it could be used in DCAT-AP as subclass of Agent (formerly as foaf:Agent), providing the @id as the ORCID URI (https://orcid.org/yyyy-zzzz-wwww-xxxx), and the required Agent:name property." }, + { "@language" : "es", "@value" : "Se debe usar en enlace ORCID como @id de esta Clase. Actualmente ORCID utiliza únicamente el vocabulario Schema.org para JSON-LD. La definición de sdo:Person en Schema.org indica explicitamente la equivalencia con foaf:Person y puede considerarse una extensión. Por lo tanto podrÃÂa usarse en DCAT-AP como subclase de Agent, (formalmente definida como foaf:Agent), ya que proporciona el id@ como la URI ORCID (https://orcid.org/yyyy-zzzz-wwww-xxxx), y la propiedad obligatoria Agent:name ." } ] + }, + { + "@id": "lago:Organization", + "@type": "foaf:Organization", + "dcat:subClassOf" : "Agent", + "name": { + "@id" : "http://xmlns.com/foaf/0.1/name", + "@type" : "http://www.w3.org/2001/XMLSchema#string", + "owl:equivalentProperty" : { "@id": "http://www.w3.org/2000/01/rdf-schema#label" } + }, + "seeAlso" : [ "foaf:Organization", "Agent"], + "comment" : [ { "@language" : "en", "@value" : "" }, + { "@language" : "es", "@value" : "Se debe usar el enlace simple al LCNAF-Corporate Name de la LiberÃa del Congreso de EEUU http://id.loc.gov/rwo/agents/<LCCN> como @id de esta clase. A diferencia de de sdo:Person con ORCID, no existe un registro de organizaciones con una API que devuelva JSON+LD con un vocabulario/esquema simplificado. De las dos opciones más adecuadas, ISNI.org, no tiene API JSON (está en desarrollo) y no contiene todas las organizaciones. La otra opción es la LibrerÃa del Congreso de EEUU, que asigna un identificador único LCCN para cada LC Name Authority File (LCNAF) - Corporate Name y permite consultar sus datos en formato SKOS/JSON, usando la API JSON+LD a traves de los servicios web http://id.loc.gov/authorities/names/<LCCN> (modo extendido) o http://id.loc.gov/rwo/agents/<LCCN> (modo simplificado). El problema es que aún usando el modo simplificado la información puede ser excesiva, ya que enlaza a trabajos publicados. Sin embargo en el JSON se puede identificar claramente que junto con el @id del modo simplificado aparece el tipo de clase http://xmlns.com/foaf/0.1/Organization y la propiedad rdf-schema#label con su @value el nombre de la organización. Se equipara Agent:name con rdfs:label" } ] + }, + { + "@id": "lago:Software", + "@type": "sdo:SoftwareSourceCode", + "owl:equivalentClass" : "prov:SoftwareAgent", + "dcat:subClassOf" : "Agent", + "sdo:codeRepository" : { "@type" : "sdo:URL" }, + "sdo:runtimePlatform" : {"@type" : "lago:runtimePlatform" }, + "seeAlso" : [ "prov:SoftwareAgent", "sdo:SoftwareSourceCode", "Agent"], + "comment" : [ { "@language" : "en", "@value" : "It identifies any concrete release of software used for simulation, measure, cleaning or analysis procedures. It always refers to a COMMIT in the source code, identified with a HASH at the CVS (but, it will be needed, a compressed file, using other type of hasisng, such as MD5SUM, to guarantee its immutability). Therefore, in GitHub, the @id is the link for the COMMIT (https://api.github.com/org/repo/git/commits/COMMIT_HASH and the sdo:codeRepository will be these COMMIT but browsable for humans ( https://github.com/org/repo/tree/COMMIT_HASH). It is mandatory assign an Agent:name. However, it is optional to use sdo:runtimePlatform (redefined as lago:runtimePlatform) to point to other lago:Software on which it was executed, for example to some deployment with Docker in GitHub." }, + { "@language" : "es", "@value" : "Identifica una versión concreta de un software usado para simular, medir, limpiar o analizar los datos de LAGO. Se refiere siempre a un COMMIT concreto en el código fuente, identificado con un código HASH en un CVS (o bien, si no fuera posible, a un fichero comprimido, univocamente identificado con algún tipo de HASH, como MD5SUM). Por tanto, en GitHub, el @id es el link del COMMIT https://api.github.com/org/repo/git/commits/COMMIT_HASH y la propiedad sdo:codeRepository serÃa ese COMMIT navegable para humanos https://github.com/org/repo/tree/COMMIT_HASH. Es obligatorio asignar un Agent:name. Pero es opcional el uso de sdo:runtimePlatform (redefinida como lago:runtimePlatform) para señalar otro lago:Software sobre el que se ejecuta, por ejemplo una integración Docker en GitHub)." } ] + }, + { + "@id": "lago:runtimePlatform", + "@type" : [ "rdf:Property", "owl:ObjectProperty" ], + "dcat:domain": { "@id" : "lago:Software" }, + "dcat:range": { "@id" : "lago:Software" }, + "comment" : [ { "@language" : "en", "@value" : "" }, + { "@language" : "es", "@value" : "" } ] + }, +{"_comment" : "------ ARTI do_sims main Class and parameters to create a Catalog of a complete Simulation --------"}, + { + "@id": "lago:ArtiParams", + "@type" : [ "rdfs:Class", "owl:Class" ], + "comment" : [ { "@language" : "en", "@value" : "" }, + { "@language" : "es", "@value" : "" } ] + }, + { + "@id": "lago:fluxTime", + "@type" : [ "rdf:Property", "owl:ObjectProperty" ], + "dcat:domain": { "@id" : "lago:ArtiParams" }, + "dcat:range": { "@id" : "xsd:duration" }, + "dcat:label": "fluxTime", + "comment" : [ { "@language" : "en", "@value" : "Flux time (in seconds) for simulations. Use XML Schema 1.1, the format is P<secods>S (while in 1.0 was PT<seconds>S)" }, + { "@language" : "es", "@value" : "" } ] + }, + { + "@id": "lago:highEnergyIntModel", + "@type" : [ "rdf:Property", "owl:ObjectProperty" ], + "dcat:domain": { "@id" : "lago:ArtiParams" }, + "dcat:range": { "@id" : "xsd:string" }, + "dcat:label": "highEnergyIntModel", + "comment" : [ { "@language" : "en", "@value" : "Define the high interaction model to be used (EPOS or QGSII)" }, + { "@language" : "es", "@value" : "" } ] + }, + { + "@id": "lago:detectorSite", + "@type" : [ "rdf:Property", "owl:ObjectProperty" ], + "dcat:domain": { "@id" : "lago:ArtiParams" }, + "dcat:range": { "@id" : "lago:DetectorSite" }, + "dcat:label": "detectorSite", + "comment" : [ { "@language" : "en", "@value" : "Description (default values) of predefined detector sites at https://lagoproject.github.io/DMP/defs/sitesLago.jsonld" }, + { "@language" : "es", "@value" : "Descripción (opciones por defecto) de detectores predefinidos en https://lagoproject.github.io/DMP/defs/sitesLago.jsonld" } ] + }, + { + "@id": "lago:rigidity", + "@type" : [ "rdf:Property", "owl:ObjectProperty" ], + "dcat:domain": { "@id" : "lago:ArtiParams" }, + "dcat:range": { "@id" : "xsd:float" }, + "@default" : "0.0", + "dcat:label": "rigidity", + "comment" : [ { "@language" : "en", "@value" : "Rigidity cutoff; 0.0 = disabled; value in GV = enabled" }, + { "@language" : "es", "@value" : "Corte de la rigidez; 0.0 = deshabilitado; valor en GV = habilitado" } ] + }, + { + "@id": "lago:tMin", + "@type" : [ "rdf:Property", "owl:ObjectProperty" ], + "dcat:domain": { "@id" : "lago:ArtiParams" }, + "dcat:range": { "@id" : "xsd:float" }, + "@default" : "0", + "dcat:label": "tMin", + "comment" : [ { "@language" : "en", "@value" : "Low edge of zenith angle, in degrees" }, + { "@language" : "es", "@value" : "LÃmite inferior del ángulo cenital, en grados" } ] + }, + { + "@id": "lago:tMax", + "@type" : [ "rdf:Property", "owl:ObjectProperty" ], + "dcat:domain": { "@id" : "lago:ArtiParams" }, + "dcat:range": { "@id" : "xsd:float" }, + "@default" : "90", + "dcat:label": "tMax", + "comment" : [ { "@language" : "en", "@value" : "High edge of zenith angle, in degrees" }, + { "@language" : "es", "@value" : "LÃmite superior del ángulo cenital, en grados" } ] + }, + { + "@id": "lago:lLimit", + "@type" : [ "rdf:Property", "owl:ObjectProperty" ], + "dcat:domain": { "@id" : "lago:ArtiParams" }, + "dcat:range": { "@id" : "xsd:float" }, + "@default" : "5", + "dcat:label": "lLimit", + "comment" : [ { "@language" : "en", "@value" : "Lower limit of the primary particle energy in GeV" }, + { "@language" : "es", "@value" : "LÃmite inferior de la energÃa de las partÃculas primarias en GeV" } ] + }, + { + "@id": "lago:uLimit", + "@type" : [ "rdf:Property", "owl:ObjectProperty" ], + "dcat:domain": { "@id" : "lago:ArtiParams" }, + "dcat:range": { "@id" : "xsd:float" }, + "@default" : "1e6", + "dcat:label": "uLimit", + "comment" : [ { "@language" : "en", "@value" : "Upper limit of the primary particle energy in GeV" }, + { "@language" : "es", "@value" : "LÃmite superior de la energÃa de las partÃculas primarias en GeV" } ] + }, + { + "@id": "lago:flatArray", + "@type" : [ "rdf:Property", "owl:ObjectProperty" ], + "dcat:domain": { "@id" : "lago:ArtiParams" }, + "dcat:range": { "@id" : "xsd:boolean" }, + "@default" : true, + "dcat:label": "flatArray", + "comment" : [ { "@language" : "en", "@value" : "Select volumetric detector mode (default=flat array)" }, + { "@language" : "es", "@value" : "" } ] + }, + { + "@id": "lago:cherenkov", + "@type" : [ "rdf:Property", "owl:ObjectProperty" ], + "dcat:domain": { "@id" : "lago:ArtiParams" }, + "dcat:range": { "@id" : "xsd:boolean" }, + "@default" : false, + "dcat:label": "cherenkov", + "comment" : [ { "@language" : "en", "@value" : "Enable CHERENKOV mode" }, + { "@language" : "es", "@value" : "" } ] + }, + { + "@id": "lago:debug", + "@type" : [ "rdf:Property", "owl:ObjectProperty" ], + "dcat:domain": { "@id" : "lago:ArtiParams" }, + "dcat:range": { "@id" : "xsd:boolean" }, + "@default" : false, + "dcat:label": "debug", + "comment" : [ { "@language" : "en", "@value" : "Enable DEBUG mode" }, + { "@language" : "es", "@value" : "" } ] + }, + { + "@id": "lago:defaults", + "@type" : [ "rdf:Property", "owl:ObjectProperty" ], + "dcat:domain": { "@id" : "lago:ArtiParams" }, + "dcat:range": { "@id" : "xsd:boolean" }, + "dcat:label": "defaults", + "@default" : false, + "comment" : [ { "@language" : "en", "@value" : "If true, other parameters not explicitly stored in metadata are the default values set by the specific release of ARTI. Otherwise these values are unknow (set manually by the user via prompt)." }, + { "@language" : "es", "@value" : "Si es verdadero, los par,ametros que no aparecen en los metadatos corresponden a los valores por defecto de la versión concreta de ARTI que se estuviera usando. Si está marcado como falso, los valores que no aparecen en los metadatos son desconocidos, porque el usuario los ha puesto manualmente cuando la aplicación se lo ha preguntado por consola." } ] + }, + { + "@id": "lago:highEnergyCutsSecondaries", + "@type" : [ "rdf:Property", "owl:ObjectProperty" ], + "dcat:domain": { "@id" : "lago:ArtiParams" }, + "dcat:range": { "@id" : "xsd:float" }, + "dcat:label": "highEnergyCutsSecondaries", + "@default" : "0.0", + "comment" : [ { "@language" : "en", "@value" : "Enable high energy cuts for secondaries; 0.0 = disabled, value in GeV = enabled" }, + { "@language" : "es", "@value" : "" } ] + }, +{"_comment" : "------ Defining installed detectors and simulated detectors, this implies estaiblishing equivalencies among measures and software parameters --------"}, + { + "@id": "lago:DetectorSite", + "@type" : [ "rdfs:Class", "owl:Class" ], + "dcat:subClassOf" : "Agent", + "comment" : [ { "@language" : "en", "@value" : "Main characteristics of a detector, such as location, mangetic field, recommended parameters for simuation, hardware/software intalled ..." }, + { "@language" : "es", "@value" : "CaractersÃsticas principales de un Detector como su ubicación, coordenadas magnéticas, parámetros recomendados en simulación, hardware/software instalado..." } ] + }, + { + "@id": "lago:CorsikaInput", + "@type" : [ "rdfs:Class", "owl:Class" ], + "comment" : [ { "@language" : "en", "@value" : "Set of effectively used parameters in (i.e extracted from) a CORSIKA input. The significant ones for reusing, datamining and BigData are only included." }, + { "@language" : "es", "@value" : "Conjunto de parámetros efectivamente usados para crear (o extraidos de) un fichero INPUT de CORSIKA, solo los que son para reutilización, minerÃa de datos y BigData." } ] + }, + { + "@id": "lago:corsikaParam", + "@type" : [ "rdf:Property", "owl:ObjectProperty" ], + "dcat:domain": [ { "@id" : "lago:obsLev" }, + { "@id" : "lago:magnet" }, + { "@id" : "lago:Atmosphere" }, + { "@id" : "lago:Atmod" }, + { "@id" : "lago:arrang" } ], + "dcat:range": { "@id" : "xsd:string" }, + "dcat:label": "corsikaParam", + "comment" : [ { "@language" : "en", "@value" : "" }, + { "@language" : "es", "@value" : "" } ] + }, +{"_comment" : "------ common properties to describe characteristics of a DetectorSite (Agent), some of which are included also in a lago:CorsikaInput --------"}, + { + "@id": "lago:belongsLago", + "@type" : [ "rdf:Property", "owl:ObjectProperty" ], + "dcat:domain": { "@id" : "lago:DetectorSite" }, + "dcat:range": { "@id" : "xsd:boolean" }, + "@default" : false, + "dcat:label": "belongsLago", + "comment" : [ { "@language" : "en", "@value" : "" }, + { "@language" : "es", "@value" : "" } ] + }, + { + "@id": "lago:obsLev", + "@type" : [ "rdf:Property", "owl:ObjectProperty" ], + "dcat:domain": [ { "@id" : "lago:DetectorSite" }, + { "@id" : "lago:CorsikaInput" }, + { "@id" : "lago:ArtiParams" } ], + "dcat:range": { "@id": "xsd:float"}, + "dcat:label": "obsLev", + "lago:corsikaParam" : "OBSLEV", + "comment" : [ { "@language" : "en", "@value" : "Observation Level (altitude) above sea level [cm]. xsd:double type allows decimal (i.e. 2.10), non decimal (28467) and scientific notation (1633e2) values within 64-bits (double word)." }, + { "@language" : "es", "@value" : "[cm] por encima del nivel del mar. El tipo xsd:double permite valores decimales (2.10), no decimales (28467) y en notación cientifica (1633e2) con tamaño máximo de 64-bits (doble palabra)." } ] + }, + { + "@id": "lago:magnet", + "@type" : [ "rdf:Property", "owl:ObjectProperty" ], + "dcat:domain": [ { "@id" : "lago:DetectorSite" }, + { "@id" : "lago:CorsikaInput" } ], + "dcat:range": { "@id": "lago:MagnetComponents" }, + "dcat:label": "magnet", + "lago:corsikaParam" : "MAGNET", + "comment" : [ { "@language" : "en", "@value" : " Earth's mag. field (MAGNET), see values at http://www.ngdc.noaa.gov/geomagmodels/struts/calcIGRFWMM or currently at https://www.ngdc.noaa.gov/geomag/calculators/magcalc.shtml#igrfwmm"}, + { "@language" : "es", "@value" : "" } ] + }, + { + "@id": "lago:MagnetComponents", + "@type" : [ "rdfs:Class", "owl:Class" ], + "comment" : [ { "@language" : "en", "@value" : " Components of the Earth's mag. field (MAGNET), Horizontal (bx) and Vertical (bx)" }, + { "@language" : "es", "@value" : "" } ] + }, + { + "@id": "lago:bDate", + "@type" : [ "rdf:Property", "owl:ObjectProperty" ], + "dcat:domain": { "@id" : "lago:MagnetComponents" }, + "dcat:range": { "@id" : "xsd:date" }, + "dcat:label": "bDate", + "comment" : [ { "@language" : "en", "@value" : "The date for which the magnetic field values are calculated, in the form yyyy-mm-dd. (xsd:date)" }, + { "@language" : "es", "@value" : "" } ] + }, + { + "@id": "lago:bx", + "@type" : [ "rdf:Property", "owl:ObjectProperty" ], + "dcat:domain": { "@id" : "lago:MagnetComponents" }, + "dcat:range": { "@id": "xsd:decimal"}, + "dcat:label": "bx", + "comment" : [ { "@language" : "en", "@value" : "Horizontal comp. of the Earth's mag. field (MAGNET) [North,muT], see values at https://www.ngdc.noaa.gov/geomag/calculators/magcalc.shtml#igrfwmm" }, + { "@language" : "es", "@value" : "Componente horizontal del campo magnético de la Tierra (MAGNET) [North,muT], ver valores en https://www.ngdc.noaa.gov/geomag/calculators/magcalc.shtml#igrfwmm" } ] + }, + { + "@id": "lago:bz", + "@type" : [ "rdf:Property", "owl:ObjectProperty" ], + "dcat:domain": { "@id" : "lago:MagnetComponents" }, + "dcat:range": { "@id": "xsd:decimal"}, + "dcat:label": "bz", + "comment" : [ { "@language" : "en", "@value" : "Vertical comp. of the Earth's mag. field (MAGNET) [downwards,muT], see values at https://www.ngdc.noaa.gov/geomag/calculators/magcalc.shtml#igrfwmm" }, + { "@language" : "es", "@value" : "Componente vertical del campo magnético de la Tierra (MAGNET) [downwards,muT], ver valores en https://www.ngdc.noaa.gov/geomag/calculators/magcalc.shtml#igrfwmm" } ] + }, + { + "@id": "lago:bi", + "@type" : [ "rdf:Property", "owl:ObjectProperty" ], + "dcat:domain": { "@id" : "lago:MagnetComponents" }, + "dcat:range": { "@id": "xsd:decimal"}, + "dcat:label": "bx", + "comment" : [ { "@language" : "en", "@value" : "" }, + { "@language" : "es", "@value" : "" } ] + }, + { + "@id": "lago:atmcrd", + "@type" : [ "rdf:Property", "owl:ObjectProperty" ], + "dcat:domain": [ { "@id" : "lago:DetectorSite" }, + { "@id" : "lago:CorsikaInput"} ], + "dcat:range": [ { "@id": "lago:Atmosphere" }, { "@id": "lago:Atmod" } ], + "dcat:label": "atmcrd", + "comment" : [ { "@language" : "en", "@value" : "Atmospheric type, posible values: ATMOSPHERE, ATMOD" }, + { "@language" : "es", "@value" : "" } ] + }, + { + "@id": "lago:Atmosphere", + "@type" : [ "rdfs:Class", "owl:Class" ], + "lago:corsikaParam" : "ATMOSPHERE", + "comment" : [ { "@language" : "en", "@value" : "Atmospheric type, fixed value: ATMOSPHERE" }, + { "@language" : "es", "@value" : "" } ] + }, + { + "@id": "lago:Atmod", + "@type" : [ "rdfs:Class", "owl:Class" ], + "lago:corsikaParam" : "ATMOD", + "comment" : [ { "@language" : "en", "@value" : "Atmospheric type, fixed vaule: ATMOD" }, + { "@language" : "es", "@value" : "" } ] + }, + { + "@id": "lago:modAtm", + "@type" : [ "rdf:Property", "owl:ObjectProperty" ], + "dcat:domain": [ { "@id" : "lago:Atmosphere" }, { "@id" : "lago:Atmod" } ], + "dcat:range": { "@id" : "xsd:string" }, + "dcat:label": "modAtm", + "comment" : [ { "@language" : "en", "@value" : "Atmospheric model (can be ATMOSPHERE or ATMOD), some posible values: 19, E1, E2, E10, E29, E30(=wi), E31(=sp), E32(=su), E33(=au)" }, + { "@language" : "es", "@value" : "" } ] + }, + { + "@id": "lago:arrang", + "@type" : [ "rdf:Property", "owl:ObjectProperty" ], + "dcat:domain": [ { "@id" : "lago:DetectorSite" }, + { "@id" : "lago:CorsikaInput"} ], + "dcat:range": { "@id": "xsd:decimal"}, + "dcat:label": "arrang", + "lago:corsikaParam" : "ARRANG", + "comment" : [ { "@language" : "en", "@value" : "" }, + { "@language" : "es", "@value" : "" } ] + }, + { + "@id" : "geometry", + "@type" : "geometry", + "dcat:domain" : [ { "@id" : "Location" }, + { "@id" : "lago:DetectorSite" } ], + "dcat:range" : { "@id": "geo:Point" }, + "dcat:label" : "point", + "seeAlso" : [ "https://www.w3.org/ns/locn#locn:geometry", + "https://www.w3.org/TR/vocab-dcat-2/#Property:location_geometry" ], + "comment" : [ { "@language" : "en", "@value" : ""}, + { "@language" : "es", "@value" : "" } ] + }, + {"_comment" : "Reiterative including geo:Point and its propierties. It is as is in W3C WGS84 vocab: http://www.w3.org/2003/01/geo/wgs84_pos#). Added for guiding/clarifying."}, + { + "@id": "geo:latitude", + "@type":"http://www.w3.org/2001/XMLSchema#float", + "dcat:domain": { "@id": "geo:Point" }, + "dcat:label" : "lat", + "owl:equivalentProperty" : { "@id": "sdo:GeoCoordinates#latitude" } + }, + { + "@id": "geo:longitude", + "@type":"http://www.w3.org/2001/XMLSchema#float", + "dcat:label" : "long", + "dcat:domain": { "@id": "geo:Point" }, + "owl:equivalentProperty" : { "@id": "sdo:GeoCoordinates#longitude" } + }, + { + "@id": "geo:altitude", + "@type":"http://www.w3.org/2001/XMLSchema#float", + "dcat:label" : "alt", + "dcat:domain": { "@id": "geo:Point" }, + "owl:equivalentProperty" : { "@id": "sdo:GeoCoordinates#altitude" } + } + ], +"@context" : { + "lago" : "https://raw.githubusercontent.com/lagoproject/DMP/1.1/schema/lagoSchema.jsonld", + "@vocab" : "https://raw.githubusercontent.com/SEMICeu/DCAT-AP/2.0.0/releases/2.0.0/dcat-ap_2.0.0.jsonld", + "_dcatap" : "https://raw.githubusercontent.com/SEMICeu/DCAT-AP/2.0.0/releases/2.0.0/dcat-ap_2.0.0.jsonld", + "_dcatap_landing_page" : "http://data.europa.eu/r5r/", + "owl" : "http://www.w3.org/2002/07/owl#", + "rdf" : "http://www.w3.org/1999/02/22-rdf-syntax-ns#", + "xsd" : "http://www.w3.org/2001/XMLSchema#", + "rdfs" : "http://www.w3.org/2000/01/rdf-schema#", + "dcat" : "http://www.w3.org/ns/dcat#", + "prov" : "http://www.w3.org/ns/prov#", + "foaf" : "http://xmlns.com/foaf/0.1/", + "sdo" : "http://schema.org/", + "geo": "http://www.w3.org/2003/01/geo/wgs84_pos#" + } +} diff --git a/1.1/schema/lagoSchema.md b/1.1/schema/lagoSchema.md new file mode 100644 index 0000000000000000000000000000000000000000..cddbdde8750e2ca07eccb2baec8162e26470f957 --- /dev/null +++ b/1.1/schema/lagoSchema.md @@ -0,0 +1,67 @@ +--- +layout: default +parent: Metadata Schema +--- + +# Metadata Schema for LAGO +{: .no_toc } + +|Version| Updated | Date |Contributors| +|-------|---------|------|------------| +| 1.1 develop | {{ site.time }} | 2020-06-01 - today | LAGO Collaboration | + +## Table of contents +{: .no_toc} + +- TOC +{:toc} + +## What is defined? + +This schema is the metadata vocabulary used to describe the datasets (the files) and catalogs (the directories) stored in the LAGO repositories. Aiming to provide a standardised description of the data to make them findable, accessible, interoperable, and reusable [(FAIR)](https://www.go-fair.org/fair-principles/). + +This specification is independent of the other metadata currently generated by LAGO applications. They should coexist to avoid significant loss, since legacy metadata files are handled as datasets. + +Therefore, the metadata schema is based on three pillars: + +- [The LAGO vocabulary](./lagoSchema.jsonld): as described in this document. It is a re-profile of [DCAT-AP2](https://joinup.ec.europa.eu/collection/semantic-interoperability-community-semic/solution/dcat-application-profile-data-portals-europe) (European Commission), extending the existing classes and adding properties needed for LAGO computation. + +- Main vocabulary: [DCAT-AP2](https://joinup.ec.europa.eu/collection/semantic-interoperability-community-semic/solution/dcat-application-profile-data-portals-europe) (European Commission), which is a specific profile of [DCAT2](https://www.w3.org/TR/vocab-dcat-2/) (W3C), recommended for repositories, content aggregators or data consumers related to the public sector (governments, research centers, funded projects). + +- Language syntax: [JSON-LD 1.1](https://json-ld.org/spec/latest/json-ld/) (W3C). It is the simplest standard for linking metadata. Promoted by Google, currently, it is ousting more heavy and complex syntaxes such as RDF, Turtle, XML. + + +## How to use this metadata vocabulary? + +Firstly, any developer should be familiar with the specifications of [JSON-LD 1.1](https://json-ld.org/spec/latest/json-ld/), [DCAT2](https://www.w3.org/TR/vocab-dcat-2/) and [DCAT-AP2](https://joinup.ec.europa.eu/collection/semantic-interoperability-community-semic/solution/dcat-application-profile-data-portals-europe). In particular, you should focus on JSON-LD to avoid getting confuse with other syntaxes and explore as many JSON-LD examples as possible (as the ones at [json-ld.org](https://json-ld.org/) or W3C --only using the Schema.org, not DCAT, as main vocabulary--). For instance, you can review the JSON-LD implementations for [wc3.org/DCAT2](https://www.w3.org/ns/dcat2.jsonld) and [GitHub/DCAT-AP2](https://github.com/SEMICeu/DCAT-AP/tree/master/releases). + +Secondly, the developer can use [this document](./lagoSchema.md) and the [lagoSchema.jsonld](./lagoSchema.jsonld) as the reference for: +- interpreting the state of the stored data (curation, provenance) and their contents (a resume) to: + - make searches and process the selected data, + - expose and harvest data; +- making data available by means to: + - describe legacy data (extracting metadata from existing files), + - generate new data with metadata (specific LAGO wrappers execute the processing or [simulations](examples/sims/simulationExample.md)); +- using the pre-established: + - [definitions](/defs/index.md): [LAGO sites](/defs/lagoSites.md) or [LAGO organisation](/defs/lagoOrganisation.md), + - [rights](/rights/index.md): licenses and permissions; +- proposing extensions of the schema or definitions: + - new or existing LAGO sites, + - users, institutions, etc. + + +## Vocabulary item by item + +{% include generate_html_for_vocab.html folder="/DMP/schema/lagoSchema.jsonld" vocabulary="true" %} + + +## Plain JSON-LD file + +{% capture thisPage %} + {% include_relative lagoSchema.jsonld %} +{% endcapture %} +```json +{{ thisPage }} +``` + +