https://github.com/cda-tum/mnt-nanoplacer
NanoPlaceR: An open-source framework for placement and routing of Field-coupled Nanotechnologies based on reinforcement learning.
Science Score: 36.0%
This score indicates how likely this project is to be science-related based on various indicators:
-
○CITATION.cff file
-
✓codemeta.json file
Found codemeta.json file -
✓.zenodo.json file
Found .zenodo.json file -
○DOI references
-
○Academic publication links
-
✓Committers with academic emails
1 of 4 committers (25.0%) from academic institutions -
○Institutional organization owner
-
○JOSS paper metadata
-
○Scientific vocabulary similarity
Low similarity (16.7%) to scientific vocabulary
Keywords from Contributors
Repository
NanoPlaceR: An open-source framework for placement and routing of Field-coupled Nanotechnologies based on reinforcement learning.
Basic Info
Statistics
- Stars: 18
- Watchers: 2
- Forks: 1
- Open Issues: 0
- Releases: 13
Metadata Files
README.md
NanoPlaceR: Placement and Routing for Field-coupled Nanocomputing (FCN) based on Reinforcement Learning
NanoPlaceR is a tool for the physical design of FCN circuitry based on Reinforcement Learning. It can generate layouts for logic networks up to ~200 gates, while requiring ~50% less area than the state-of-the-art heuristic approach.
Related publications: - DAC23 - ISQED24
Inspired by recent developments in the field of machine learning-aided design automation, this tool combines reinforcement learning with efficient path routing algorithms based on established algorithms such as A* search. Masked Proximal Policy Optimization (PPO) is used to learn the placement of logic elements, which is further accelerated by incorporating an action mask computed based on the netlist structure and the last partial placement, ensuring valid and compact solutions. To minimize the occurrence of unpromising partial placements, several checks constantly ensure the early termination of sub-par solutions. Furthermore, the routing of placed gates is incorporated directly into the placement step using established routing strategies. The following figure outlines the methodology:

