Skip to content

(Iss 83) remove unused pygraphviz from project and update README #88

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
nelsonjd wants to merge 3 commits into
base: master
Choose a base branch
from
Open

(Iss 83) remove unused pygraphviz from project and update README #88

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
bfa4452
remove unused pygraphviz from project
nelsonjd Feb 17, 2026
08f3956
update README
nelsonjd Feb 17, 2026
07b4d8c
ignore .venv in gitignore
nelsonjd Feb 17, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
3 changes: 3 additions & 0 deletions .gitignore
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -66,3 +66,6 @@ buildNumber.properties
# another folder that is ignored by vscode
.settings/

#Python
.venv

44 changes: 15 additions & 29 deletions README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -16,8 +16,9 @@ This project aims at building a multi-agent simulator of anti-money laundering -


# Dependencies
- Java 8 (Download and copy all jar files to `jars/` directory: See also `jars/README.md`)
- [MASON](https://cs.gmu.edu/~eclab/projects/mason/) version 20
- Java 8
- Option 1: (Download and copy all jar files to `jars/` directory: See also `jars/README.md`)
- [MASON](https://people.cs.gmu.edu/~eclab/projects/mason/) version 20
- [Commons-Math](http://commons.apache.org/proper/commons-math/download_math.cgi) version 3.6.1
- [JSON in Java](https://jar-download.com/artifacts/org.json/json/20180813) version 20180813
- [WebGraph](http://webgraph.di.unimi.it/) version 3.6.1
Expand All @@ -33,11 +34,21 @@ This project aims at building a multi-agent simulator of anti-money laundering -
- [Byte Buddy Agent](https://mvnrepository.com/artifact/net.bytebuddy/byte-buddy-agent/1.11.19) version 1.11.19
- [Objenesis](https://mvnrepository.com/artifact/org.objenesis/objenesis/3.2) version 3.2
- [Mockito Inline](https://mvnrepository.com/artifact/org.mockito/mockito-inline/4.0.0) version 4.0.0
- Python 3.7 (The following packages can be installed with `pip3 install -r requirements.txt`)
- Option 2: Maven + MASON JAR
- [MASON](https://people.cs.gmu.edu/~eclab/projects/mason/) version 20. If you choose to use Maven, you only manually need to fetch and place this 1 jar file (MASON) in your `jars/` folder and then install it using the following command. The command installs the MASON dependency to your local Maven repository.
```
mvn install:install-file \
-Dfile=jars/mason.20.jar \
-DgroupId=mason \
-DartifactId=mason \
-Dversion=20 \
-Dpackaging=jar \
-DgeneratePom=true
```
- Python 3.8 (The following packages can be installed with `pip3 install -r requirements.txt`)
- numpy
- networkx==1.11 (We do not support version 2.* due to performance issues when creating a large graph)
- matplotlib==2.2.3 (The latest version is not compatible)
- pygraphviz
- powerlaw
- python-dateutil

Expand All @@ -46,8 +57,6 @@ This project aims at building a multi-agent simulator of anti-money laundering -
See Wiki page [Directory Structure](https://github.com/IBM/AMLSim/wiki/Directory-Structure) for details.
NOTE: (October 2021): `bin/` folder has been renamed to `target/classes/`



# Introduction for Running AMLSim
See Wiki page [Quick Introduction to AMLSim](https://github.com/IBM/AMLSim/wiki/Quick-Introduction-to-AMLSim) for details.

Expand Down Expand Up @@ -96,29 +105,6 @@ sh scripts/build_AMLSim.sh
sh scripts/run_AMLSim.sh conf.json
```

## 2.b. Optional: Install and Use Maven as build system.
On Mac: `brew install maven`
If you already have a java installed, you can run `brew uninstall --ignore-dependencies openjdk` because brew installs that along with maven as a dependency.

If you choose to use Maven, you only manually need to fetch and place 1 jar file (MASON) in your `jars/` folder and then install it using the command shown below. If you do not use Maven, you will have to place all the dependency jar files listed above as dependencies in the `jars/` folder.
If using Maven, use the following commands to install the MASON dependency to your local Maven repository.

```
mvn install:install-file \
-Dfile=jars/mason.20.jar \
-DgroupId=mason \
-DartifactId=mason \
-Dversion=20 \
-Dpackaging=jar \
-DgeneratePom=true
```

Please compile Java files (if not yet) (will detect and use Maven) and launch the simulator.
```bash
sh scripts/build_AMLSim.sh
sh scripts/run_AMLSim.sh conf.json
```


## 3. Convert the raw transaction log file
The file names of the output data are defined at the "output" section of `conf.json`.
Expand Down
1 change: 0 additions & 1 deletion requirements.txt
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,7 +1,6 @@
numpy
networkx==1.11
matplotlib>=3.1.2
pygraphviz
powerlaw
python-dateutil
Faker