Skip to content

Commit

Permalink
Merge pull request #89 from fastmachinelearning/vitis
Browse files Browse the repository at this point in the history
Switch main branch to Vitis and update environment for 1.0.0.
  • Loading branch information
jmitrevs authored Dec 12, 2024
2 parents 5d297f1 + 935af3f commit 433a32b
Show file tree
Hide file tree
Showing 21 changed files with 417 additions and 502 deletions.
2 changes: 1 addition & 1 deletion .github/workflows/deploy.yml
Original file line number Diff line number Diff line change
Expand Up @@ -25,7 +25,7 @@ jobs:
channels: conda-forge
activate-environment: hls4ml-tutorial
environment-file: environment.yml
python-version: 3.10.10
python-version: 3.10.16
auto-activate-base: false

# Check dependencies
Expand Down
38 changes: 0 additions & 38 deletions .github/workflows/docker-publish.yml

This file was deleted.

46 changes: 7 additions & 39 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -13,50 +13,18 @@ There are several ways to run the tutorial notebooks:
[![Binder](https://mybinder.org/badge_logo.svg)](https://mybinder.org/v2/gh/fastmachinelearning/hls4ml-tutorial/HEAD)

## Conda
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).
After the installation, the necessary environmental variables can be set using
```
source /path/to/your/installtion/Xilinx/Vitis_HLS/202X.X/settings64.(c)sh
```

The Python environment used for the tutorials is specified in the `environment.yml` file.
It can be setup like:
```bash
conda env create -f environment.yml
conda activate hls4ml-tutorial
```

## Docker without Vivado
Pull the prebuilt image from the GitHub Container Registry:
```bash
docker pull ghcr.io/fastmachinelearning/hls4ml-tutorial/hls4ml-0.8.0:latest
```

Follow these steps to build a Docker image that can be used locally, or on a JupyterHub instance.
You can build the image (without Vivado):
```bash
docker build https://github.com/fastmachinelearning/hls4ml-tutorial -f docker/Dockerfile
```
Alternatively, you can clone the repository and build locally:
```bash
git clone https://github.com/fastmachinelearning/hls4ml-tutorial
cd hls4ml-tutorial
docker build -f docker/Dockerfile -t ghcr.io/fastmachinelearning/hls4ml-tutorial/hls4ml-0.8.0:latest .
```
Then to start the container:
```bash
docker run -p 8888:8888 ghcr.io/fastmachinelearning/hls4ml-tutorial/hls4ml-0.8.0:latest
```
When the container starts, the Jupyter notebook server is started, and the link to open it in your browser is printed.
You can clone the repository inside the container and run the notebooks.

## Docker with Vivado
Pull the prebuilt image from the GitHub Container Registry:
```bash
docker pull ghcr.io/fastmachinelearning/hls4ml-tutorial/hls4ml-0.8.0-vivado-2019.2:latest
```

To build the image with Vivado, run (Warning: takes a long time and requires a lot of disk space):
```bash
docker build -f docker/Dockerfile.vivado -t ghcr.io/fastmachinelearning/hls4ml-tutorial/hls4ml-0.8.0-vivado-2019.2:latest .
```
Then to start the container:
```bash
docker run -p 8888:8888 ghcr.io/fastmachinelearning/hls4ml-tutorial/hls4ml-0.8.0-vivado-2019.2:latest
source /path/to/your/installtion/Xilinx/Vitis_HLS/202X.X/settings64.(c)sh
```

## Companion material
Expand Down
40 changes: 0 additions & 40 deletions docker/Dockerfile

This file was deleted.

48 changes: 0 additions & 48 deletions docker/Dockerfile.vivado

This file was deleted.

33 changes: 0 additions & 33 deletions docker/install_vivado.sh

This file was deleted.

25 changes: 0 additions & 25 deletions docker/start-notebook.sh

This file was deleted.

30 changes: 0 additions & 30 deletions docker/vivado_cfg.txt

This file was deleted.

16 changes: 8 additions & 8 deletions environment.yml
Original file line number Diff line number Diff line change
Expand Up @@ -2,21 +2,21 @@ name: hls4ml-tutorial
channels:
- conda-forge
dependencies:
- python=3.10.10
- jupyter_contrib_nbextensions==0.7.0
- jupyterhub==3.1.1
- jupyter-book==0.15.1
- python=3.10.16
- jupyter_contrib_nbextensions
- jupyterhub
- jupyter-book
- jsonschema-with-format-nongpl
- pydot==1.4.2
- graphviz==7.1.0
- scikit-learn==1.2.2
- tensorflow==2.11.1
- tensorflow==2.14.0
- tensorflow-datasets==4.8.3
- webcolors
- widgetsnbextension==3.6.0
- pip==23.0.1
- pip:
- hls4ml[profiling]==0.8.0
- qkeras==0.9.0
- conifer==0.2b0
- hls4ml[profiling,optimization,sr,HGQ]==1.0.0
- conifer==1.5
- pysr==0.16.3
- xgboost==1.7.5
Binary file added images/part5_floorplan.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading

0 comments on commit 433a32b

Please sign in to comment.