Take two, this time with the correct extension :)
This commit is contained in:
Nick Coghlan
parent
3ac4e23b31
commit
50097f94fc
149
pep-0628.html
149
pep-0628.html
|
|
@ -1,149 +0,0 @@
|
|||
<!--
|
||||
This HTML is auto-generated. DO NOT EDIT THIS FILE! If you are writing a new
|
||||
PEP, see http://www.python.org/dev/peps/pep-0001 for instructions and links
|
||||
to templates. DO NOT USE THIS HTML FILE AS YOUR TEMPLATE!
|
||||
-->
|
||||
<table class="rfc2822 docutils field-list" frame="void" rules="none">
|
||||
<col class="field-name" />
|
||||
<col class="field-body" />
|
||||
<tbody valign="top">
|
||||
<tr class="field"><th class="field-name">PEP:</th><td class="field-body">628</td>
|
||||
</tr>
|
||||
<tr class="field"><th class="field-name">Title:</th><td class="field-body">Add <tt class="docutils literal">math.tau</tt></td>
|
||||
</tr>
|
||||
<tr class="field"><th class="field-name">Version:</th><td class="field-body">$Revision$</td>
|
||||
</tr>
|
||||
<tr class="field"><th class="field-name">Last-Modified:</th><td class="field-body"><a class="reference external" href="http://svn.python.org/view/*checkout*/peps/trunk/pep-0628.txt">$Date$</a></td>
|
||||
</tr>
|
||||
<tr class="field"><th class="field-name">Author:</th><td class="field-body">Nick Coghlan <ncoghlan at gmail.com></td>
|
||||
</tr>
|
||||
<tr class="field"><th class="field-name">Status:</th><td class="field-body">Deferred</td>
|
||||
</tr>
|
||||
<tr class="field"><th class="field-name">Type:</th><td class="field-body">Standards Track</td>
|
||||
</tr>
|
||||
<tr class="field"><th class="field-name">Content-Type:</th><td class="field-body"><a class="reference external" href="/dev/peps/pep-0012">text/x-rst</a></td>
|
||||
</tr>
|
||||
<tr class="field"><th class="field-name">Created:</th><td class="field-body">2011-06-28</td>
|
||||
</tr>
|
||||
<tr class="field"><th class="field-name">Python-Version:</th><td class="field-body">3.3</td>
|
||||
</tr>
|
||||
<tr class="field"><th class="field-name">Post-History:</th><td class="field-body">2011-06-28</td>
|
||||
</tr>
|
||||
<tr class="field"><th class="field-name">Resolution:</th><td class="field-body">TBD</td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
<hr />
|
||||
<div class="contents topic" id="contents">
|
||||
<p class="topic-title first">Contents</p>
|
||||
<ul class="simple">
|
||||
<li><a class="reference internal" href="#abstract" id="id12">Abstract</a></li>
|
||||
<li><a class="reference internal" href="#pep-deferral" id="id13">PEP Deferral</a></li>
|
||||
<li><a class="reference internal" href="#the-rationale-for-tau" id="id14">The Rationale for Tau</a></li>
|
||||
<li><a class="reference internal" href="#other-resources" id="id15">Other Resources</a></li>
|
||||
<li><a class="reference internal" href="#id1" id="id16">References</a></li>
|
||||
<li><a class="reference internal" href="#copyright" id="id17">Copyright</a></li>
|
||||
</ul>
|
||||
</div>
|
||||
<div class="section" id="abstract">
|
||||
<h1><a class="toc-backref" href="#id12">Abstract</a></h1>
|
||||
<p>In honour of Tau Day 2011, this PEP proposes the addition of the circle
|
||||
constant <tt class="docutils literal">math.tau</tt> to the Python standard library.</p>
|
||||
<p>The concept of <tt class="docutils literal">tau</tt> (<tt class="docutils literal">τ</tt>) is based on the observation that the ratio of a
|
||||
circle's circumference to its radius is far more fundamental and interesting
|
||||
than the ratio between its circumference and diameter. It is simply a matter
|
||||
of assigning a name to the value <tt class="docutils literal">2 * pi</tt> (<tt class="docutils literal">2π</tt>).</p>
|
||||
</div>
|
||||
<div class="section" id="pep-deferral">
|
||||
<h1><a class="toc-backref" href="#id13">PEP Deferral</a></h1>
|
||||
<p>The idea in this PEP was first proposed in the auspiciously named
|
||||
<a class="reference external" href="http://bugs.python.org/issue12345">issue 12345</a> <a class="footnote-reference" href="#id2" id="id3">[1]</a>. The immediate negative reactions I received from other core
|
||||
developers on that issue made it clear to me that there wasn't likely to be
|
||||
much collective interest in being part of a movement towards greater clarity
|
||||
in the explanation of profound mathematical concepts that are unnecessarily
|
||||
obscured by a historical quirk of notation.</p>
|
||||
<p>Accordingly, this PEP is being submitted in a Deferred state, in the hope
|
||||
that it may someday be revisited if the mathematical and educational
|
||||
establishment choose to adopt a more enlightened and informative notation
|
||||
for dealing with radians.</p>
|
||||
<p>Converts to the merits of <tt class="docutils literal">tau</tt> as the more fundamental circle constant
|
||||
should feel free to start their mathematical code with <tt class="docutils literal">tau = 2 * math.pi</tt>.</p>
|
||||
</div>
|
||||
<div class="section" id="the-rationale-for-tau">
|
||||
<h1><a class="toc-backref" href="#id14">The Rationale for Tau</a></h1>
|
||||
<p><tt class="docutils literal">pi</tt> is defined as the ratio of a circle's circumference to its diameter.
|
||||
However, a circle is defined by its centre point and its <em>radius</em>. This is
|
||||
shown clearly when we note that the parameter of integration to go from a
|
||||
circle's circumference to its area is the radius, not the diameter. If we
|
||||
use the diameter instead we have to divide by four to get rid of the
|
||||
extraneous multiplier.</p>
|
||||
<p>When working with radians, it is trivial to convert any given fraction of a
|
||||
circle to a value in radians in terms of <tt class="docutils literal">tau</tt>. A quarter circle is
|
||||
<tt class="docutils literal">tau/4</tt>, a half circle is <tt class="docutils literal">tau/2</tt>, seven 25ths is <tt class="docutils literal">7*tau/25</tt>, etc. In
|
||||
contrast with the equivalent expressions in terms of <tt class="docutils literal">pi</tt> (<tt class="docutils literal">pi/2</tt>, <tt class="docutils literal">pi</tt>,
|
||||
<tt class="docutils literal">14*pi/25</tt>), the unnecessary and needlessly confusing multiplication by
|
||||
two is gone.</p>
|
||||
</div>
|
||||
<div class="section" id="other-resources">
|
||||
<h1><a class="toc-backref" href="#id15">Other Resources</a></h1>
|
||||
<p>I've barely skimmed the surface of the many examples put forward to point out
|
||||
just how much <em>easier</em> and more <em>sensible</em> many aspects of mathematics become
|
||||
when conceived in terms of <tt class="docutils literal">tau</tt> rather than <tt class="docutils literal">pi</tt>. If you don't find my
|
||||
specific examples sufficiently persausive, here are some more resources that
|
||||
may be of interest:</p>
|
||||
<blockquote>
|
||||
<ul class="simple">
|
||||
<li>Michael Hartl is the primary instigator of Tau Day in his <a class="reference external" href="http://tauday.com/">Tau Manifesto</a> <a class="footnote-reference" href="#id4" id="id5">[2]</a></li>
|
||||
<li>Bob Palais, the author of the original mathematics journal article
|
||||
highlighting the problems with <tt class="docutils literal">pi</tt> has <a class="reference external" href="http://www.math.utah.edu/~palais/pi.html">a page of resources</a> <a class="footnote-reference" href="#id10" id="id11">[5]</a> on the
|
||||
topic</li>
|
||||
<li>For those that prefer videos to written text, <a class="reference external" href="http://www.youtube.com/watch?v=IF1zcRoOVN0">Pi is wrong!</a> <a class="footnote-reference" href="#id8" id="id9">[4]</a> and
|
||||
<a class="reference external" href="http://www.youtube.com/watch?v=jG7vhMMXagQ">Pi is (still) wrong</a> <a class="footnote-reference" href="#id6" id="id7">[3]</a> are available on YouTube</li>
|
||||
</ul>
|
||||
</blockquote>
|
||||
</div>
|
||||
<div class="section" id="id1">
|
||||
<h1><a class="toc-backref" href="#id16">References</a></h1>
|
||||
<table class="docutils footnote" frame="void" id="id2" rules="none">
|
||||
<colgroup><col class="label" /><col /></colgroup>
|
||||
<tbody valign="top">
|
||||
<tr><td class="label"><a class="fn-backref" href="#id3">[1]</a></td><td><a class="reference external" href="http://bugs.python.org/issue12345">http://bugs.python.org/issue12345</a></td></tr>
|
||||
</tbody>
|
||||
</table>
|
||||
<table class="docutils footnote" frame="void" id="id4" rules="none">
|
||||
<colgroup><col class="label" /><col /></colgroup>
|
||||
<tbody valign="top">
|
||||
<tr><td class="label"><a class="fn-backref" href="#id5">[2]</a></td><td><a class="reference external" href="http://tauday.com/">http://tauday.com/</a></td></tr>
|
||||
</tbody>
|
||||
</table>
|
||||
<table class="docutils footnote" frame="void" id="id6" rules="none">
|
||||
<colgroup><col class="label" /><col /></colgroup>
|
||||
<tbody valign="top">
|
||||
<tr><td class="label"><a class="fn-backref" href="#id7">[3]</a></td><td><a class="reference external" href="http://www.youtube.com/watch?v=jG7vhMMXagQ">http://www.youtube.com/watch?v=jG7vhMMXagQ</a></td></tr>
|
||||
</tbody>
|
||||
</table>
|
||||
<table class="docutils footnote" frame="void" id="id8" rules="none">
|
||||
<colgroup><col class="label" /><col /></colgroup>
|
||||
<tbody valign="top">
|
||||
<tr><td class="label"><a class="fn-backref" href="#id9">[4]</a></td><td><a class="reference external" href="http://www.youtube.com/watch?v=IF1zcRoOVN0">http://www.youtube.com/watch?v=IF1zcRoOVN0</a></td></tr>
|
||||
</tbody>
|
||||
</table>
|
||||
<table class="docutils footnote" frame="void" id="id10" rules="none">
|
||||
<colgroup><col class="label" /><col /></colgroup>
|
||||
<tbody valign="top">
|
||||
<tr><td class="label"><a class="fn-backref" href="#id11">[5]</a></td><td><a class="reference external" href="http://www.math.utah.edu/~palais/pi.html">http://www.math.utah.edu/~palais/pi.html</a></td></tr>
|
||||
</tbody>
|
||||
</table>
|
||||
</div>
|
||||
<div class="section" id="copyright">
|
||||
<h1><a class="toc-backref" href="#id17">Copyright</a></h1>
|
||||
<p>This document has been placed in the public domain.</p>
|
||||
<!-- Local Variables:
|
||||
mode: indented-text
|
||||
indent-tabs-mode: nil
|
||||
sentence-end-double-space: t
|
||||
fill-column: 70
|
||||
coding: utf-8
|
||||
End: -->
|
||||
</div>
|
||||
|
||||
|
|
@ -0,0 +1,100 @@
|
|||
PEP: 628
|
||||
Title: Add ``math.tau``
|
||||
Version: $Revision$
|
||||
Last-Modified: $Date$
|
||||
Author: Nick Coghlan <ncoghlan@gmail.com>
|
||||
Status: Deferred
|
||||
Type: Standards Track
|
||||
Content-Type: text/x-rst
|
||||
Created: 2011-06-28
|
||||
Python-Version: 3.x
|
||||
Post-History: 2011-06-28
|
||||
Resolution: TBD
|
||||
|
||||
|
||||
Abstract
|
||||
========
|
||||
|
||||
In honour of Tau Day 2011, this PEP proposes the addition of the circle
|
||||
constant ``math.tau`` to the Python standard library.
|
||||
|
||||
The concept of ``tau`` (``τ``) is based on the observation that the ratio of a
|
||||
circle's circumference to its radius is far more fundamental and interesting
|
||||
than the ratio between its circumference and diameter. It is simply a matter
|
||||
of assigning a name to the value ``2 * pi`` (``2π``).
|
||||
|
||||
|
||||
PEP Deferral
|
||||
============
|
||||
|
||||
The idea in this PEP was first proposed in the auspiciously named
|
||||
`issue 12345`_. The immediate negative reactions I received from other core
|
||||
developers on that issue made it clear to me that there wasn't likely to be
|
||||
much collective interest in being part of a movement towards greater clarity
|
||||
in the explanation of profound mathematical concepts that are unnecessarily
|
||||
obscured by a historical quirk of notation.
|
||||
|
||||
Accordingly, this PEP is being submitted in a Deferred state, in the hope
|
||||
that it may someday be revisited if the mathematical and educational
|
||||
establishment choose to adopt a more enlightened and informative notation
|
||||
for dealing with radians.
|
||||
|
||||
Converts to the merits of ``tau`` as the more fundamental circle constant
|
||||
should feel free to start their mathematical code with ``tau = 2 * math.pi``.
|
||||
|
||||
.. _issue 12345: http://bugs.python.org/issue12345
|
||||
|
||||
|
||||
The Rationale for Tau
|
||||
=====================
|
||||
|
||||
``pi`` is defined as the ratio of a circle's circumference to its diameter.
|
||||
However, a circle is defined by its centre point and its *radius*. This is
|
||||
shown clearly when we note that the parameter of integration to go from a
|
||||
circle's circumference to its area is the radius, not the diameter. If we
|
||||
use the diameter instead we have to divide by four to get rid of the
|
||||
extraneous multiplier.
|
||||
|
||||
When working with radians, it is trivial to convert any given fraction of a
|
||||
circle to a value in radians in terms of ``tau``. A quarter circle is
|
||||
``tau/4``, a half circle is ``tau/2``, seven 25ths is ``7*tau/25``, etc. In
|
||||
contrast with the equivalent expressions in terms of ``pi`` (``pi/2``, ``pi``,
|
||||
``14*pi/25``), the unnecessary and needlessly confusing multiplication by
|
||||
two is gone.
|
||||
|
||||
|
||||
Other Resources
|
||||
===============
|
||||
|
||||
I've barely skimmed the surface of the many examples put forward to point out
|
||||
just how much *easier* and more *sensible* many aspects of mathematics become
|
||||
when conceived in terms of ``tau`` rather than ``pi``. If you don't find my
|
||||
specific examples sufficiently persausive, here are some more resources that
|
||||
may be of interest:
|
||||
|
||||
* Michael Hartl is the primary instigator of Tau Day in his `Tau Manifesto`_
|
||||
* Bob Palais, the author of the original mathematics journal article
|
||||
highlighting the problems with ``pi`` has `a page of resources`_ on the
|
||||
topic
|
||||
* For those that prefer videos to written text, `Pi is wrong!`_ and
|
||||
`Pi is (still) wrong`_ are available on YouTube
|
||||
|
||||
.. _Tau Manifesto: http://tauday.com/
|
||||
.. _Pi is (still) wrong: http://www.youtube.com/watch?v=jG7vhMMXagQ
|
||||
.. _Pi is wrong!: http://www.youtube.com/watch?v=IF1zcRoOVN0
|
||||
.. _a page of resources: http://www.math.utah.edu/~palais/pi.html
|
||||
|
||||
|
||||
Copyright
|
||||
=========
|
||||
|
||||
This document has been placed in the public domain.
|
||||
|
||||
..
|
||||
Local Variables:
|
||||
mode: indented-text
|
||||
indent-tabs-mode: nil
|
||||
sentence-end-double-space: t
|
||||
fill-column: 70
|
||||
coding: utf-8
|
||||
End:
|
||||
Loading…
Reference in New Issue