Usage of NanoPlaceR
Currently, due to the Open-AI gym dependency, only python versions up to 3.10 are supported.
If you do not have a virtual environment set up, the following steps outline one possible way to do so. First, install virtualenv:
console
$ pip install virtualenv
Then create a new virtual environment in your project folder and activate it:
console
$ mkdir nano_placement
$ cd nano_placement
$ python -m venv venv
$ source venv/bin/activate
NanoPlaceR can be installed via pip:
console
(venv) $ pip install mnt.nanoplacer
You can then create the desired layout based on specified parameters (e.g. logic function, clocking scheme, layout width etc.) directly in your pyhon project:
``` from mnt import nanoplacer
if name == "main": nanoplacer.createlayout( benchmark="trindade16", function="mux21", clockingscheme="2DDWave", technology="QCA", minimallayoutdimension=False, layoutwidth=3, layoutheight=4, timesteps=10000, resetmodel=True, verbose=1, optimize=True, ) ```
or via the command:
(venv) $ mnt.nanoplacer
usage: mnt.nanoplacer [-h] [-b {fontes18,trindade16,EPFL,TOY,ISCAS85}] [-f FUNCTION] [-c {2DDWave,USE, RES, ESR}] [-t {QCA,SiDB, Gate-level}] [-l] [-lw LAYOUT_WIDTH] [-lh LAYOUT_HEIGHT] [-ts TIME_STEPS] [-r] [-v {0,1, 2, 3}]
Optional arguments:
-h, --help Show this help message and exit.
-b, --benchmark Benchmark set.
-f, --function Logic function to generate layout for.
-c, --clocking_scheme Underlying clocking scheme.
-t, --technology Underlying technology (QCA, SiDB or technology-independent Gate-level layout).
-l, --minimal_layout_dimension If True, experimentally found minimal layout dimensions are used (defautls to False).
-lw, --layout_width User defined layout width.
-lh, --layout_height User defined layout height.
-ts, --time_steps Number of time steps to train the RL agent.
-r, --reset_model If True, reset saved model and train from scratch (defautls to False).
-v, --verbosity 0: No information. 1: Print layout after every new best placement. 2: Print training metrics. 3: 1 and 2 combined.
-o, --optimize If True, layout will be further optimized after placement.
For example to create the gate-level layout for the mux21 function from trindade16 on the 2DDWave clocking scheme using the best found layout dimensions (by training for a maximum of 10000 timesteps):
mnt.nanoplacer -b "trindade16" -f "mux21" -c "2DDWave" -t "Gate-level" -l -ts 10000 -v 1
Repository Structure
.
├── docs/
├── src/
│ ├── mnt/
│ └── nanoplacer/
│ ├── main.py # entry point for the mnt.nanoplacer script
│ ├── benchmarks/ # common benchmark sets
│ ├── placement_envs/
│ │ └── utils/
│ │ ├── placement_utils/ # placement util functions
│ │ └── layout_dimenions/ # predefined layout dimensions for certain functions
│ └──── nano_placement_env.py # placement environment
References
In case you are using NanoPlaceR in your work, we would be thankful if you referred to it by citing the following publications:
bibtex
@INPROCEEDINGS{hofmann2023nanoplacer,
author = {S. Hofmann and M. Walter and L. Servadei and R. Wille},
title = {{Late Breaking Results From Hybrid Design Automation for Field-coupled Nanotechnologies}},
booktitle = {{2023 60th ACM/IEEE Design Automation Conference (DAC)}},
year = {2023},
}
bibtex
@INPROCEEDINGS{hofmann2024nanoplacer,
author = {S. Hofmann and M. Walter and L. Servadei and R. Wille},
title = {{Thinking Outside the Clock: Physical Design for Field-coupled Nanocomputing with Deep Reinforcement Learning}},
booktitle = {{2024 25th International Symposium on Quality Electronic Design (ISQED)}},
year = {2024},
}
Owner
- Name: Chair for Design Automation, TU Munich
- Login: cda-tum
- Kind: organization
- Location: Germany
- Website: https://www.cda.cit.tum.de
- Repositories: 22
- Profile: https://github.com/cda-tum
The CDA provides expertise for all main steps in the design and realization of integrated circuits, embedded systems, as well as cyber-physical systems.
GitHub Events
Total
- Release event: 1
- Watch event: 3
- Delete event: 1
- Push event: 2
- Pull request event: 3
- Create event: 2
Last Year
- Release event: 1
- Watch event: 3
- Delete event: 1
- Push event: 2
- Pull request event: 3
- Create event: 2
Committers
Last synced: about 1 year ago
Top Committers
| Name | Commits | |
|---|---|---|
| Simon Hofmann | s****n@t****e | 125 |
| dependabot[bot] | 4****] | 6 |
| Liam | l****h@e****l | 3 |
| Simon Hofmann | s****n@M****l | 3 |
Issues and Pull Requests
Last synced: 10 months ago
All Time
- Total issues: 1
- Total pull requests: 21
- Average time to close issues: 6 days
- Average time to close pull requests: about 5 hours
- Total issue authors: 1
- Total pull request authors: 3
- Average comments per issue: 3.0
- Average comments per pull request: 0.29
- Merged pull requests: 13
- Bot issues: 0
- Bot pull requests: 18
Past Year
- Issues: 0
- Pull requests: 3
- Average time to close issues: N/A
- Average time to close pull requests: 1 day
- Issue authors: 0
- Pull request authors: 1
- Average comments per issue: 0
- Average comments per pull request: 0.0
- Merged pull requests: 1
- Bot issues: 0
- Bot pull requests: 3
Top Authors
Issue Authors
- xiaohangguo (1)
Pull Request Authors
- dependabot[bot] (18)
- contra-bit (2)
- simon1hofmann (1)
Top Labels
Issue Labels
Pull Request Labels
Dependencies
- gym ==0.21.0
- matplotlib >=3.7.1
- networkx >=3.1
- numpy >=1.24.3
- pre-commit >=3.3.2
- setuptools >=67.8.0
- stable_baselines3 ==1.8.0
- tensorboard >=2.13.0
- torch >=2.0.1
- gym ==0.21.0
- matplotlib >=3.7.1
- networkx >=3.1
- numpy >=1.24.3
- pre-commit >=3.3.2
- setuptools >=67.8.0
- stable_baselines3 ==1.8.0
- tensorboard >=2.13.0
- torch >=2.0.1