|
|
|
> :rotating_light: --((**Caveat**: This Wiki is currently under construction))-- :rotating_light:
|
|
|
|
|
|
|
|
---
|
|
|
|
|
|
|
|
# Table of contents
|
|
|
|
|
|
|
|
[[_TOC_]]
|
|
|
|
|
|
|
|
# Organization of VECTO at codeu
|
|
|
|
|
|
|
|
The main entry point to VECTO at **code.europa.eu** (or _codeu_, in short) is the **VECTO group** website: [`https://code.europa.eu/vecto`](https://code.europa.eu/vecto)
|
|
|
|
There you can find all **VECTO projects** and navigate to the desired one:
|
|
|
|
- [VECTO Simulator](https://code.europa.eu/vecto/vecto).
|
|
|
|
- [VECTO Multistep](https://code.europa.eu/vecto/vecto/-/tree/dev) (part of the `dev` branch of the VECTO Simulator project).
|
|
|
|
- [VECTO Trailer](https://code.europa.eu/vecto/vecto/-/tree/trailer) (branch of the VECTO Simulator project).
|
|
|
|
- [VECTO Engine](https://code.europa.eu/vecto/vecto-engine).
|
|
|
|
- [VECTO Airdrag](https://code.europa.eu/vecto/vecto-airdrag).
|
|
|
|
- [VECTO Hashing](https://code.europa.eu/vecto/vecto) (included in the VECTO Simulator project).
|
|
|
|
- [ECoGeT 3D shapes](https://code.europa.eu/vecto/vecto-cfd).
|
|
|
|
|
|
|
|
|
|
|
|
# Software License
|
|
|
|
|
|
|
|
In the codeu platform, all VECTO artifacts are publicly available and without any registration, under the [EUPL open-source license](https://ec.europa.eu/info/european-union-public-licence_en).
|
|
|
|
|
|
|
|
# VECTO resources at code.europa.eu
|
|
|
|
|
|
|
|
## Wiki
|
|
|
|
|
|
|
|
The [**VECTO Wiki**](home) is the knowledge base that you are currently reading.
|
|
|
|
|
|
|
|
## Releases
|
|
|
|
|
|
|
|
In the corresponding project, from the left column, click on _Deployments --> Releases_ (e.g., [VECTO simulator releases](https://code.europa.eu/vecto/vecto/-/releases)).
|
|
|
|
The latest releases are linked in the main project websites with blue badges, e.g.:
|
|
|
|
|
|
|
|
You can find chronological tables that gather existing releases at the VECTO group Wiki (e.g., [table with VECTO simulator releases](vecto-sim#releases)).
|
|
|
|
|
|
|
|
## Issues
|
|
|
|
|
|
|
|
Issues are bugs, technical questions, implementation discussions, etc. Issues about VECTO can be raised and viewed at the platform, in the corresponding project. See the section about [opening an issue](codeu#opening-an-issue).
|
|
|
|
|
|
|
|
## Codebase
|
|
|
|
|
|
|
|
The [`code.europa.eu`](https://code.europa.eu/) platform is based on GitLab, and the VECTO codebase from all the published releases is publicly available. If you want to check the code of a specific project release, navigate to it and click on _Assets --> Source code (zip)_ (or your desired compression format). For example:
|
|
|
|
|
|
|
|
Alternatively, you can navigate to the corresponding project and pick the tag from the drop-down menu. Then click on download or clone:
|
|
|
|
|
|
|
|
|
|
|
|
# Codeu accounts
|
|
|
|
|
|
|
|
<mark>If you want to download VECTO releases and view issues or the codebase, **you don't need to create an account.**
|
|
|
|
You only need a code.europa.eu account if you want to **open an issue or to subscribe to receive notifications.**</mark>
|
|
|
|
|
|
|
|
## Create an account
|
|
|
|
|
|
|
|
The code.europa.eu accounts are linked to the **ECAS/EULogin**. **To create an account**:
|
|
|
|
1. Click [this link](https://ecas.ec.europa.eu/cas/eim/external/register.cgi?).
|
|
|
|
2. Fill in the fields (name, surname, email, and language).
|
|
|
|
3. Click on _Create an account_.
|
|
|
|
|
|
|
|
## Login
|
|
|
|
|
|
|
|
To **login** at code.europa.eu:
|
|
|
|
- Click the _Sign in_ button on the top-right of the page.
|
|
|
|
- Alternatively, use [this link](https://code.europa.eu/users/sign_in?redirect_to_referer=no#).
|
|
|
|
|
|
|
|
## Manage notifications
|
|
|
|
|
|
|
|
After successful login, you can **manage notifications** as follows:
|
|
|
|
1. Navigate to the corresponding project (e.g., [VECTO simulator](https://code.europa.eu/vecto/vecto/)).
|
|
|
|
2. Click the bell icon :bell: on the top-right.
|
|
|
|
3. Select _Watch_ (or _Custom_ to choose what actions trigger email notifications):
|
|
|
|
|
|
|
|
|
|
|
|
# Opening an issue
|
|
|
|
|
|
|
|
<mark>In order to open an issue, you need to have a code.europe.eu [account](codeu#creating-an-account).</mark>
|
|
|
|
|
|
|
|
New issues about VECTO can be created as follow:
|
|
|
|
1. Navigate to the corresponding project (e.g., [VECTO simulator](https://code.europa.eu/vecto/vecto/)).
|
|
|
|
2. From the left column, click on _Issues__ and then on __New issue__ (on the top-right of the screen).
|
|
|
|
3. Define a descriptive title, and **provide details about how to reproduce the issue**.
|
|
|
|
4. Click on _Create issue_ at the bottom of the page.
|
|
|
|
|
|
|
|
Note that, in some cases, the issue may be sensitive and therefore the box that states:
|
|
|
|
_This issue is confidential and should only be visible to team members with at least Reporter access._
|
|
|
|
should be marked before creating the issue.
|
|
|
|
|
|
|
|
## Issues regarding Article 10(2)
|
|
|
|
|
|
|
|
Issues regarding Article 10(2) can be filed as [explained before](codeu#opening-an-issue). However, there are some particularities:
|
|
|
|
- Specify that it is an Article 10(2) issue.
|
|
|
|
- Specify the VIN. There should be one issue per vehicle.
|
|
|
|
- If you want to share related data with the VECTO developers:
|
|
|
|
- **Encrypt it** and include it as an attachment to the issue (by clicking on the paperclip :paperclip: button).
|
|
|
|
- Afterwards, you can share the password to open the encrypted data with the [JRC-VECTO functional mailbox](mailto:JRC-VECTO@ec.europa.eu). |
|
|
\ No newline at end of file |
