[Python-checkins] peps: Happy Tau Day folks! :)

[nick.coghlan]

http://hg.python.org/peps/rev/1e3d663c67ee
changeset:   3892:1e3d663c67ee
user:        Nick Coghlan <ncoghlan at gmail.com>
date:        Tue Jun 28 00:23:57 2011 +1000
summary:
  Happy Tau Day folks! :)

files:
  pep-0628.html |  149 ++++++++++++++++++++++++++++++++++++++
  1 files changed, 149 insertions(+), 0 deletions(-)


diff --git a/pep-0628.html b/pep-0628.html
new file mode 100644
--- /dev/null
+++ b/pep-0628.html
@@ -0,0 +1,149 @@
+<!--
+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 &lt;ncoghlan&#32;&#97;t&#32;gmail.com&gt;</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>
+

-- 
Repository URL: http://hg.python.org/peps