``0.3.0``
=========

|pypi| |docs|

Performance Optimizations
-------------------------

-  Adding ``__slots__`` for all classes
-  Removing all usage of ``@property`` calls from internal callers (to
   avoid function call overhead)
-  Avoiding un-necessary data copying, e.g. ``nodes[[0], :]`` creates a
   copy but ``nodes[0, :].reshape((1, 2))``
   does not (`more
   details <https://docs.scipy.org/doc/numpy-1.6.0/reference/arrays.indexing.html#advanced-indexing>`__)
-  Adding ``_verify`` switches to selectively disable overly defensive
   value checking. Added to ``CurvedPolygon``
   `constructor <https://bezier.readthedocs.io/en/0.3.0/reference/bezier.curved_polygon.html#bezier.curved_polygon.CurvedPolygon>`__,
   ``Surface.evaluate_barycentric()`` (`doc <https://bezier.readthedocs.io/en/0.3.0/reference/bezier.surface.html#bezier.surface.Surface.evaluate_barycentric>`__),
   ``Surface.evaluate_cartesian()`` (`doc <https://bezier.readthedocs.io/en/0.3.0/reference/bezier.surface.html#bezier.surface.Surface.evaluate_cartesian>`__),
   ``Surface.evaluate_multi()`` (`doc <https://bezier.readthedocs.io/en/0.3.0/reference/bezier.surface.html#bezier.surface.Surface.evaluate_multi>`__)
   and
   ``Surface.intersect()`` (`doc <https://bezier.readthedocs.io/en/0.3.0/reference/bezier.surface.html#bezier.surface.Surface.intersect>`__).
   Internal callers with already verified data now skip verification
   steps
-  `Bailing out
   early <https://github.com/dhermes/bezier/commit/db816eb5a748bb997adcc2d7d9008638e22a824c>`__
   if surface bounding boxes are disjoint in ``Surface.intersect()``
   `method <https://bezier.readthedocs.io/en/0.3.0/reference/bezier.surface.html#bezier.surface.Surface.intersect>`__

Breaking Changes
----------------

-  Requiring ``degree`` in ``Curve``
   (`doc <https://bezier.readthedocs.io/en/0.3.0/reference/bezier.curve.html#bezier.curve.Curve>`__)
   and ``Surface``
   (`doc <https://bezier.readthedocs.io/en/0.3.0/reference/bezier.surface.html#bezier.surface.Surface>`__)
   constructors, but adding ``Curve.from_nodes()``
   (`doc <https://bezier.readthedocs.io/en/0.3.0/reference/bezier.curve.html#bezier.curve.Curve.from_nodes>`__)
   and ``Surface.from_nodes()``
   (`doc <https://bezier.readthedocs.io/en/0.3.0/reference/bezier.surface.html#bezier.surface.Surface.from_nodes>`__)
   factories to accept nodes only (computing the degree in the
   constructor every time is a waste of flops, especially if the caller
   knows the degree)
-  `Removing <https://github.com/dhermes/bezier/commit/3393b9010c26b55a9c29afc2702426bb179b85a1>`__
   public ``Curve.copy()``
   (`doc <https://bezier.readthedocs.io/en/0.2.1/reference/bezier.curve.html#bezier.curve.Curve.copy>`__)
   and ``Surface.copy()``
   (`doc <https://bezier.readthedocs.io/en/0.2.1/reference/bezier.surface.html#bezier.surface.Surface.copy>`__)
-  `Removing <https://github.com/dhermes/bezier/commit/3393b9010c26b55a9c29afc2702426bb179b85a1>`__
   custom equality checks for ``Curve``
   (`doc <https://bezier.readthedocs.io/en/0.2.1/reference/bezier.curve.html#bezier.curve.Curve.__eq__>`__)
   and ``Surface``
   (`doc <https://bezier.readthedocs.io/en/0.2.1/reference/bezier.surface.html#bezier.surface.Surface.__eq__>`__)
   objects. The previous implementation did not factor in all relevant
   values
-  Returning ``1xD`` arrays `instead of
   flattened <https://github.com/dhermes/bezier/commit/b5e5b327594c6143956ed98703f596ff82b7501a>`__
   ``D``-dimensional 1D arrays from
   ``Curve.evaluate()`` (`doc <https://bezier.readthedocs.io/en/0.3.0/reference/bezier.curve.html#bezier.curve.Curve.evaluate>`__),
   ``Surface.evaluate_barycentric()`` (`doc <https://bezier.readthedocs.io/en/0.3.0/reference/bezier.surface.html#bezier.surface.Surface.evaluate_barycentric>`__),
   ``Surface.evaluate_cartesian()`` (`doc <https://bezier.readthedocs.io/en/0.3.0/reference/bezier.surface.html#bezier.surface.Surface.evaluate_cartesian>`__),
   and related helpers
-  Renaming ``Intersection.left/right``
   `properties <https://bezier.readthedocs.io/en/0.2.1/algorithm-helpers.html#bezier._intersection_helpers.Intersection.left>`__
   as ``first/second``
   `properties <https://bezier.readthedocs.io/en/0.3.0/algorithm-helpers.html#bezier._intersection_helpers.Intersection.first>`__
   (They were poorly named originally, since "left" and "right" were in
   reference to where they were used **in code**, not geometry. This
   class is not part of the public interface, but it is documented.)

Bug Fixes
---------

-  Handling cases where one corner of a surface touches another but
   their interiors don't intersect (in the ``Surface.intersect()``
   `method <https://bezier.readthedocs.io/en/0.3.0/reference/bezier.surface.html#bezier.surface.Surface.intersect>`__).
   Adding ``ignored_corner`` classification to handle these curve-curve
   intersecions that don't contribute to a surface-surface intersection
-  Throwing exception in the ``Curve.locate()``
   `method <https://bezier.readthedocs.io/en/0.3.0/reference/bezier.curve.html#bezier.curve.Curve.locate>`__
   when the subdivided intervals are very far apart
   (`#13 <https://github.com/dhermes/bezier/issues/13>`__)
-  Improving ``Surface.is_valid``
   `property <https://bezier.readthedocs.io/en/0.3.0/reference/bezier.surface.html#bezier.surface.Surface.is_valid>`__
   by considering the signs of the Jacobian determinant at corner nodes
   (`#12 <https://github.com/dhermes/bezier/issues/12>`__)

Miscellany
----------

-  Adding possible strategy to avoid linear convergence in ``newton_refine()``
   `helper <https://bezier.readthedocs.io/en/0.3.0/algorithm-helpers.html#bezier._intersection_helpers.newton_refine>`__
-  Adding AppVeyor configuration to make sure there are no Windows
   issues, testing exclusively with ``conda`` install
-  Updating generated images with ``matplotlib`` 2.0

.. |pypi| image:: https://img.shields.io/pypi/v/bezier/0.3.0.svg
   :target: https://pypi.org/project/bezier/0.3.0/
   :alt: PyPI link to release 0.3.0
.. |docs| image:: https://readthedocs.org/projects/bezier/badge/?version=0.3.0
   :target: https://bezier.readthedocs.io/en/0.3.0/
   :alt: Documentation for release 0.3.0