https://github.com/cda-tum/mnt-nanoplacer

NanoPlaceR: An open-source framework for placement and routing of Field-coupled Nanotechnologies based on reinforcement learning.

https://github.com/cda-tum/mnt-nanoplacer

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

projection archival interactive generic sequences genomics observability autograding hacking shellcodes
Last synced: 10 months ago · JSON representation

Repository

NanoPlaceR: An open-source framework for placement and routing of Field-coupled Nanotechnologies based on reinforcement learning.

Basic Info
  • Host: GitHub
  • Owner: cda-tum
  • License: mit
  • Language: Python
  • Default Branch: main
  • Homepage:
  • Size: 30.3 MB
Statistics
  • Stars: 18
  • Watchers: 2
  • Forks: 1
  • Open Issues: 0
  • Releases: 13
Created over 3 years ago · Last pushed 11 months ago
Metadata Files
Readme License

README.md

PyPI License: MIT Bindings Code style: black

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

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

All Time
  • Total Commits: 137
  • Total Committers: 4
  • Avg Commits per committer: 34.25
  • Development Distribution Score (DDS): 0.088
Past Year
  • Commits: 0
  • Committers: 0
  • Avg Commits per committer: 0.0
  • Development Distribution Score (DDS): 0.0
Top Committers
Name Email 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
Committer Domains (Top 20 + Academic)
e.email: 1 tum.de: 1

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 (17) github_actions (10) python (7)

Dependencies

pyproject.toml pypi
  • 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
requirements.txt pypi
  • 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