1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
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
67
68
69
70
71
72
73
74
75
76
|
# Setup environment
***trame*** requires Python 3.6+ but since ParaView 5.11 is bundling Python 3.9 we will use Python 3.9 in this tutorial.
```bash
python3.9 -m venv .venv
source ./.venv/bin/activate
python -m pip install --upgrade pip
pip install trame # Install trame core
pip install trame-vuetify trame-vtk # Install widgets that we'll be using
pip install vtk # Install the VTK library
```
**Notes**:
- `venv` was added in Python 3.3.
- On a Mac with ARM architecture, VTK is only available with Python 3.9+.
## Running the application
```bash
python ./00_setup/app.py --port 1234
```
Your browser should open to `http://localhost:1234/`
**Notes**:
- The default port is 8080, but since this is very common we will use 1234 for our Tutorial.
- If you are running this on a remote machine, you may have to set the host to 0.0.0.0 to allow any external connection. (`python ./app.py --port 1234 --host 0.0.0.0`)
<div class="print-break"></div>
## Annotation of Hello ***trame*** Application
We start by importing the basic building blocks for our client-server application.
```python
from trame.app import get_server
from trame.ui.vuetify import SinglePageLayout
```
from ***trame***'s `app`, we import the factory function for retrieving a server instance on which we will bind our UI and business logic. We also import a skeleton for a single page client application that relies on vuetify (our main widget library) from `trame.ui.vuetify`.
Next, we define the graphical user interface (GUI) by passing the server to which it should be bound. Then with that layout we update the toolbar's title to read `"Hello trame"`.
```python
server = get_server(client_type="vue2")
with SinglePageLayout(server) as layout:
layout.title.set_text("Hello trame")
```
Finally, we start the Web server using:
```python
if __name__ == "__main__":
server.start()
```
`start` can take an optional argument of a *port* number. However, this can be set with command-line arguments (`--port 1234`).
**Running the Application**
```bash
$ python ./00_setup/app.py --port 1234
App running at:
- Local: http://localhost:1234/
- Network: http://192.168.1.34:1234/
Note that for multi-users you need to use and configure a launcher.
And to prevent your browser from opening, add '--server' to your command line.
```
Your browser should open automatically to `http://localhost:1234/`.
|
