Skip to content

Commit

Permalink
examples: moving mnist classifier to new folder and cleaning up notebook
Browse files Browse the repository at this point in the history
  • Loading branch information
jtsextonMITRE committed Sep 11, 2024
1 parent 37c7d37 commit 00b7de5
Show file tree
Hide file tree
Showing 8 changed files with 1,581 additions and 90 deletions.
22 changes: 22 additions & 0 deletions examples/mnist-classifier-demo/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,22 @@
# Tensorflow MNIST Classifier demo

This example demonstrates how to run a simple experiment on the transferability of the fast gradient method (FGM) evasion attack between two neural network architectures.
The demo can be found in the Jupyter notebook file [demo.ipynb](demo.ipynb).

## Running the example

To prepare your environment for running this example, follow the linked instructions below:

1. [Create and activate a Python virtual environment and install the necessary dependencies](../README.md#creating-a-virtual-environment)
2. [Download the MNIST dataset using the download_data.py script.](../README.md#downloading-datasets)
3. [Follow the links in these User Setup instructions](../../README.md#user-setup) to do the following:
- Build the containers
- Use the cookiecutter template to generate the scripts, configuration files, and Docker Compose files you will need to run Dioptra
4. [Edit the docker-compose.yml file to mount the data folder in the worker containers](../README.md#mounting-the-data-folder-in-the-worker-containers)
5. [Initialize and start Dioptra](https://pages.nist.gov/dioptra/getting-started/running-dioptra.html#initializing-the-deployment)
6. [Register the custom task plugins for Dioptra's examples and demos](../README.md#registering-custom-task-plugins)
7. [Register the queues for Dioptra's examples and demos](../README.md#registering-queues)
8. [Start JupyterLab and open `demo.ipynb`](../README.md#starting-jupyter-lab)

Steps 1–4 and 6–7 only need to be run once.
**Returning users only need to repeat Steps 5 (if you stopped Dioptra using `docker compose down`) and 8 (if you stopped the `jupyter lab` process)**.
Loading

0 comments on commit 00b7de5

Please sign in to comment.