Skip to content

sphamba/frame-project

 
 

Repository files navigation

FRAME: A FAIR protocol for hybrid models and data in hydrology

Contains the raw metadata files of FAIR hybrid models, as well as the source code of the library website for the ETH ORD Explore project FRAME.

Adding your own metadata

The existing models' and components' metadata files are all stored in backend/api/metadata_files/. To contribute with your own metadata, follow these steps.

Requirements

  • Python 3.10 or higher
  • Poetry (pip install poetry)
  • Make

Steps

To add new hybrid model or component metadata to the FRAME library, follow these steps:

  1. Fork and clone the repository.
  2. Setup the development environment. This will enable automatic formatting and validation of metadata files.
make install
  1. Add or edit metadata files in the backend/api/metadata_files/ directory. The files must follow the provided backend/api/metadata_files/schema.json. Be sure to add this header on top of your .yaml for your text editor to provide you with error checks and hints:
# yaml-language-server: $schema=schema.json
  1. Check the validity of the metadata files.
make test
  1. Commit your changes. Metadata files will be re-formatted automatically (line breaks, white spaces...).
  2. Push your changes to your fork and create a pull request to the main branch of the original repository.

Deploying the website locally

Follow these instructions to run the FRAME website locally and see your changes before deploying.

Backend

In one shell, run:

make install  # Only once
make run-backend

Frontend

In another shell, run:

make run-frontend

The website will be available at http://localhost:9000.

About

Contains all the codes produced as part of the ETH ORD Explore project FRAME

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Python 40.4%
  • Vue 30.5%
  • TypeScript 15.8%
  • JavaScript 8.5%
  • SCSS 2.2%
  • HTML 0.8%
  • Other 1.8%