Debian Codegraph @

texmf-dist/doc/latex/tkz-elements/CHANGELOG.md

raw
1 ## [2026/04/11 — version 5.06c]
2
3 ### Changed
4 - **triangle**
5 - Changed the order of returned points for `reflections` and `projections`:
6 (1 → pa, 2 → pb, 3 → pc).
7 - Added methods returning directly the vertices of special triangles:
8 - `orthic_points()`
9 - `medial_points()`
10 - `tangential_points()`
11 - **circle**
12 - Modification of the `point` method. Added an optional point parameter to specify the reference point on the circle.
13
14 ### Documentation
15 - Reorganized the method descriptions in the **point** class, especially for utility methods and the `rotation` method.
16 - Fixed an incorrect example of the `PPP` method in the **point** class.
17 - Section 16.4.1 (Parabola construction): corrected `bisector of angle HMF` (instead of `angle HFT`).
18 - Section 7.3 (Use of Trilinear Coordinates): corrected `projection` → `projections` in the code.
19 Thanks to :SwiftWu for these remarks.
20 - Added documentation for the `print` method.
21
22 ## [2026/03/14 — version 5.05c]
23
24 ### Added
25 - **triangle**
26 - methods `isotomic`, `complement`, `anticomplement`
27 - function triangle:ellipse_inscribed({brianchon/center/focus})
28 - function triangle:cevian_point(p, q, eps)
29
30 - **conics**
31 - function EL_five_points(z1,z2,z3,z4,z5)
32
33 ### Documentation
34 - **conic**
35 - documentation clarification about constructor usage and helper functions
36
37
38 ## [2026/03/11 — version 5.04c]
39
40 ### Added
41
42 - **triangle**
43 - Added new attributes: `ma`, `mb`, `mc`, `ha`, `hb`, `hc`, `ia`, `ib`, `ic`
44 - `ma`, `mb`, `mc`: midpoints of the sides
45 - `ha`, `hb`, `hc`: feet of the altitudes
46 - `ia`, `ib`, `ic`: feet of the internal angle bisectors
47
48 - Added method: `triangle:reflections(pt)`
49
50 ### Changed
51
52 - **triangle**
53 - Renamed method: `projection(pt)` -> `projections(pt)`
54
55 ### Notes
56 - **triangle**
57 - `projections(pt)` and `reflections(pt)` apply to an arbitrary point.
58 - `projection()` and `reflection()` apply to the triangle vertices.
59
60
61 ## [2026/03/11 — version 5.04c]
62
63 ### Added
64
65 - **triangle**
66 - Added new attributes: `ma`, `mb`, `mc`, `ha`, `hb`, `hc`, `ia`, `ib`, `ic`
67 - `ma`, `mb`, `mc`: midpoints of the sides
68 - `ha`, `hb`, `hc`: feet of the altitudes
69 - `ia`, `ib`, `ic`: feet of the internal angle bisectors
70
71 - Added method: `triangle:reflections(pt)`
72
73 ### Changed
74
75 - **triangle**
76 - Renamed method: `projection(pt)` -> `projections(pt)`
77
78 ### Notes
79 - **triangle**
80 - `projections(pt)` and `reflections(pt)` apply to an arbitrary point.
81 - `projection()` and `reflection()` apply to the triangle vertices.
82
83
84 ## [2026/03/04 — version 5.03c]
85
86 ### Changed
87
88 - **path**
89 - `add_point` now accepts either a `point` object or a string
90 representing coordinates (e.g. `"(2,3)"`, `"(1e-5,0)"`).
91 - String arguments are automatically parsed using
92 `utils.parse_point`.
93 - Improves API flexibility while preserving internal
94 TikZ-formatted storage.
95
96 - **utils**
97 - Clarified and documented support for scientific notation
98 in `parse_point` (e.g. `1e-5`, `2E3`).
99 - Improved documentation of `format_number`,
100 `checknumber`, and `to_decimal_string`.
101 - Reinforced consistent fixed-decimal formatting
102 for TikZ output.
103
104 - **tkz-elements.sty**
105 - Removed the `tkzelements` environment.
106
107 - **point**
108 - Unified approximate equality and geometric identity.
109 - `__eq` now uses the same Euclidean proximity criterion as `identity`.
110 - Removed coordinate-wise comparison in favor of a rotation-invariant
111 distance test.
112 - Centralized comparison logic for improved numerical consistency.
113
114 - **triangle**
115 - Added `radical_circle`: the circle orthogonal to the three excentral circles.
116 - Added `the_apollonius_center` and `the_apollonius_circle`.
117 - `triangle.feuerbach` is now defined as `triangle.euler_circle()`.
118
119 ### Documentation
120
121 - Improved documentation of `\tkzDrawCoordinates`.
122 - Explained its direct mapping to TikZ `plot coordinates`.
123 - Clarified that a Lua `path` is a discrete computational object
124 rendered as an explicit polygonal chain.
125 - Emphasized the design principle:
126
127 *Lua computes — TikZ draws.*
128
129 - Clarified terminology:
130 - **mediator** refers to the **perpendicular bisector** of a segment.
131
132
133 ## [2026/02/20 — version 5.02c]
134
135 ### Added
136
137 #### **path**
138 - Added method `scale` (anisotropic scaling).
139
140 #### **fct**
141 - Added methods `half_tangents` and `tangent`.
142 - Tangents now return **unit direction points** (instead of `line` objects).
143 - Fully compatible with `set_scale`.
144 - Unified implementation based on coordinate generation.
145
146 ---
147
148 ### Changed
149
150 #### **path**
151 - In `homothety`, the center argument is now optional.
152
153 #### **fct** and **pfct**
154 - Removed graph-related drawing macros:
155 `\tkzDrawPointOnGraph`, `\tkzDrawPointsOnGraph`,
156 `\tkzDrawPointOnParamGraph`, and `\tkzDrawPointsOnParamGraph`.
157
158 These macros were incompatible with `set_scale` and conflicted
159 with the package design principle: computations must be
160 performed in Lua, while drawing is delegated to TikZ or
161 `\tkzDrawPoints`.
162
163 #### **tkz-elements.sty**
164 - Cleanup and internal corrections.
165 - Simplified the Lua–TikZ bridge layer.
166
167 ## [2026/02/17 — version 5.00c]
168
169 ### Docs
170 - Major Documentation Restructuring
171 - Global Reorganization
172 The documentation is now structured into **four coherent parts**:
173
174 1. **Geometry Core**
175 2. **Algebra and Tools**
176 3. **Lua and Integration**
177 4. **Mathematical and Computational Foundations**
178
179 This restructuring improves conceptual clarity and clearly separates
180 geometric theory from implementation details.
181
182 - New Sections
183 - Added subsection **"Special Characters and Catcodes"**
184 - Added new section:
185 - **Computational Model and Geometric Engine**
186
187 ### Added
188 - **line**
189 - Added method `where_on_line`.
190 - New Classes
191 - Added class `fct` (function)
192 - Added class `pfct` (parametric function)
193 - Standard tables introduced:
194 - `F` → functions
195 - `PF` → parametric functions
196 - Added class `list_point`
197
198 ### Changed
199 - Unified Geometric Position Model
200 - A major harmonization of geometric relation methods has been introduced.
201 - Standardized Return Values
202
203 All geometric position methods now consistently return:
204 - `"ON"`, `"IN"`, `"OUT"`
205 - or relation-specific classifications (e.g. `"TANGENT"`,
206 `"DISJOINT"`, etc.)
207 Boolean wrappers remain available for backward compatibility.
208
209 - **line** New & Updated Methods
210 - `line:position(pt)`\ → Returns `"ON"` or `"OUT"`.
211 - `line:in_out(pt)`\ → Boolean wrapper of `position`.
212 - `line:path(n)`\ → Parameter `n` is now documented.
213
214 - **circle**
215 - `circle:position(obj)` now accepts **generic objects**:
216 - Relation names are now consistently uppercase:
217 - `point` `IN`, `ON`, `OUT`
218 - `line` `DISJOINT`, `TANGENT`, `INTERSECT`
219 - `circle` Extended circle--circle classification
220
221 - **Triangle**
222 - `on_triangle`
223 - New Attributes
224 - `alpha_` , `beta_`, `gamma_`, `orientation`, `cross`
225
226 - **angle** Major development and stabilization.
227 - `value` and `deg` are now **attributes**\ (no longer methods).
228
229 - **Path System**
230 - `path:count()` is now documented.
231 - `tkzSetCountFromPath` is now documented.
232 - Improved integration between `list_point` and `path`.
233
234 ### New Macros (Graph Support)
235
236 - For `fct` and `pfct`:
237
238 - `\tkzDrawPointOnGraph`
239 - `\tkzDrawPointsOnGraph`
240 - `\tkzDrawPointOnParamGraph`
241 - `\tkzDrawPointsOnParamGraph`
242
243 ------------------------------------------------------------------------
244
245 ## [2026/01/25 — version 4.50c]
246 ### Added
247 - **angle**
248 - New class `angle` (experimental):
249 provides a dedicated object for oriented and non-oriented angles.
250 This class is experimental and not yet fully integrated into all
251 parts of the package.
252 - **list_point**
253 - New class `list_point` (experimental):
254 container class for ordered collections of points.
255 This class is experimental and not yet fully integrated into the
256 whole tkz-elements ecosystem.
257 - **quadrilateral**
258 - Added is_convex and corrected area computation in quadrilateral.
259 - **conic**
260 - Added method conic:get(i).
261 - **point**
262 - Added new midpoint helper functions in point:
263 - midpoints_chain_(...)
264 - midpoints_cycle_(...)
265 - **matrix**
266 - Added matrix:gauss_jordan and matrix:rank (documentation pending).
267
268 ### Removed
269 - Removed alternative and ambiguous definitions:
270 - circle:radius(center, radius)
271 - Deprecated circle constructors in favor of explicit factories:
272 - from_radius
273 - from_diameter
274 - Removed obsolete triangle area computation based on circular formulas.
275
276 ### Fixed
277 - Fixed a bug in `conic:common_tangent` (`E2 = CO.E2`).
278 - Fixed incorrect area formula in `circle:area`
279 (previously `0.5 * tkz.tau * radius^2`).
280 - Fixed several bugs in the `circle`, `line`, and `point` classes.
281 - Fixed a bug in `regular_polygon:side`.
282 - Fixed `get_points` for ellipses (method no longer applicable).
283 - Fixed `line_position_(c, r, a, b, EPS)` behavior.
284 - Fixed issues related to orthogonal constructions in `tkz` (orthopole).
285 - Improved tkz.parabola.
286 ### Changed
287 - Replaced `matrix:identity` by `matrix.identity`.
288 - Rewritten `triangle:get_angle`.
289 - Changed `orthogonal_circle_through_` implementation.
290 - Renamed projection-based constructions:
291 - `proj` → `apothem_foot` in `regular_polygon` and `square`.
292 - Defined `apothem` as an alias for `inradius`.
293 - Changed `square:side` into `square.from_side`.
294 - Changed `square:rotation` into `square.by_rotation`.
295 - Updated square construction from a line
296 - `iscyclic` now is `is_cyclic` in quadrilateral.
297
298 ### Todo
299 - Clarify and extend common tangent computations for conics.
300
301 ## [2026/01/22 — version 4.45c]
302
303 ### Changed
304 - **tkz-elements.sty**
305 - Replaced `luatexluaescapestring` with `luaescapestring`.
306
307 - **line**
308 - Simplification of the method `LLL`
309
310 ### Documentation
311 - Corrected the example related to the radical center.
312 - Improved the documentation of the `radical center` and the `radical circle`.
313 - Added clarifications concerning the `mini` option of `tkz-euclide`, in particular its interaction with
314 the `\tkzCompass` macro and the `show` option.
315 - Removed several sections (`examples`, `theorems`, and `apollonius`) in order to streamline the documentation.
316 These materials are now gathered in a separate document entitled *Euclidean Geometry*, available on
317 my website: `https://altermundus.fr`.
318 - Correction of Archimedes Spiral example.
319
320 ## [2025/12/09 — version 4.44c]
321
322 ### Added
323 - **triangle**
324 - New methods: `feuerbach_apollonius_k181` and `feuerbach_apollonius`.
325 - Kimberling point **#181** added (Apollonius point associated with the Feuerbach configuration).
326
327 - **circle**
328 - Addition of several special-case handlers inside the `CCC` method.
329
330 - **vector**
331 - Two new attributes: `dx` and `dy`.
332 - New methods: `is_zero`, `is_parallel`, `is_orthogonal`, `dot`, `cross`,
333 `angle_to`, `rotate`, `orthogonal`, and `get`.
334
335 - **tkz**
336 - New constants:
337 - `tkz.maxdimen_pt = 16383.99999`
338 - `tkz.max_coord_cm = tkz.maxdimen_pt * tkz.pt` (≈ 575.8 cm)
339 - `tkz.max_coord_safe = 0.9 * tkz.max_coord_cm` (≈ 518 cm)
340
341 ### Changed
342 - **tkz-elements.sty**
343 - Improved handling of `\tkzGetNodes`: only names of points ending in *p* or *pp* are transformed; all others are preserved.
344 The macro now calls the Lua function `tkz.GetNodes`.
345 - Update of the `vector` class implementation.
346 - Update of `tkz.GetNodes`: coordinate checking has been added; when a coordinate exceeds the safe limit (≈ 518 cm), the
347 corresponding node is placed at `(0,0)` and a warning is written to the `.log` file.
348
349 ### Docs
350 - Restoration of the *Overview* and *Contents* sections.
351 - Additions and refinements in the documentation of the `vector` class.
352 - Correction of the example on **Soddy circles**.
353
354
355 ## [2025/11/24 version 4.42c]
356
357 ### Added
358 - **angle**
359 - New class `angle` (not yet connected to the others).
360 The identifier `"A"` is used internally to store objects of type `angle`.
361
362 - **circle**
363 - Addition of `CCL`.
364 - New method `similitude` with optional argument `"internal"` or `"external"`.
365
366 - **tkz**
367 - New angle-related functions, all accepting an optional EPS argument to adjust precision:
368 `tkz.inner_angle`, `tkz.angle_between_vectors`, `tkz.get_angle_normalize`.
369 - New comparison helper: `tkz.approx` (optional EPS argument).
370
371 - **line**
372 - Aliases `perpendicular_bisector` and `bisector` added for `mediator`.
373 - New method `harmonic` with optional argument `"internal"`, `"external"`, or `"both"`.
374
375 - **triangle**
376 - `isodynamic_points` (alias `neuberg_points`).
377 - `three_apollonius_circles`.
378 - `apollonius_circle`.
379 - `apollonius_points`.
380 - `apollonius_circles`.
381
382 ### Changed
383 - **matrix**
384 - Corrections to `print_matrix` and `matrix:print`.
385 - Correction of method `htm`.
386
387 - **intersection**
388 - Rewriting of algorithms with introduction of an EPS parameter to adjust precision.
389
390 - **circle**
391 - The following functions now accept an optional EPS parameter:
392 `on_circle`, `in_out`, `in_disk`, `in_out_disk`,
393 `in_disk_strict`, `out_disk_strict`, `in_out_disk_strict`,
394 `line_position`, `pole`, `is_tangent`, `is_secant`, `circles_position`,
395 `orthogonal_through`, `midcircle`, `common_tangent`.
396 - Improved `CLL` for the case of parallel lines.
397
398 - **line**
399 - Improved `LLL`.
400
401 ### Docs
402 - Added Gothic example for CLP.
403 - Added example with parallel lines for CLL.
404 - Rewriting of `search_circle.lua`.
405 - Apollonius section: new CLP examples.
406 - Lua lesson: using `string.char(37)`.
407
408 ## [2025/11/13 version 4.40c]
409
410 ### Added
411 - **points**:
412 - `length(p)`: `z.A:length(z.B)` equiv. `tkz.length(z.A, z.B)`
413 -**line**:
414 - improvement of `orthogonal_at` and `collinear_at`
415 - **circle**:
416 - `from_radius` equiv. `through` and `from_diameter` equiv. `diameter`
417 - modification of `common_tangent`
418 - **triangle**:
419 - `trilinear_to_d`
420 - **tkz**:
421 - `tkz.range`, `tkz.deg`, `tkz.rad` and `tkz.pt`
422 - `tkz.is_NaN`, `tkz.is_Inf`, `tkz.notDef`
423 - `tkz.fsolve(f, a, b, n [, opts])`
424 - `tkz.derivative(f, x0 [, accuracy])`
425 - **conic**
426 - adding `common_tangent`
427 ### Changed
428 - **conic**:
429 - modification of `path` for an ellipse: new options with "swap" and "ccw" or "cw"
430 ### Docs
431 - `\tkzDrawCoordinates[smooth]` instead of `\tkzDrawCoordinatessmooth` in class "conic"
432 - adding examples for CCL
433
434 ## [2025/11/08 version 4.35c]
435
436 ### Added
437
438 - **point**:
439 - `shift_collinear_to(B, dist)`,
440 `PPP` (circle through three points)
441 - **line**:
442 - `collinear_at_distance(d)`
443 - `LLL` (circle tangent to three lines)
444 - **circle**:
445 - `line_position(L)`,
446 - `lines_position(L1, L2, mode)`,
447 - `is_tangent(L)`, `is_secant(L)`, `is_disjoint(L)`
448 - `inversion_neg` (inversion then symmetry)
449 - `tangent_parallel`
450 - `CLL` or `c_c_ll`
451 - add mode in common_tangent by default internal external or both
452 - `are_circles_tangents(C)`
453 - `CCL` and `CCC` and `CCC_gergonne`
454 - **path**
455 - `get(i)` to extract point of path
456 - **triangle**
457 - modification class triangle: confused test points, collinearity test
458 - remove function triangle:c_ll_p
459 - **tkz**
460 - `tkz.approx(x, y)` comparison of two real numbers
461 - `tkz.nodes_from_paths`
462
463 ### Changed
464 - All methods relating to contact problems have been improved and supplemented in order to deal with specific cases.
465 - I added the following nomenclature for contact issues: `PPP`(new), `LLL`(new), `LPP`, `LLP`, `CPP`, `CCP`, `CLP`, `CLL`(new), `CCL`(new) and `CCC`(new).
466 - `c_lc_p` has two aliases 'c_cl_p' and `CLP`
467 - `c_cc_p` has an alias `CCP`
468 - colinear is now collinear !
469 - tkz-elements-demo_5.lua has been adapted
470 - midcircle (amelioration): midcircle between two circles or between a circle and a line.
471 ### Docs
472 - typo: correction collinear instead of colinear
473 - Added descriptions and examples of new methods, plus a few corrections.
474
475
476 ## [2025/10/04 version 4.30c]
477 ### Added
478 - **circle**:
479 - `in_disk` same as `in_out_disk`
480 - `on_circle` same as `in_out`
481 - `in_disk_strict`
482 - `out_disk_strict`
483 - **line**
484 - `side_line` This method assigns a value of -1, 0, or 1 to a given point depending on its position in the plane relative to the line.
485 - `on_line` = `in_out_line`
486 - `in_out_segment` = `on_segment`
487 ### Changed
488 - **circle**
489 - `common_tangent` Complete rewriting of the procedure, which now takes into account the position of circles and, above all, adds an option to choose between external tangents and internal tangents when they exist.
490 - `c_cc_p` Complete rewriting of the procedure. You can use an "external" or "internal" option to determine whether solution circles exist. The method takes into account the relative position of the circles.
491 - **line**
492 - `c_ll_p(L, p)` now has a line and a point as its argument.
493
494 ### Docs
495 - Correction of typography.
496 - Adjusting documentation for new methods.
497 - Rewriting of numerous method presentations.
498
499 ## [2025/09/24 version 4.25c]
500 ### Added
501 - **path**:
502 - `get_point`
503 - `iter()`.
504 - **tkz-elements.sty**:
505 - `\tkzGetPointFromPath(#1,#2){#3}`
506 - `\tkzPathCount(#1){#2}`
507 - `\tkzDrawFromPointToPath`.
508 - **tkz**: Function `tkz.parabola(a, b, c)` to obtain the quadratic form whose graph passes through the three points `a`, `b`, and `c` (under certain conditions).
509
510 ### Changed
511 - **Source structure**: Removed version numbers and dates from each `tkz_elements_xxx.lua` file.
512 The official version and release date are now maintained **only** in:
513 - `tkz-elements.sty` (for LaTeX users),
514 - `README.md`,
515 - `CHANGELOG.md`,
516 - `doc/tkz-elements.pdf`.
517 - **occs**: The `coordinates` method now returns numbers instead of strings (removed `checknumber_`).
518 - **path**: Improved `get_number_path` method.
519
520
521 ### Docs
522 - Renamed several examples: the old names were more explicit.
523 - After **Overview**, added three navigation tables (attributes, methods, metamethods) for each class. All elements should now be listed, with links to their definitions and, where relevant, to examples.
524 - Rewrote the section on **path**.
525 - Added in **Theorems**: Circle–Point Midpoint Theorem.
526 - Added documentation for the new macros of **tkz-elements.sty**.
527 - Added in **Examples**: Construction of the midcircle of two disjoint circles.
528
529
530 ## [4.21c] — 2025-09-21
531 ### Docs
532 - Changed the names of the examples.
533 - The examples now use external Lua files.
534 - Corrected the documentation.
535 - Cleaned up the files: unused labels have been removed, as well as **overfull box**.
536
537 ## [4.20c] — 2025-09-17
538 ### Added
539 - **triangle**: `thebault/c_c` (Thébault’s problem III), `poncelet_point`, `orthopole(L)`,
540 `mixtilinear_incircle`, `three_tangent_circles`, `morley`, `soddy`, `napoleon`.
541 - **quadrilateral**: support for orthopole via helper function `tkz.orthopole(a, b, c, l)`.
542
543 ### Changed
544 - **circle**: improved `common_tangent`, `orthogonal_through`, `orthogonal_from`, `c_cc_p`.
545 - **line**: improved `distance`.
546 - **triangle**: rewrites of `symmedian_line`, `altitude`, `bisector`, `bisector_ext`,
547 `mediator`, `ex_circle`, `reflection`.
548
549 ### Fixed
550 - **circle**: `common_tangent` correctness issues.
551
552 ### Docs
553 - New subsection **Best practices** in **Writing Convention, best practices and common mistakes**.
554 - New examples for `thebault/c_c` in **class triangle** and **theorems** (Thébault’s problem III).
555 - New examples for `poncelet_point` (triangle and quadrilateral).
556 - Examples for **orthopole** (triangle + examples section).
557 - Various corrections.
558
559 ## [4.15c] — 2025‑06‑15
560 ### Added
561 - `tkz.trisector` to divide a sector into three equal parts (returns two points).
562 - Triangle method: `mediator` (perpendicular bisector of the side opposite the chosen vertex).
563 - Utility: `tkz.is_direct` to test whether ∠ABC is oriented positively.
564
565 ### Changed
566 - Triangle methods now accept the vertex **itself** in place of a permutation index (e.g. `bisector`, `altitude`, `ex-circle`), improving clarity and consistency.
567 - Renamed `tkz_dc` → `tkz.dc`; removed remaining occurrences of the old name.
568
569 ### Docs
570 - Updated manual; new example added (**Morley triangle**).
571
572 ## [4.10c]
573 ### Added
574 - Modules `utils` and `tkz` (formatting, rounding, comparisons, table ops; helpers like `tkz.solve`, `tkz.midpoint`, `tkz.length`, angle tools, barycenter, etc.).
575 - `path` class interop with conics and triangles; TikZ macros `\tkzDrawPointsFromPath`, `\tkzGetPointsFromPath`, `\tkzDrawCirclesFromPaths`, `\tkzDrawSegmentsFromPaths`.
576 - Triangle: `poncelet_point`, `orthopole`.
577 - Macro aliasing: `\tkzPN` = `\tkzPrintNumber`, `\tkzDrawPath` = `\tkzDrawCoordinates`.
578 - `\tkzEraseLuaObj` to delete a Lua object.
579
580 ### Changed
581 - Circle method `orthogonal_through` rewritten and corrected.
582
583 ### Docs
584 - New examples: Archimedean spiral, Poncelet point, Orthopole, Path examples.
585
586 ## [4.00c]
587 ### Added
588 - New `path` class; short syntax for constructors (omit `.new`).
589 - Metapost “mini” macro; options `known` and `near` for intersections; trilinear/barycentric rewrites; line methods `orthogonal_at(pt,k)` and `collinear_at(pt,k)`.
590
591 ### Changed
592 - Removed scaling within the Lua section (prefer TikZ‑level scaling).
593 - Various fixes: triangle `point` method; rectangle `get_lengths`; Gauss pivot improvements.
594
595 ### Docs
596 - Major rewrite; new sections (**Short contents, Getting started, Class path, LuaLaTeX for beginners, Global variables and constants, Various functions, Module utils, Metapost**).