A python package to plot maps of semiconductor wafers.
Free software: MIT license
- Circular wafers with arbitrary notch orientations and full or inner layouts.
- Grid with adjustable offset and origin, cells with adjustable size and margin.
- Edge-exclusion.
- Hover-able points, vectors and images.
- Tooltips with embeddable images.
- Individual labels and colors for each die.
- Toggle layers on/off individually.
- Export zoom-able maps to HTML.
- Export PNG images (needs Chromium)
-
See the full dynamic maps here!
-
Static png image, just to get a taste:
To install Wafermap, run this command in your terminal:
$ pip install wafermap
This is the preferred method to install Wafermap, as it will always install the most recent stable release.
If you don't have pip installed, this Python installation guide can guide you through the process.
The source for Wafermap can be downloaded from the Github repo.
You can clone the public repository:
$ git clone git://github.com/cap1tan/wafermap
To use Wafermap in a project
import wafermap
First let's define a Wafermap:
wm = wafermap.WaferMap(wafer_radius=100, # all length dimensions in mm
cell_size=(10, 20), # (sizeX, sizeY)
cell_margin=(8, 15), # distance between cell borders (x, y)
cell_origin=(0, 0), # which cell to select as origin (0, 0), in (x, y)
grid_offset=(-2.05, -4.1), # grid offset in (x, y)
edge_exclusion=2.2, # margin from the wafer edge where a red edge exclusion ring is drawn
coverage='full', # 'full': will cover wafer with cells, partial cells allowed
# 'inner': only full cells allowed
notch_orientation=270) # angle of notch in degrees. 270 corresponds to a notch at the bottom
To add an image at a specific cell/relative cell coordinates simply:
wm.add_image(image_source_file="inspection1.jpg",
cell=(1, 0), # (cell_index_x, cell_index_y)
offset=(2.0, 2.0)) # relative coordinate of the image within the cell
Adding vectors is just as easy. Just define cell and [(start_rel_coordinates), (end_rel_coordinates)]:
vectors = [
((3, 0), [(0, 0), (1, 1)]),
((3, 0), [(1, 0), (-5, 5)]),
((3, 0), [(0, 1), (10, -10)]),
((3, 0), [(1, 1), (-20, -20)]),
]
colors = ['green', 'red', 'blue', 'black']
for color, (cell, vector) in zip(colors, vectors):
wm.add_vector(vector_points=vector, cell=cell, vector_style={'color': color}, root_style={'radius': 1, 'color': color})
Let's throw in some points in a normal distribution for good measure too:
# add 50 points per cell, in a random distribution
import random as rnd
cell_size = (10, 20)
cell_points = [(cell, [(rnd.gauss(cell_size[0] / 2, cell_size[0] / 6),
rnd.gauss(cell_size[1] / 2, cell_size[1] / 6)) for _ in
range(50)]) for cell in wm.cell_map.keys()]
for cell, cell_points_ in cell_points:
for cell_point in cell_points_:
wm.add_point(cell=cell, offset=cell_point)
Finally, nothing would matter if we couldn't see the result:
# save to html
wm.save_html(f"wafermap.html")
# save to png (Chromium must be installed)
wm.save_png(f"wafermap.png")
- Folium & branca -> to make dynamic, zoom-able and pan-able HTML based maps
- Pillow -> to support embedded images and format the optional image output
- Chromium -> exporting to .png images
Contributions are welcome, and they are greatly appreciated! Every little bit helps, and credit will always be given.
You can contribute in many ways:
Report bugs at https://github.com/cap1tan/wafermap/issues.
If you are reporting a bug, please include:
- Your operating system name and version.
- Any details about your local setup that might be helpful in troubleshooting.
- Detailed steps to reproduce the bug.
Look through the GitHub issues for bugs. Anything tagged with "bug" and "help wanted" is open to whoever wants to implement it.
Look through the GitHub issues for features. Anything tagged with "enhancement" and "help wanted" is open to whoever wants to implement it.
Wafermap could always use more documentation, whether as part of the official Wafermap docs, in docstrings, or even on the web in blog posts, articles, and such.
The best way to send feedback is to file an issue at https://github.com/cap1tan/wafermap/issues.
If you are proposing a feature:
- Explain in detail how it would work.
- Keep the scope as narrow as possible, to make it easier to implement.
- Remember that this is a volunteer-driven project, and that contributions are welcome :)
Ready to contribute? Here's how to set up wafermap
for local development.
- Fork the
wafermap
repo on GitHub. - Clone your fork locally
$ git clone git@github.com:your_name_here/wafermap.git
- Ensure poetry is installed.
- Install dependencies and start your virtualenv:
$ poetry install -E test -E doc -E dev
- Create a branch for local development:
$ git checkout -b name-of-your-bugfix-or-feature
Now you can make your changes locally.
- When you're done making changes, check that your changes pass the tests, including testing other Python versions, with tox:
$ tox
- Commit your changes and push your branch to GitHub:
$ git add .
$ git commit -m "Your detailed description of your changes."
$ git push origin name-of-your-bugfix-or-feature
- Submit a pull request through the GitHub website.
Before you submit a pull request, check that it meets these guidelines:
- The pull request should include tests.
- If the pull request adds functionality, the docs should be updated. Put your new functionality into a function with a docstring, and add the feature to the list in README.md.
- The pull request should work for Python 3.6, 3.7, 3.8, 3.9 and for PyPy. Check https://github.com/cap1tan/wafermap/actions and make sure that the tests pass for all supported Python versions.
$ python -m unittest tests.test_wafermap
To run a subset of tests.
A reminder for the maintainers on how to deploy. Make sure all your changes are committed (including an entry in HISTORY.md). Then run:
$ poetry patch # possible: major / minor / patch
$ git push
$ git push --tags
Github Actions will then deploy to PyPI if tests pass.