Skip to content

Commit 787a27e

Browse files
committed
update for 1.0.0
1 parent a5790ad commit 787a27e

21 files changed

+102
-3518
lines changed

README.md

+7-39
Original file line numberDiff line numberDiff line change
@@ -13,50 +13,18 @@ There are several ways to run the tutorial notebooks:
1313
[![Binder](https://mybinder.org/badge_logo.svg)](https://mybinder.org/v2/gh/fastmachinelearning/hls4ml-tutorial/HEAD)
1414

1515
## Conda
16+
Running the tutorials requires AMD Vitis HLS to be installed, see [here](https://www.xilinx.com/support/download/index.html/content/xilinx/en/downloadNav/vitis.html).
17+
After the installation, the necessary environmental variables can be set using
18+
```
19+
source /path/to/your/installtion/Xilinx/Vitis_HLS/202X.X/settings64.(c)sh
20+
```
21+
1622
The Python environment used for the tutorials is specified in the `environment.yml` file.
1723
It can be setup like:
1824
```bash
1925
conda env create -f environment.yml
2026
conda activate hls4ml-tutorial
21-
```
22-
23-
## Docker without Vivado
24-
Pull the prebuilt image from the GitHub Container Registry:
25-
```bash
26-
docker pull ghcr.io/fastmachinelearning/hls4ml-tutorial/hls4ml-0.8.0:latest
27-
```
28-
29-
Follow these steps to build a Docker image that can be used locally, or on a JupyterHub instance.
30-
You can build the image (without Vivado):
31-
```bash
32-
docker build https://github.com/fastmachinelearning/hls4ml-tutorial -f docker/Dockerfile
33-
```
34-
Alternatively, you can clone the repository and build locally:
35-
```bash
36-
git clone https://github.com/fastmachinelearning/hls4ml-tutorial
37-
cd hls4ml-tutorial
38-
docker build -f docker/Dockerfile -t ghcr.io/fastmachinelearning/hls4ml-tutorial/hls4ml-0.8.0:latest .
39-
```
40-
Then to start the container:
41-
```bash
42-
docker run -p 8888:8888 ghcr.io/fastmachinelearning/hls4ml-tutorial/hls4ml-0.8.0:latest
43-
```
44-
When the container starts, the Jupyter notebook server is started, and the link to open it in your browser is printed.
45-
You can clone the repository inside the container and run the notebooks.
46-
47-
## Docker with Vivado
48-
Pull the prebuilt image from the GitHub Container Registry:
49-
```bash
50-
docker pull ghcr.io/fastmachinelearning/hls4ml-tutorial/hls4ml-0.8.0-vivado-2019.2:latest
51-
```
52-
53-
To build the image with Vivado, run (Warning: takes a long time and requires a lot of disk space):
54-
```bash
55-
docker build -f docker/Dockerfile.vivado -t ghcr.io/fastmachinelearning/hls4ml-tutorial/hls4ml-0.8.0-vivado-2019.2:latest .
56-
```
57-
Then to start the container:
58-
```bash
59-
docker run -p 8888:8888 ghcr.io/fastmachinelearning/hls4ml-tutorial/hls4ml-0.8.0-vivado-2019.2:latest
27+
source /path/to/your/installtion/Xilinx/Vitis_HLS/202X.X/settings64.(c)sh
6028
```
6129

6230
## Companion material

docker/Dockerfile

-40
This file was deleted.

docker/Dockerfile.vitis

-49
This file was deleted.

docker/Dockerfile.vivado

-48
This file was deleted.

docker/install_vitis.sh

-27
This file was deleted.

docker/install_vivado.sh

-33
This file was deleted.

docker/settings64.sh

-7
This file was deleted.

docker/start-notebook.sh

-25
This file was deleted.

docker/vitis_cfg.txt

-33
This file was deleted.

docker/vivado_cfg.txt

-30
This file was deleted.

environment.yml

+6-7
Original file line numberDiff line numberDiff line change
@@ -2,21 +2,20 @@ name: hls4ml-tutorial
22
channels:
33
- conda-forge
44
dependencies:
5-
- python=3.10.10
6-
- jupyter_contrib_nbextensions==0.7.0
7-
- jupyterhub==3.1.1
8-
- jupyter-book==0.15.1
5+
- python=3.10.16
6+
- jupyter_contrib_nbextensions
7+
- jupyterhub
8+
- jupyter-book
99
- jsonschema-with-format-nongpl
1010
- pydot==1.4.2
1111
- graphviz==7.1.0
1212
- scikit-learn==1.2.2
13-
- tensorflow==2.11.1
13+
- tensorflow==2.14.0
1414
- tensorflow-datasets==4.8.3
1515
- webcolors
1616
- widgetsnbextension==3.6.0
1717
- pip==23.0.1
1818
- pip:
19-
- hls4ml[profiling]==0.8.0
20-
- qkeras==0.9.0
19+
- hls4ml[profiling]==1.0.0
2120
- conifer==0.2b0
2221
- pysr==0.16.3

0 commit comments

Comments
 (0)