berkus
/
topola
mirror of https://codeberg.org/topola/topola.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity
PCB topology routing
733 Commits 1 Branch 0 Tags 7.1 MiB
Rust 92.4%
Batchfile 4.7%
Fluent 2.2%
HTML 0.5%
Nix 0.1%
Go to file
Mikolaj Wielgus 8559734336 refactor: rename "trace" to "navcord", "tracer" to "navcorder" 
Navcord stands for "navigation cord". I try to prefix anything that is
specific to the navmesh with the "nav-" prefix. I chose the word "cord"
as analogy to the terms "umbilical cord" (and by extension, umbilical
cable), and "power cord".

Calling this "trace" was misleading, as this term has other meanings
that are relevant to Topola: "trace" may refer to a debugging trace, and
more importantly, to a PCB track.

I've also shortened two comments that I found to mention the navcord as
"traces" during substitution.
 		2024-10-10 03:00:27 +02:00
.woodpecker ci(build_wasm): `cargo binstall trunk` instead of installing from source 2024-10-07 02:39:16 +02:00
assets egui: make the WASM port actually work 2024-03-02 16:09:01 +00:00
examples autorouter: move `Execute` and `ExecuteWithStatus` to own file 2024-09-29 03:17:07 +02:00
locales style(locales): remove spurious `-tr-`s inside tag names 2024-10-08 02:48:14 +02:00
macros/specctra_derive style(specctra_derive): run cargo fmt over it also 2024-10-06 20:39:48 +02:00
src refactor: rename "trace" to "navcord", "tracer" to "navcorder" 2024-10-10 03:00:27 +02:00
tests chore: perform forgotten rename of `command.rs` to `execution.rs` 2024-10-04 22:00:40 +02:00
.gitignore cli: add help/manpages (#29) 2024-08-25 20:18:16 +00:00
.pre-commit-config.yaml chore(pre-commit): comment out cargo clippy, until we resolve all warnings 2024-10-06 16:59:46 +02:00
.rustfmt.toml cargo: add .rustfmt.toml file to have the same autoformatting 2024-10-04 03:04:48 +02:00
CONTRIBUTING.md contributing,install: some more info and copyediting 2024-08-27 13:20:23 +02:00
Cargo.toml build(contracts): use contracts-try v0.7 from crates.io 2024-10-06 00:18:56 +02:00
INSTALL.md contributing,install: some more info and copyediting 2024-08-27 13:20:23 +02:00
LICENSE license: fill out years and copyright holders 2024-02-19 16:43:20 +00:00
README.md readme,contributing: info about NLnet funding and some more 2024-08-27 00:28:28 +02:00
build.rs Write Specctra module documentation for Topola's library API (#34) 2024-09-27 10:29:23 +00:00
flake.lock add nix flake 2024-10-07 20:53:10 +00:00
flake.nix add nix flake 2024-10-07 20:53:10 +00:00
index.html egui: base web app on newer version of official eframe template 2024-09-17 01:52:19 +02:00

README.md

Topola

Topola is a work-in-progress interactive topological router in Rust.

The project is funded by the NLnet Foundation from the NGI0 Entrust fund.

NLnet Foundation banner NGI0 Entrust banner

Chat

Join the official Matrix chatroom or IRC channel to talk with the developers. Both chatrooms are bridged, so it does not matter which one you join.

Installation

To install Topola, follow our Installation guide.

Contributing

Anyone can contribute to Topola, including you. If you want to help us out, please follow our Contribution guide.

The easiest way to contribute is by reporting issues on our issue tracker. If you know any language other than English, you can help by translating Topola on Weblate.

Our official repository is on Codeberg. We also have a mirror repository on GitHub.

Licence

Topola is licensed under the MIT licence.

Gallery

Animation. There's a rubber band-like trace following cursor,navigating a very simple maze. The maze and the trace are red, thebackground is solid black but also very slightly white and darkblue.

Animation showing a trace, behaving like a rubber band, routed aroundobstacles step by step. Attempted alternative paths and a guiding meshare shown.

Animation. There are two upward barriers, with some space between tem,around which four rubberband traces, one over another, are wrapped.Enter mouse cursor. The cursor begins to stretch the left barrier to theright. As it's stretched, the traces cease to be wrapped around theright barrier, becoming "free". The traces and the barrier aretwo-dimensional and all solid red. The background is black but also veryslightly white and blue.

This animation shows four traces wrapped around a vertical barrierlike rubberbands. Computer cursor appears and starts dragging thebarrier's top end left and right, up and down, elastically stretchingthe barrier and having the traces continue being wrapped on the barrierregardless of its position. The traces and the barrier are all solidred. The background is black but also very slightly white andblue.

Animation. There is an upward barrier in the middle and dots on theleft and right of it, four each. A trace is drawn from the leftmost doton the left to the rightmost dot on the right. Then a trace is drawnfrom the second leftmost dot on the left to the second rightmost dot onthe right, displacing the previous trace so that there's space for thenew one. Same happens for the remaining dots. The dots, traces andbarrier are all solid red. The background is black but also veryslightly white and blue.

Animation showing three red-colored traces pass around a barrier.Trace bends are not aligned to a grid unlike most PCB layouts these days(this is called "topological routing"). The traces and the barrier areall solid red. The background is black but also very slightly white andblue.

Animation showing a trace zigzagging around two barriers. The traceand the barriers are all solid red. The background is black but alsovery slightly white and blue.