Skip to content

An interface to direct files and metadata from SciCat to OneDep

Notifications You must be signed in to change notification settings

SwissOpenEM/Depositor

Repository files navigation

OpenEM Depositor of EM data to International Repositories

This repository provides a depositor app backend on top of SciCat frontend that allows users to seamlessly deposit their data to OneDep system. OneDep covers depositions to PDB end EMDB.

This depositor is designed for Swiss OpenEm project and supports only depositions to OneDep that are experimentally based on methods covered by Electron Microscopes.

Files necessary for a deposition:

OneDep defines an obligatory set of files required to create a deposition based on the specific method. Subsequently, same files are necessary for this depositor too.
Additionally, the user can provide an extra file with metadata that will be accepted by the depositor and appended to the deposition. This metadata file must be in json format and follow the OSC-EM schema supported by OpenEM. Once provided, this metadata will be automatically converted to mmCIF format accepted by OneDep. If deposition is destined to PDB, a new mmCIF file will be created containing both metadata and coordinates model provided by the user. For EMDB depositions a brand new mmCIF file will be created.

In OneDep user needs to manually provide the pixel spacing. Here user is not required to do it, as the headers definition of .mrc files provide this information.

pixel_spacing_{x/y/z} = cell_dimensions_{x/y/z} / sampling_unit_cell_{x/y/z}

Running a depositor

Disclaimer: This repository is still in development, so the next part will be simplified.
To run the service, clone the repository, go inside it and run with

go run .

Service is running on localhost:8080 and is using the frontend from the fork. SciCat Project promotes using a central environment for development - SciCatLive. There, frontend is configured to run on localhost:4200 port, but this can be changed. In this case the CORS setting of depositor need to be changed as well.

From the frontend perspective only datasets, that have an OpenEm keyword, will get an access to the depositor backend and UI.

REST API.deinition based on OpenAPI v3.0 specs are available at localhost:8080/docs/index.html, once service is runnning.

Limitations

  • depositions/onedep/config.go defined the base URL, to which requests will be sent to create deposition, add files and files metadata. Currently only a test server for OneDep is used. Once, the API is rolled out in the production (https://deposit-pdbe.wwpdb.org/deposition/ in Europe), this will then be changed.
  • Additional Endpoint will be implemented to create deposition in EMPIAR for raw datasets. This is expected by March 2025, as described on our Project Timeline.
  • Authorization with ORCID Id is not supported yet, requires a jwt token that needs to be created by user.
  • currently configured to run on localhost:8080

About

An interface to direct files and metadata from SciCat to OneDep

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages