Newer
Older
[](https://joss.theoj.org/papers/a8ac17f6c02fdf76098ac97ed3e09b22)
Autosubmit GUI is a front-end software developed using [ReactJS](https://reactjs.org/docs/getting-started.html) as the main framework, and JavaScript in general.
This front-end software consumes most of the information it needs from [Autosubmit API](https://earth.bsc.es/gitlab/wuruchi/autosubmitreact/-/wikis/Autosubmit-API), an API that retrieves information from an internal file system that
results from the execution of [Autosubmit](https://earth.bsc.es/gitlab/es/autosubmit) to execute experiments on a High Performance Computing environment.
These two systems, the API and the GUI, are tightly coupled. However, it is possible to adapt the API calls to other sources of information you might prefer, and for
that purpose we provide with response examples (more details in the installation section) that can help the developer understand how the information is used in
the components of the GUI.
Autosubmit GUI uses [FancyTree](https://github.com/mar10/fancytree/) and [vis.js](https://visjs.org/), two popular and very useful libraries, to show the experiment
information in a graphical and comprehensive way. The GUI implements creative ways to use these libraries to dynamically display information without losing performance.
Some of the expermients in our environment can include more than `10000` items, and showing this information in a web format without significant loss of performance is
by itself an achievement.
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
### General Knowledge Requirements
- npm
- Javascript: asynchronous functions, promises, event handling, etc.
- Bootstrap 4 and CSS
- DOM manipulation
- JSON
- ReactJS
### Installation
The main development framework is **npm**. We are currently using version `6.9.0`. You can find the main **npm** dependencies in the file: [package.json](package.json).
Refer to: [npm documentation](https://docs.npmjs.com/) for more information about installation and first steps on this platform.
Make sure to have npm installed in your local environment.
Execute:
`git clone https://earth.bsc.es/gitlab/wuruchi/autosubmitreact/`
Then, you can run:
`npm install`
And all the necessary dependencies will be installed.
After that, you will be able to run:
`npm start`
Then, the GUI should open in your default browser, and the information displayed should correspond to that of the data samples folder.
### Testing
The testing suite has been developed using [JEST](https://jestjs.io/en/).
To execute it, go to your main folder (`/autosubmitreact/`) and execute:
`npm test`
Almost all tests can be found at `/autosubmitreact/src/components/experiment/tests/`.
Make sure that you have installed the dependencies before running the tests.
Note: It could happen that `jest` fails to run or is not automatically installed along the other dependencies on a Windows machine, please install it manually.
### Demo
There is a [demo available](https://autosubmitgui.bsc.es/presentation/) with a using a small experiment database to showcase the GUI features (the information corresponds to a snapshot of the data, so experiments will not evolve and interaction is limited).
### User Guide
A user guide has been developed and published at [https://autosubmit.readthedocs.io/en/latest/autosubmit-gui.html](https://autosubmit.readthedocs.io/en/latest/autosubmit-gui.html).
Although a little outdated, we are constantly working on updating it considering the latest features.
### Contributing
Currently, the development of this software is under the `Autosubmit team` that belongs to the `Earth Science Department` of the `Barcelona Supercomputing Center`.
You can open issues in this repository using the `Email a new issue to this project` function, since user creation is currently restricted to only `BSC` members.
Most issues have been centralized in the [Autosubmit repository](https://earth.bsc.es/gitlab/es/autosubmit/-/issues), and you can check them there.
You are free (and encouraged) to clone this software and modify it to fit your needs. Moreover, the `BSC` is always looking for collaboration, so feel free to request support.
### Note
The **Autosubmit GUI** development has been moved to [https://earth.bsc.es/gitlab/es/autosubmitreact](https://earth.bsc.es/gitlab/es/autosubmitreact).