Updated some of the HTML command reference documentation to reflect

changes just made in the "extract" and "extresist" commands.
This commit is contained in:
R. Timothy Edwards 2026-01-28 17:05:00 -05:00
parent b4f62abb40
commit 55eadcfb90
2 changed files with 43 additions and 17 deletions

View File

@ -42,9 +42,11 @@ Circuit netlist extractor
<DL>
<DT> <B>capacitance</B>
<DD> Extract local parasitic capacitance values to substrate
<DT> <B>resistance</B>
<DD> Extract lumped resistance values. Note that this
is <I>not</I> the same as full parasitic resistance.
<DT> <B>coupling</B>
<DD> Extract the parasitic coupling capacitance between
nodes.
<DT> <B>lumped</B>
<DD> Extract lumped resistance values.
The values extracted are "lumped" resistance and
indicate the value for which the delay through the
net can be computed with R times C, where R is the
@ -55,9 +57,10 @@ Circuit netlist extractor
command. Lumped resistances have no meaning in
SPICE netlists and will only be used when running
<B>ext2sim</B> to generate a .sim netlist.
<DT> <B>coupling</B>
<DD> Extract the parasitic coupling capacitance between
nodes.
Prior to magic version 8.3.597, this option was
<B>resistance</B>, but as that was often confused
with full parasitic resistance extraction, it has
been changed.
<DT> <B>length</B>
<DD> Extract the length of the shortest path from a driver
to a receiver, for computing more accurate parasitic
@ -73,7 +76,7 @@ Circuit netlist extractor
array instances, is guaranteed to be strictly positive.
<DT> <B>all</B>
<DD> Apply all standard options (does not include options
"local", "labelcheck", or "aliases").
"local", "labelcheck", "aliases", or "resistance").
<DT> <B>local</B>
<DD> Write all .ext files to the current working directory.
If not specified, each .ext file will be placed in the
@ -109,6 +112,18 @@ Circuit netlist extractor
Note the difference: "extract unique" is a command that
runs immediately, and cannot be undone;
"extract do unique" is an option setting for "extract".
<DT> <B>resistance</B>
<DD> (Added in magic version 8.3.597) This setting replaces
the use of the standalone command "extresist". The
effect is the same: Magic performs full R-C extraction,
generating a <TT>.res.ext</TT> file that annotates the
existing <TT>.ext</TT> file (see the "extresist" command
documentation). The "extresist" command options can
still be used to set options such as tolerance for the
R-C extraction.
Note that prior to magic version 8.3.597, this option
name would produce the lumped resistance approximation
(see <B>lumped</B>, above).
</DL>
</BLOCKQUOTE>
These options (except for "local") determine how much
@ -223,7 +238,9 @@ Circuit netlist extractor
<I>Warning:</I> This operation immediately modifies the
existing layout in preparation for extraction. Label
modifications are permanent, and cannot be undone. All
cells in the hierarchy may potentially be modified. <BR>
cells in the hierarchy may potentially be modified. To avoid
this issue, use the "extract do unique" option instead (see
above). <BR>
<DT> <B>warn</B> [[<B>no</B>] <I>option</I>]
<DD> Enable/disable reporting of non-fatal errors, where <I>option</I>
may be one of the following:

View File

@ -92,17 +92,25 @@ information.
The <B>extresist</B> command provides a method for generating
a more detailed model of resistance, in which long network
routes and branching routes are replaced with resistor devices
and device networks. <P>
and device networks. This is known as "full R-C extraction". <P>
Using <B>extresist</B> is a multi-step process. It is first
necessary to run both <B>extract</B> and <B>ext2sim</B> to get
the initial netlist (with lumped, not detailed, resistances).
After a <TT>.sim</TT> file has been generated, the
<B>extresist all</B> command may be run. The output is
Using <B>extresist</B> as a standalone command is a multi-step
process. It is first necessary to run <B>extract</B> to get
the initial netlist.
After a <TT>.ext</TT> file has been generated, the
<B>extresist</B> command may be run. The output is
a file <TT>.res.ext</TT> for each cell in the hierarchy.
Finally, with the option <B>extresist on</B> set,
<B>ext2sim</B> or <B>ext2spice</B> will generate the final,
detailed simulation file. <P>
Finally, with the option <B>extresist on</B> set, <B>ext2spice</B>
will generate the final, detailed simulation file. <P>
Prior to magic version 8.3.597, it was also necessary to run
<B>ext2sim labels on</B> and <B>ext2sim</B> to write out a
<TT>.sim</TT> and a <TT>.node</TT> file before running
<B>extresist</B>. This is no longer necessary. There is since
magic version 8.3.597 an option <B>extract do resistance</B>
that runs the resistance extraction in sequence with the regular
extraction, producing both the <TT>.ext</TT> and <TT>.res.ext</TT>
files.
More details on using <B>extresist</B> can be found in
<B>magic</B> Tutorial number 8.
@ -117,6 +125,7 @@ information.
<BLOCKQUOTE>
<A HREF=extract.html><B>extract</B></A> <BR>
<A HREF=ext2sim.html><B>ext2sim</B></A> <BR>
<A HREF=ext2spice.html><B>ext2spice</B></A> <BR>
</BLOCKQUOTE>
<P><IMG SRC=graphics/line1.gif><P>