Replace deprecated alias Polyhedron_base.affine_hull by a new method

[mkoeppe]

#29326, renaming affine_hull to affine_hull_projection, was merged in 9.1 (released May 21, 2020).

We replace this alias by a new method affine_hull that ... computes the affine hull as a polyhedron defined by just the equations. This will conform to the ABC for convex sets (#31919)

As a courtesy, if unknown keyword arguments are passed, we point users to the renamed method.

Depends on #29811

CC: @kliem @jplab @tscrim

Component: geometry

Author: Matthias Koeppe

Branch/Commit: dfbd801

Reviewer: Jonathan Kliem

Issue created by migration from https://trac.sagemath.org/ticket/31963

[mkoeppe]

Branch: u/mkoeppe/replace_deprecated_alias_polyhedron_base_affine_hull_by_a_new_method

[mkoeppe]

Changed dependencies from #31919 to #31919, #29811

[mkoeppe]

Commit: d37c710

[mkoeppe]

Last 10 new commits:

9a7ce3a	src/sage/geometry/convex_set.py: More examples and tests
e2b0ef7	ConvexSet_base._test_convex_set: Fix doctest output
45c840a	ConvexSet_base.codim, codimension: New
17467c4	ConvexSet_base: Make dimension, ambient_dimension aliases for dim, ambient_dim
fa5dc6e	ConvexSet_base.cartesian_product: New
f4bdffd	ConvexSet_base.contains, intersection: New
465b0cb	Merge #31919
5965400	PolyhedronFace.affine_tangent_cone: New
3f13401	Merge #29811
d37c710	Polyhedron_base.affine_hull: New, replace deprecated alias for affine_hull_projection

[mkoeppe]

Author: Matthias Koeppe

[mkoeppe]

Changed dependencies from #31919, #29811 to #29811

[kliem]

comment:4

You should add the method to the polyhedron quickref in docs.

Otherwise it's good to go. Had a green bot weeks ago and everything still works.

[kliem]

Reviewer: Jonathan Kliem

[sagetrac-git]

Changed commit from d37c710 to dfbd801

[sagetrac-git]

Branch pushed to git repo; I updated commit sha1. New commits:

314e46a	Merge tag '9.4.beta4' into t/31963/replace_deprecated_alias_polyhedron_base_affine_hull_by_a_new_method
dfbd801	src/doc/en/thematic_tutorials/geometry/polyhedra_quickref.rst: Add affine_hull

[mkoeppe]

comment:7

Thanks!

[vbraun]

Changed branch from u/mkoeppe/replace_deprecated_alias_polyhedron_base_affine_hull_by_a_new_method to dfbd801