66 < head >
77 < meta charset ="utf-8 " />
88 < meta name ="viewport " content ="width=device-width, initial-scale=1.0 " />
9- < title > skidl.circuit — SKiDL 2.0.0 documentation</ title >
9+ < title > skidl.circuit — SKiDL 2.0.1 documentation</ title >
1010 < link rel ="stylesheet " type ="text/css " href ="../../_static/pygments.css?v=fa44fd50 " />
1111 < link rel ="stylesheet " type ="text/css " href ="../../_static/bizstyle.css?v=a66e137f " />
1212
13- < script src ="../../_static/documentation_options.js?v=51b770b3 "> </ script >
13+ < script src ="../../_static/documentation_options.js?v=f5cff4aa "> </ script >
1414 < script src ="../../_static/doctools.js?v=9a2dae69 "> </ script >
1515 < script src ="../../_static/sphinx_highlight.js?v=dc90522c "> </ script >
1616 < script src ="../../_static/bizstyle.js "> </ script >
@@ -32,7 +32,7 @@ <h3>Navigation</h3>
3232 < li class ="right " >
3333 < a href ="../../py-modindex.html " title ="Python Module Index "
3434 > modules</ a > |</ li >
35- < li class ="nav-item nav-item-0 "> < a href ="../../index.html "> SKiDL 2.0.0 documentation</ a > »</ li >
35+ < li class ="nav-item nav-item-0 "> < a href ="../../index.html "> SKiDL 2.0.1 documentation</ a > »</ li >
3636 < li class ="nav-item nav-item-1 "> < a href ="../index.html " accesskey ="U "> Module code</ a > »</ li >
3737 < li class ="nav-item nav-item-this "> < a href =""> skidl.circuit</ a > </ li >
3838 </ ul >
@@ -510,7 +510,15 @@ <h1>Source code for skidl.circuit</h1><div class="highlight"><pre>
510510< div class ="viewcode-block " id ="Circuit.merge_nets ">
511511< a class ="viewcode-back " href ="../../rst_output/skidl.circuit.html#skidl.circuit.Circuit.merge_nets "> [docs]</ a >
512512 < span class ="k "> def</ span > < span class ="nf "> merge_nets</ span > < span class ="p "> (</ span > < span class ="bp "> self</ span > < span class ="p "> ):</ span >
513- < span class ="w "> </ span > < span class ="sd "> """Merge multi-segment nets into a single net."""</ span >
513+ < span class ="w "> </ span > < span class ="sd "> """</ span >
514+ < span class ="sd "> Merge multi-segment nets into a single net.</ span >
515+
516+ < span class ="sd "> Note: Multi-segment nets had to be merged or else tests to detect the</ span >
517+ < span class ="sd "> same net would fail in routing.py when generating schematics.</ span >
518+ < span class ="sd "> But as a result of merging, net variables can become invalid because of new merging.</ span >
519+ < span class ="sd "> Therefore, only do this when generating schematics so other generate_*() functions</ span >
520+ < span class ="sd "> will not be affected.</ span >
521+ < span class ="sd "> """</ span >
514522
515523 < span class ="n "> merged_nets</ span > < span class ="o "> =</ span > < span class ="nb "> set</ span > < span class ="p "> ()</ span >
516524 < span class ="k "> for</ span > < span class ="n "> net</ span > < span class ="ow "> in</ span > < span class ="bp "> self</ span > < span class ="o "> .</ span > < span class ="n "> nets</ span > < span class ="p "> :</ span >
@@ -1112,6 +1120,7 @@ <h1>Source code for skidl.circuit</h1><div class="highlight"><pre>
11121120 < span class ="n "> skidl</ span > < span class ="o "> .</ span > < span class ="n "> empty_footprint_handler</ span > < span class ="o "> =</ span > < span class ="n "> _empty_footprint_handler</ span >
11131121
11141122 < span class ="bp "> self</ span > < span class ="o "> .</ span > < span class ="n "> _preprocess</ span > < span class ="p "> ()</ span >
1123+ < span class ="bp "> self</ span > < span class ="o "> .</ span > < span class ="n "> merge_nets</ span > < span class ="p "> ()</ span > < span class ="c1 "> # Merge nets or schematic routing will fail.</ span >
11151124
11161125 < span class ="n "> tool</ span > < span class ="o "> =</ span > < span class ="n "> kwargs</ span > < span class ="o "> .</ span > < span class ="n "> pop</ span > < span class ="p "> (</ span > < span class ="s2 "> "tool"</ span > < span class ="p "> ,</ span > < span class ="n "> skidl</ span > < span class ="o "> .</ span > < span class ="n "> config</ span > < span class ="o "> .</ span > < span class ="n "> tool</ span > < span class ="p "> )</ span >
11171126
@@ -1278,7 +1287,6 @@ <h1>Source code for skidl.circuit</h1><div class="highlight"><pre>
12781287< span class ="w "> </ span > < span class ="sd "> """Prepare the circuit for generating a netlist, PCB, etc."""</ span >
12791288
12801289 < span class ="c1 "> # self._cull_unconnected_parts()</ span >
1281- < span class ="bp "> self</ span > < span class ="o "> .</ span > < span class ="n "> merge_nets</ span > < span class ="p "> ()</ span >
12821290 < span class ="bp "> self</ span > < span class ="o "> .</ span > < span class ="n "> _check_for_empty_footprints</ span > < span class ="p "> ()</ span >
12831291
12841292 < span class ="nd "> @property</ span >
@@ -1323,7 +1331,7 @@ <h3>Navigation</h3>
13231331 < li class ="right " >
13241332 < a href ="../../py-modindex.html " title ="Python Module Index "
13251333 > modules</ a > |</ li >
1326- < li class ="nav-item nav-item-0 "> < a href ="../../index.html "> SKiDL 2.0.0 documentation</ a > »</ li >
1334+ < li class ="nav-item nav-item-0 "> < a href ="../../index.html "> SKiDL 2.0.1 documentation</ a > »</ li >
13271335 < li class ="nav-item nav-item-1 "> < a href ="../index.html " > Module code</ a > »</ li >
13281336 < li class ="nav-item nav-item-this "> < a href =""> skidl.circuit</ a > </ li >
13291337 </ ul >
0 commit comments