/[dtapublic]/to_be_filed/sf_code/esrgpcpj/shared/c_datd/gmp_ralg.c
ViewVC logotype

Contents of /to_be_filed/sf_code/esrgpcpj/shared/c_datd/gmp_ralg.c

Parent Directory Parent Directory | Revision Log Revision Log


Revision 29 - (show annotations) (download)
Sat Oct 8 07:08:47 2016 UTC (7 years, 5 months ago) by dashley
File MIME type: text/plain
File size: 132737 byte(s)
Directories relocated.
1 // $Header: /cvsroot/esrg/sfesrg/esrgpcpj/shared/c_datd/gmp_ralg.c,v 1.10 2002/01/27 17:58:15 dtashley Exp $
2
3 //--------------------------------------------------------------------------------
4 //Copyright 2001 David T. Ashley
5 //-------------------------------------------------------------------------------------------------
6 //This source code and any program in which it is compiled/used is provided under the GNU GENERAL
7 //PUBLIC LICENSE, Version 3, full license text below.
8 //-------------------------------------------------------------------------------------------------
9 // GNU GENERAL PUBLIC LICENSE
10 // Version 3, 29 June 2007
11 //
12 // Copyright (C) 2007 Free Software Foundation, Inc. <http://fsf.org/>
13 // Everyone is permitted to copy and distribute verbatim copies
14 // of this license document, but changing it is not allowed.
15 //
16 // Preamble
17 //
18 // The GNU General Public License is a free, copyleft license for
19 //software and other kinds of works.
20 //
21 // The licenses for most software and other practical works are designed
22 //to take away your freedom to share and change the works. By contrast,
23 //the GNU General Public License is intended to guarantee your freedom to
24 //share and change all versions of a program--to make sure it remains free
25 //software for all its users. We, the Free Software Foundation, use the
26 //GNU General Public License for most of our software; it applies also to
27 //any other work released this way by its authors. You can apply it to
28 //your programs, too.
29 //
30 // When we speak of free software, we are referring to freedom, not
31 //price. Our General Public Licenses are designed to make sure that you
32 //have the freedom to distribute copies of free software (and charge for
33 //them if you wish), that you receive source code or can get it if you
34 //want it, that you can change the software or use pieces of it in new
35 //free programs, and that you know you can do these things.
36 //
37 // To protect your rights, we need to prevent others from denying you
38 //these rights or asking you to surrender the rights. Therefore, you have
39 //certain responsibilities if you distribute copies of the software, or if
40 //you modify it: responsibilities to respect the freedom of others.
41 //
42 // For example, if you distribute copies of such a program, whether
43 //gratis or for a fee, you must pass on to the recipients the same
44 //freedoms that you received. You must make sure that they, too, receive
45 //or can get the source code. And you must show them these terms so they
46 //know their rights.
47 //
48 // Developers that use the GNU GPL protect your rights with two steps:
49 //(1) assert copyright on the software, and (2) offer you this License
50 //giving you legal permission to copy, distribute and/or modify it.
51 //
52 // For the developers' and authors' protection, the GPL clearly explains
53 //that there is no warranty for this free software. For both users' and
54 //authors' sake, the GPL requires that modified versions be marked as
55 //changed, so that their problems will not be attributed erroneously to
56 //authors of previous versions.
57 //
58 // Some devices are designed to deny users access to install or run
59 //modified versions of the software inside them, although the manufacturer
60 //can do so. This is fundamentally incompatible with the aim of
61 //protecting users' freedom to change the software. The systematic
62 //pattern of such abuse occurs in the area of products for individuals to
63 //use, which is precisely where it is most unacceptable. Therefore, we
64 //have designed this version of the GPL to prohibit the practice for those
65 //products. If such problems arise substantially in other domains, we
66 //stand ready to extend this provision to those domains in future versions
67 //of the GPL, as needed to protect the freedom of users.
68 //
69 // Finally, every program is threatened constantly by software patents.
70 //States should not allow patents to restrict development and use of
71 //software on general-purpose computers, but in those that do, we wish to
72 //avoid the special danger that patents applied to a free program could
73 //make it effectively proprietary. To prevent this, the GPL assures that
74 //patents cannot be used to render the program non-free.
75 //
76 // The precise terms and conditions for copying, distribution and
77 //modification follow.
78 //
79 // TERMS AND CONDITIONS
80 //
81 // 0. Definitions.
82 //
83 // "This License" refers to version 3 of the GNU General Public License.
84 //
85 // "Copyright" also means copyright-like laws that apply to other kinds of
86 //works, such as semiconductor masks.
87 //
88 // "The Program" refers to any copyrightable work licensed under this
89 //License. Each licensee is addressed as "you". "Licensees" and
90 //"recipients" may be individuals or organizations.
91 //
92 // To "modify" a work means to copy from or adapt all or part of the work
93 //in a fashion requiring copyright permission, other than the making of an
94 //exact copy. The resulting work is called a "modified version" of the
95 //earlier work or a work "based on" the earlier work.
96 //
97 // A "covered work" means either the unmodified Program or a work based
98 //on the Program.
99 //
100 // To "propagate" a work means to do anything with it that, without
101 //permission, would make you directly or secondarily liable for
102 //infringement under applicable copyright law, except executing it on a
103 //computer or modifying a private copy. Propagation includes copying,
104 //distribution (with or without modification), making available to the
105 //public, and in some countries other activities as well.
106 //
107 // To "convey" a work means any kind of propagation that enables other
108 //parties to make or receive copies. Mere interaction with a user through
109 //a computer network, with no transfer of a copy, is not conveying.
110 //
111 // An interactive user interface displays "Appropriate Legal Notices"
112 //to the extent that it includes a convenient and prominently visible
113 //feature that (1) displays an appropriate copyright notice, and (2)
114 //tells the user that there is no warranty for the work (except to the
115 //extent that warranties are provided), that licensees may convey the
116 //work under this License, and how to view a copy of this License. If
117 //the interface presents a list of user commands or options, such as a
118 //menu, a prominent item in the list meets this criterion.
119 //
120 // 1. Source Code.
121 //
122 // The "source code" for a work means the preferred form of the work
123 //for making modifications to it. "Object code" means any non-source
124 //form of a work.
125 //
126 // A "Standard Interface" means an interface that either is an official
127 //standard defined by a recognized standards body, or, in the case of
128 //interfaces specified for a particular programming language, one that
129 //is widely used among developers working in that language.
130 //
131 // The "System Libraries" of an executable work include anything, other
132 //than the work as a whole, that (a) is included in the normal form of
133 //packaging a Major Component, but which is not part of that Major
134 //Component, and (b) serves only to enable use of the work with that
135 //Major Component, or to implement a Standard Interface for which an
136 //implementation is available to the public in source code form. A
137 //"Major Component", in this context, means a major essential component
138 //(kernel, window system, and so on) of the specific operating system
139 //(if any) on which the executable work runs, or a compiler used to
140 //produce the work, or an object code interpreter used to run it.
141 //
142 // The "Corresponding Source" for a work in object code form means all
143 //the source code needed to generate, install, and (for an executable
144 //work) run the object code and to modify the work, including scripts to
145 //control those activities. However, it does not include the work's
146 //System Libraries, or general-purpose tools or generally available free
147 //programs which are used unmodified in performing those activities but
148 //which are not part of the work. For example, Corresponding Source
149 //includes interface definition files associated with source files for
150 //the work, and the source code for shared libraries and dynamically
151 //linked subprograms that the work is specifically designed to require,
152 //such as by intimate data communication or control flow between those
153 //subprograms and other parts of the work.
154 //
155 // The Corresponding Source need not include anything that users
156 //can regenerate automatically from other parts of the Corresponding
157 //Source.
158 //
159 // The Corresponding Source for a work in source code form is that
160 //same work.
161 //
162 // 2. Basic Permissions.
163 //
164 // All rights granted under this License are granted for the term of
165 //copyright on the Program, and are irrevocable provided the stated
166 //conditions are met. This License explicitly affirms your unlimited
167 //permission to run the unmodified Program. The output from running a
168 //covered work is covered by this License only if the output, given its
169 //content, constitutes a covered work. This License acknowledges your
170 //rights of fair use or other equivalent, as provided by copyright law.
171 //
172 // You may make, run and propagate covered works that you do not
173 //convey, without conditions so long as your license otherwise remains
174 //in force. You may convey covered works to others for the sole purpose
175 //of having them make modifications exclusively for you, or provide you
176 //with facilities for running those works, provided that you comply with
177 //the terms of this License in conveying all material for which you do
178 //not control copyright. Those thus making or running the covered works
179 //for you must do so exclusively on your behalf, under your direction
180 //and control, on terms that prohibit them from making any copies of
181 //your copyrighted material outside their relationship with you.
182 //
183 // Conveying under any other circumstances is permitted solely under
184 //the conditions stated below. Sublicensing is not allowed; section 10
185 //makes it unnecessary.
186 //
187 // 3. Protecting Users' Legal Rights From Anti-Circumvention Law.
188 //
189 // No covered work shall be deemed part of an effective technological
190 //measure under any applicable law fulfilling obligations under article
191 //11 of the WIPO copyright treaty adopted on 20 December 1996, or
192 //similar laws prohibiting or restricting circumvention of such
193 //measures.
194 //
195 // When you convey a covered work, you waive any legal power to forbid
196 //circumvention of technological measures to the extent such circumvention
197 //is effected by exercising rights under this License with respect to
198 //the covered work, and you disclaim any intention to limit operation or
199 //modification of the work as a means of enforcing, against the work's
200 //users, your or third parties' legal rights to forbid circumvention of
201 //technological measures.
202 //
203 // 4. Conveying Verbatim Copies.
204 //
205 // You may convey verbatim copies of the Program's source code as you
206 //receive it, in any medium, provided that you conspicuously and
207 //appropriately publish on each copy an appropriate copyright notice;
208 //keep intact all notices stating that this License and any
209 //non-permissive terms added in accord with section 7 apply to the code;
210 //keep intact all notices of the absence of any warranty; and give all
211 //recipients a copy of this License along with the Program.
212 //
213 // You may charge any price or no price for each copy that you convey,
214 //and you may offer support or warranty protection for a fee.
215 //
216 // 5. Conveying Modified Source Versions.
217 //
218 // You may convey a work based on the Program, or the modifications to
219 //produce it from the Program, in the form of source code under the
220 //terms of section 4, provided that you also meet all of these conditions:
221 //
222 // a) The work must carry prominent notices stating that you modified
223 // it, and giving a relevant date.
224 //
225 // b) The work must carry prominent notices stating that it is
226 // released under this License and any conditions added under section
227 // 7. This requirement modifies the requirement in section 4 to
228 // "keep intact all notices".
229 //
230 // c) You must license the entire work, as a whole, under this
231 // License to anyone who comes into possession of a copy. This
232 // License will therefore apply, along with any applicable section 7
233 // additional terms, to the whole of the work, and all its parts,
234 // regardless of how they are packaged. This License gives no
235 // permission to license the work in any other way, but it does not
236 // invalidate such permission if you have separately received it.
237 //
238 // d) If the work has interactive user interfaces, each must display
239 // Appropriate Legal Notices; however, if the Program has interactive
240 // interfaces that do not display Appropriate Legal Notices, your
241 // work need not make them do so.
242 //
243 // A compilation of a covered work with other separate and independent
244 //works, which are not by their nature extensions of the covered work,
245 //and which are not combined with it such as to form a larger program,
246 //in or on a volume of a storage or distribution medium, is called an
247 //"aggregate" if the compilation and its resulting copyright are not
248 //used to limit the access or legal rights of the compilation's users
249 //beyond what the individual works permit. Inclusion of a covered work
250 //in an aggregate does not cause this License to apply to the other
251 //parts of the aggregate.
252 //
253 // 6. Conveying Non-Source Forms.
254 //
255 // You may convey a covered work in object code form under the terms
256 //of sections 4 and 5, provided that you also convey the
257 //machine-readable Corresponding Source under the terms of this License,
258 //in one of these ways:
259 //
260 // a) Convey the object code in, or embodied in, a physical product
261 // (including a physical distribution medium), accompanied by the
262 // Corresponding Source fixed on a durable physical medium
263 // customarily used for software interchange.
264 //
265 // b) Convey the object code in, or embodied in, a physical product
266 // (including a physical distribution medium), accompanied by a
267 // written offer, valid for at least three years and valid for as
268 // long as you offer spare parts or customer support for that product
269 // model, to give anyone who possesses the object code either (1) a
270 // copy of the Corresponding Source for all the software in the
271 // product that is covered by this License, on a durable physical
272 // medium customarily used for software interchange, for a price no
273 // more than your reasonable cost of physically performing this
274 // conveying of source, or (2) access to copy the
275 // Corresponding Source from a network server at no charge.
276 //
277 // c) Convey individual copies of the object code with a copy of the
278 // written offer to provide the Corresponding Source. This
279 // alternative is allowed only occasionally and noncommercially, and
280 // only if you received the object code with such an offer, in accord
281 // with subsection 6b.
282 //
283 // d) Convey the object code by offering access from a designated
284 // place (gratis or for a charge), and offer equivalent access to the
285 // Corresponding Source in the same way through the same place at no
286 // further charge. You need not require recipients to copy the
287 // Corresponding Source along with the object code. If the place to
288 // copy the object code is a network server, the Corresponding Source
289 // may be on a different server (operated by you or a third party)
290 // that supports equivalent copying facilities, provided you maintain
291 // clear directions next to the object code saying where to find the
292 // Corresponding Source. Regardless of what server hosts the
293 // Corresponding Source, you remain obligated to ensure that it is
294 // available for as long as needed to satisfy these requirements.
295 //
296 // e) Convey the object code using peer-to-peer transmission, provided
297 // you inform other peers where the object code and Corresponding
298 // Source of the work are being offered to the general public at no
299 // charge under subsection 6d.
300 //
301 // A separable portion of the object code, whose source code is excluded
302 //from the Corresponding Source as a System Library, need not be
303 //included in conveying the object code work.
304 //
305 // A "User Product" is either (1) a "consumer product", which means any
306 //tangible personal property which is normally used for personal, family,
307 //or household purposes, or (2) anything designed or sold for incorporation
308 //into a dwelling. In determining whether a product is a consumer product,
309 //doubtful cases shall be resolved in favor of coverage. For a particular
310 //product received by a particular user, "normally used" refers to a
311 //typical or common use of that class of product, regardless of the status
312 //of the particular user or of the way in which the particular user
313 //actually uses, or expects or is expected to use, the product. A product
314 //is a consumer product regardless of whether the product has substantial
315 //commercial, industrial or non-consumer uses, unless such uses represent
316 //the only significant mode of use of the product.
317 //
318 // "Installation Information" for a User Product means any methods,
319 //procedures, authorization keys, or other information required to install
320 //and execute modified versions of a covered work in that User Product from
321 //a modified version of its Corresponding Source. The information must
322 //suffice to ensure that the continued functioning of the modified object
323 //code is in no case prevented or interfered with solely because
324 //modification has been made.
325 //
326 // If you convey an object code work under this section in, or with, or
327 //specifically for use in, a User Product, and the conveying occurs as
328 //part of a transaction in which the right of possession and use of the
329 //User Product is transferred to the recipient in perpetuity or for a
330 //fixed term (regardless of how the transaction is characterized), the
331 //Corresponding Source conveyed under this section must be accompanied
332 //by the Installation Information. But this requirement does not apply
333 //if neither you nor any third party retains the ability to install
334 //modified object code on the User Product (for example, the work has
335 //been installed in ROM).
336 //
337 // The requirement to provide Installation Information does not include a
338 //requirement to continue to provide support service, warranty, or updates
339 //for a work that has been modified or installed by the recipient, or for
340 //the User Product in which it has been modified or installed. Access to a
341 //network may be denied when the modification itself materially and
342 //adversely affects the operation of the network or violates the rules and
343 //protocols for communication across the network.
344 //
345 // Corresponding Source conveyed, and Installation Information provided,
346 //in accord with this section must be in a format that is publicly
347 //documented (and with an implementation available to the public in
348 //source code form), and must require no special password or key for
349 //unpacking, reading or copying.
350 //
351 // 7. Additional Terms.
352 //
353 // "Additional permissions" are terms that supplement the terms of this
354 //License by making exceptions from one or more of its conditions.
355 //Additional permissions that are applicable to the entire Program shall
356 //be treated as though they were included in this License, to the extent
357 //that they are valid under applicable law. If additional permissions
358 //apply only to part of the Program, that part may be used separately
359 //under those permissions, but the entire Program remains governed by
360 //this License without regard to the additional permissions.
361 //
362 // When you convey a copy of a covered work, you may at your option
363 //remove any additional permissions from that copy, or from any part of
364 //it. (Additional permissions may be written to require their own
365 //removal in certain cases when you modify the work.) You may place
366 //additional permissions on material, added by you to a covered work,
367 //for which you have or can give appropriate copyright permission.
368 //
369 // Notwithstanding any other provision of this License, for material you
370 //add to a covered work, you may (if authorized by the copyright holders of
371 //that material) supplement the terms of this License with terms:
372 //
373 // a) Disclaiming warranty or limiting liability differently from the
374 // terms of sections 15 and 16 of this License; or
375 //
376 // b) Requiring preservation of specified reasonable legal notices or
377 // author attributions in that material or in the Appropriate Legal
378 // Notices displayed by works containing it; or
379 //
380 // c) Prohibiting misrepresentation of the origin of that material, or
381 // requiring that modified versions of such material be marked in
382 // reasonable ways as different from the original version; or
383 //
384 // d) Limiting the use for publicity purposes of names of licensors or
385 // authors of the material; or
386 //
387 // e) Declining to grant rights under trademark law for use of some
388 // trade names, trademarks, or service marks; or
389 //
390 // f) Requiring indemnification of licensors and authors of that
391 // material by anyone who conveys the material (or modified versions of
392 // it) with contractual assumptions of liability to the recipient, for
393 // any liability that these contractual assumptions directly impose on
394 // those licensors and authors.
395 //
396 // All other non-permissive additional terms are considered "further
397 //restrictions" within the meaning of section 10. If the Program as you
398 //received it, or any part of it, contains a notice stating that it is
399 //governed by this License along with a term that is a further
400 //restriction, you may remove that term. If a license document contains
401 //a further restriction but permits relicensing or conveying under this
402 //License, you may add to a covered work material governed by the terms
403 //of that license document, provided that the further restriction does
404 //not survive such relicensing or conveying.
405 //
406 // If you add terms to a covered work in accord with this section, you
407 //must place, in the relevant source files, a statement of the
408 //additional terms that apply to those files, or a notice indicating
409 //where to find the applicable terms.
410 //
411 // Additional terms, permissive or non-permissive, may be stated in the
412 //form of a separately written license, or stated as exceptions;
413 //the above requirements apply either way.
414 //
415 // 8. Termination.
416 //
417 // You may not propagate or modify a covered work except as expressly
418 //provided under this License. Any attempt otherwise to propagate or
419 //modify it is void, and will automatically terminate your rights under
420 //this License (including any patent licenses granted under the third
421 //paragraph of section 11).
422 //
423 // However, if you cease all violation of this License, then your
424 //license from a particular copyright holder is reinstated (a)
425 //provisionally, unless and until the copyright holder explicitly and
426 //finally terminates your license, and (b) permanently, if the copyright
427 //holder fails to notify you of the violation by some reasonable means
428 //prior to 60 days after the cessation.
429 //
430 // Moreover, your license from a particular copyright holder is
431 //reinstated permanently if the copyright holder notifies you of the
432 //violation by some reasonable means, this is the first time you have
433 //received notice of violation of this License (for any work) from that
434 //copyright holder, and you cure the violation prior to 30 days after
435 //your receipt of the notice.
436 //
437 // Termination of your rights under this section does not terminate the
438 //licenses of parties who have received copies or rights from you under
439 //this License. If your rights have been terminated and not permanently
440 //reinstated, you do not qualify to receive new licenses for the same
441 //material under section 10.
442 //
443 // 9. Acceptance Not Required for Having Copies.
444 //
445 // You are not required to accept this License in order to receive or
446 //run a copy of the Program. Ancillary propagation of a covered work
447 //occurring solely as a consequence of using peer-to-peer transmission
448 //to receive a copy likewise does not require acceptance. However,
449 //nothing other than this License grants you permission to propagate or
450 //modify any covered work. These actions infringe copyright if you do
451 //not accept this License. Therefore, by modifying or propagating a
452 //covered work, you indicate your acceptance of this License to do so.
453 //
454 // 10. Automatic Licensing of Downstream Recipients.
455 //
456 // Each time you convey a covered work, the recipient automatically
457 //receives a license from the original licensors, to run, modify and
458 //propagate that work, subject to this License. You are not responsible
459 //for enforcing compliance by third parties with this License.
460 //
461 // An "entity transaction" is a transaction transferring control of an
462 //organization, or substantially all assets of one, or subdividing an
463 //organization, or merging organizations. If propagation of a covered
464 //work results from an entity transaction, each party to that
465 //transaction who receives a copy of the work also receives whatever
466 //licenses to the work the party's predecessor in interest had or could
467 //give under the previous paragraph, plus a right to possession of the
468 //Corresponding Source of the work from the predecessor in interest, if
469 //the predecessor has it or can get it with reasonable efforts.
470 //
471 // You may not impose any further restrictions on the exercise of the
472 //rights granted or affirmed under this License. For example, you may
473 //not impose a license fee, royalty, or other charge for exercise of
474 //rights granted under this License, and you may not initiate litigation
475 //(including a cross-claim or counterclaim in a lawsuit) alleging that
476 //any patent claim is infringed by making, using, selling, offering for
477 //sale, or importing the Program or any portion of it.
478 //
479 // 11. Patents.
480 //
481 // A "contributor" is a copyright holder who authorizes use under this
482 //License of the Program or a work on which the Program is based. The
483 //work thus licensed is called the contributor's "contributor version".
484 //
485 // A contributor's "essential patent claims" are all patent claims
486 //owned or controlled by the contributor, whether already acquired or
487 //hereafter acquired, that would be infringed by some manner, permitted
488 //by this License, of making, using, or selling its contributor version,
489 //but do not include claims that would be infringed only as a
490 //consequence of further modification of the contributor version. For
491 //purposes of this definition, "control" includes the right to grant
492 //patent sublicenses in a manner consistent with the requirements of
493 //this License.
494 //
495 // Each contributor grants you a non-exclusive, worldwide, royalty-free
496 //patent license under the contributor's essential patent claims, to
497 //make, use, sell, offer for sale, import and otherwise run, modify and
498 //propagate the contents of its contributor version.
499 //
500 // In the following three paragraphs, a "patent license" is any express
501 //agreement or commitment, however denominated, not to enforce a patent
502 //(such as an express permission to practice a patent or covenant not to
503 //sue for patent infringement). To "grant" such a patent license to a
504 //party means to make such an agreement or commitment not to enforce a
505 //patent against the party.
506 //
507 // If you convey a covered work, knowingly relying on a patent license,
508 //and the Corresponding Source of the work is not available for anyone
509 //to copy, free of charge and under the terms of this License, through a
510 //publicly available network server or other readily accessible means,
511 //then you must either (1) cause the Corresponding Source to be so
512 //available, or (2) arrange to deprive yourself of the benefit of the
513 //patent license for this particular work, or (3) arrange, in a manner
514 //consistent with the requirements of this License, to extend the patent
515 //license to downstream recipients. "Knowingly relying" means you have
516 //actual knowledge that, but for the patent license, your conveying the
517 //covered work in a country, or your recipient's use of the covered work
518 //in a country, would infringe one or more identifiable patents in that
519 //country that you have reason to believe are valid.
520 //
521 // If, pursuant to or in connection with a single transaction or
522 //arrangement, you convey, or propagate by procuring conveyance of, a
523 //covered work, and grant a patent license to some of the parties
524 //receiving the covered work authorizing them to use, propagate, modify
525 //or convey a specific copy of the covered work, then the patent license
526 //you grant is automatically extended to all recipients of the covered
527 //work and works based on it.
528 //
529 // A patent license is "discriminatory" if it does not include within
530 //the scope of its coverage, prohibits the exercise of, or is
531 //conditioned on the non-exercise of one or more of the rights that are
532 //specifically granted under this License. You may not convey a covered
533 //work if you are a party to an arrangement with a third party that is
534 //in the business of distributing software, under which you make payment
535 //to the third party based on the extent of your activity of conveying
536 //the work, and under which the third party grants, to any of the
537 //parties who would receive the covered work from you, a discriminatory
538 //patent license (a) in connection with copies of the covered work
539 //conveyed by you (or copies made from those copies), or (b) primarily
540 //for and in connection with specific products or compilations that
541 //contain the covered work, unless you entered into that arrangement,
542 //or that patent license was granted, prior to 28 March 2007.
543 //
544 // Nothing in this License shall be construed as excluding or limiting
545 //any implied license or other defenses to infringement that may
546 //otherwise be available to you under applicable patent law.
547 //
548 // 12. No Surrender of Others' Freedom.
549 //
550 // If conditions are imposed on you (whether by court order, agreement or
551 //otherwise) that contradict the conditions of this License, they do not
552 //excuse you from the conditions of this License. If you cannot convey a
553 //covered work so as to satisfy simultaneously your obligations under this
554 //License and any other pertinent obligations, then as a consequence you may
555 //not convey it at all. For example, if you agree to terms that obligate you
556 //to collect a royalty for further conveying from those to whom you convey
557 //the Program, the only way you could satisfy both those terms and this
558 //License would be to refrain entirely from conveying the Program.
559 //
560 // 13. Use with the GNU Affero General Public License.
561 //
562 // Notwithstanding any other provision of this License, you have
563 //permission to link or combine any covered work with a work licensed
564 //under version 3 of the GNU Affero General Public License into a single
565 //combined work, and to convey the resulting work. The terms of this
566 //License will continue to apply to the part which is the covered work,
567 //but the special requirements of the GNU Affero General Public License,
568 //section 13, concerning interaction through a network will apply to the
569 //combination as such.
570 //
571 // 14. Revised Versions of this License.
572 //
573 // The Free Software Foundation may publish revised and/or new versions of
574 //the GNU General Public License from time to time. Such new versions will
575 //be similar in spirit to the present version, but may differ in detail to
576 //address new problems or concerns.
577 //
578 // Each version is given a distinguishing version number. If the
579 //Program specifies that a certain numbered version of the GNU General
580 //Public License "or any later version" applies to it, you have the
581 //option of following the terms and conditions either of that numbered
582 //version or of any later version published by the Free Software
583 //Foundation. If the Program does not specify a version number of the
584 //GNU General Public License, you may choose any version ever published
585 //by the Free Software Foundation.
586 //
587 // If the Program specifies that a proxy can decide which future
588 //versions of the GNU General Public License can be used, that proxy's
589 //public statement of acceptance of a version permanently authorizes you
590 //to choose that version for the Program.
591 //
592 // Later license versions may give you additional or different
593 //permissions. However, no additional obligations are imposed on any
594 //author or copyright holder as a result of your choosing to follow a
595 //later version.
596 //
597 // 15. Disclaimer of Warranty.
598 //
599 // THERE IS NO WARRANTY FOR THE PROGRAM, TO THE EXTENT PERMITTED BY
600 //APPLICABLE LAW. EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT
601 //HOLDERS AND/OR OTHER PARTIES PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY
602 //OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO,
603 //THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
604 //PURPOSE. THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE PROGRAM
605 //IS WITH YOU. SHOULD THE PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF
606 //ALL NECESSARY SERVICING, REPAIR OR CORRECTION.
607 //
608 // 16. Limitation of Liability.
609 //
610 // IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING
611 //WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MODIFIES AND/OR CONVEYS
612 //THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES, INCLUDING ANY
613 //GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE
614 //USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED TO LOSS OF
615 //DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD
616 //PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER PROGRAMS),
617 //EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF
618 //SUCH DAMAGES.
619 //
620 // 17. Interpretation of Sections 15 and 16.
621 //
622 // If the disclaimer of warranty and limitation of liability provided
623 //above cannot be given local legal effect according to their terms,
624 //reviewing courts shall apply local law that most closely approximates
625 //an absolute waiver of all civil liability in connection with the
626 //Program, unless a warranty or assumption of liability accompanies a
627 //copy of the Program in return for a fee.
628 //
629 // END OF TERMS AND CONDITIONS
630 //
631 // How to Apply These Terms to Your New Programs
632 //
633 // If you develop a new program, and you want it to be of the greatest
634 //possible use to the public, the best way to achieve this is to make it
635 //free software which everyone can redistribute and change under these terms.
636 //
637 // To do so, attach the following notices to the program. It is safest
638 //to attach them to the start of each source file to most effectively
639 //state the exclusion of warranty; and each file should have at least
640 //the "copyright" line and a pointer to where the full notice is found.
641 //
642 // <one line to give the program's name and a brief idea of what it does.>
643 // Copyright (C) <year> <name of author>
644 //
645 // This program is free software: you can redistribute it and/or modify
646 // it under the terms of the GNU General Public License as published by
647 // the Free Software Foundation, either version 3 of the License, or
648 // (at your option) any later version.
649 //
650 // This program is distributed in the hope that it will be useful,
651 // but WITHOUT ANY WARRANTY; without even the implied warranty of
652 // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
653 // GNU General Public License for more details.
654 //
655 // You should have received a copy of the GNU General Public License
656 // along with this program. If not, see <http://www.gnu.org/licenses/>.
657 //
658 //Also add information on how to contact you by electronic and paper mail.
659 //
660 // If the program does terminal interaction, make it output a short
661 //notice like this when it starts in an interactive mode:
662 //
663 // <program> Copyright (C) <year> <name of author>
664 // This program comes with ABSOLUTELY NO WARRANTY; for details type `show w'.
665 // This is free software, and you are welcome to redistribute it
666 // under certain conditions; type `show c' for details.
667 //
668 //The hypothetical commands `show w' and `show c' should show the appropriate
669 //parts of the General Public License. Of course, your program's commands
670 //might be different; for a GUI interface, you would use an "about box".
671 //
672 // You should also get your employer (if you work as a programmer) or school,
673 //if any, to sign a "copyright disclaimer" for the program, if necessary.
674 //For more information on this, and how to apply and follow the GNU GPL, see
675 //<http://www.gnu.org/licenses/>.
676 //
677 // The GNU General Public License does not permit incorporating your program
678 //into proprietary programs. If your program is a subroutine library, you
679 //may consider it more useful to permit linking proprietary applications with
680 //the library. If this is what you want to do, use the GNU Lesser General
681 //Public License instead of this License. But first, please read
682 //<http://www.gnu.org/philosophy/why-not-lgpl.html>.
683 //-------------------------------------------------------------------------------------------------
684 //--------------------------------------------------------------------------------
685 #define MODULE_GMP_RALG
686
687 #include <assert.h>
688 #include <stdio.h>
689 #include <string.h>
690 #include <time.h>
691
692
693 #include "fcmiof.h"
694 #include "gmp_ints.h"
695 #include "gmp_rats.h"
696 #include "gmp_ralg.h"
697 #include "intfunc.h"
698
699 #if defined(APP_TYPE_SIMPLE_DOS_CONSOLE)
700 #include "ccmalloc.h"
701 #elif defined(APP_TYPE_IJUSCRIPTER_IJUCONSOLE)
702 #include "tclalloc.h"
703 #else
704 /* Do nothing. */
705 #endif
706
707
708 /******************************************************************/
709 /*** INITIALIZATION AND DESTRUCTION FUNCTIONS *******************/
710 /******************************************************************/
711 //08/16/01: Visual inspection OK.
712 void GMP_RALG_cfdecomp_init(
713 GMP_RALG_cf_app_struct *decomp,
714 int *failure,
715 GMP_INTS_mpz_struct *num,
716 GMP_INTS_mpz_struct *den)
717 {
718 int loop_counter, i;
719 GMP_INTS_mpz_struct arb_temp1, arb_temp2;
720
721 //Eyeball the input parameters. The rest of the eyeballing
722 //will occur as functions are called to manipulate the
723 //numerator and denominator passed in.
724 assert(decomp != NULL);
725 assert(failure != NULL);
726 assert(num != NULL);
727 assert(den != NULL);
728
729 //Allocate space for temporary integers.
730 GMP_INTS_mpz_init(&arb_temp1);
731 GMP_INTS_mpz_init(&arb_temp2);
732
733 //Begin believing no failure.
734 *failure = 0;
735
736 //Initialize the copy of the numerator and denominator and
737 //copy these into the structure.
738 GMP_INTS_mpz_init(&(decomp->num));
739 GMP_INTS_mpz_copy(&(decomp->num), num);
740 GMP_INTS_mpz_init(&(decomp->den));
741 GMP_INTS_mpz_copy(&(decomp->den), den);
742
743 //Allocate the space for the first increment of the
744 //growable areas. We need to use different memory
745 //allocation functions depending on whether we're
746 //in a Tcl build or a DOS command-line utility
747 //build.
748 //Space for partial quotients.
749 decomp->a =
750 #if defined(APP_TYPE_SIMPLE_DOS_CONSOLE)
751 CCMALLOC_malloc(sizeof(GMP_INTS_mpz_struct) * GMP_RALG_CF_ALLOC_INCREMENT);
752 #elif defined(APP_TYPE_IJUSCRIPTER_IJUCONSOLE)
753 (GMP_INTS_mpz_struct *)
754 TclpAlloc(sizeof(GMP_INTS_mpz_struct) * GMP_RALG_CF_ALLOC_INCREMENT);
755 #else
756 malloc(sizeof(GMP_INTS_mpz_struct) * GMP_RALG_CF_ALLOC_INCREMENT);
757 #endif
758
759 //Dividends.
760 decomp->dividend =
761 #if defined(APP_TYPE_SIMPLE_DOS_CONSOLE)
762 CCMALLOC_malloc(sizeof(GMP_INTS_mpz_struct) * GMP_RALG_CF_ALLOC_INCREMENT);
763 #elif defined(APP_TYPE_IJUSCRIPTER_IJUCONSOLE)
764 (GMP_INTS_mpz_struct *)
765 TclpAlloc(sizeof(GMP_INTS_mpz_struct) * GMP_RALG_CF_ALLOC_INCREMENT);
766 #else
767 malloc(sizeof(GMP_INTS_mpz_struct) * GMP_RALG_CF_ALLOC_INCREMENT);
768 #endif
769
770 //Divisors.
771 decomp->divisor =
772 #if defined(APP_TYPE_SIMPLE_DOS_CONSOLE)
773 CCMALLOC_malloc(sizeof(GMP_INTS_mpz_struct) * GMP_RALG_CF_ALLOC_INCREMENT);
774 #elif defined(APP_TYPE_IJUSCRIPTER_IJUCONSOLE)
775 (GMP_INTS_mpz_struct *)
776 TclpAlloc(sizeof(GMP_INTS_mpz_struct) * GMP_RALG_CF_ALLOC_INCREMENT);
777 #else
778 malloc(sizeof(GMP_INTS_mpz_struct) * GMP_RALG_CF_ALLOC_INCREMENT);
779 #endif
780
781 //Remainders.
782 decomp->remainder =
783 #if defined(APP_TYPE_SIMPLE_DOS_CONSOLE)
784 CCMALLOC_malloc(sizeof(GMP_INTS_mpz_struct) * GMP_RALG_CF_ALLOC_INCREMENT);
785 #elif defined(APP_TYPE_IJUSCRIPTER_IJUCONSOLE)
786 (GMP_INTS_mpz_struct *)
787 TclpAlloc(sizeof(GMP_INTS_mpz_struct) * GMP_RALG_CF_ALLOC_INCREMENT);
788 #else
789 malloc(sizeof(GMP_INTS_mpz_struct) * GMP_RALG_CF_ALLOC_INCREMENT);
790 #endif
791
792 //Convergent numerators.
793 decomp->p =
794 #if defined(APP_TYPE_SIMPLE_DOS_CONSOLE)
795 CCMALLOC_malloc(sizeof(GMP_INTS_mpz_struct) * GMP_RALG_CF_ALLOC_INCREMENT);
796 #elif defined(APP_TYPE_IJUSCRIPTER_IJUCONSOLE)
797 (GMP_INTS_mpz_struct *)
798 TclpAlloc(sizeof(GMP_INTS_mpz_struct) * GMP_RALG_CF_ALLOC_INCREMENT);
799 #else
800 malloc(sizeof(GMP_INTS_mpz_struct) * GMP_RALG_CF_ALLOC_INCREMENT);
801 #endif
802
803 //Convergent denominators.
804 decomp->q =
805 #if defined(APP_TYPE_SIMPLE_DOS_CONSOLE)
806 CCMALLOC_malloc(sizeof(GMP_INTS_mpz_struct) * GMP_RALG_CF_ALLOC_INCREMENT);
807 #elif defined(APP_TYPE_IJUSCRIPTER_IJUCONSOLE)
808 (GMP_INTS_mpz_struct *)
809 TclpAlloc(sizeof(GMP_INTS_mpz_struct) * GMP_RALG_CF_ALLOC_INCREMENT);
810 #else
811 malloc(sizeof(GMP_INTS_mpz_struct) * GMP_RALG_CF_ALLOC_INCREMENT);
812 #endif
813
814 //Now the number of allocated slots is what we just allocated.
815 decomp->nallocd = GMP_RALG_CF_ALLOC_INCREMENT;
816
817 //The number of slots actually used is zero, to start with.
818 decomp->n = 0;
819
820 //There are a number of conditions that will lead to an error
821 //where we can't successfully form the continued fraction
822 //decomposition. These errors are:
823 // a)Either component is NAN.
824 // b)Zero denominator.
825 // c)Either component negative.
826 //In these cases, we'll pretend we got 0/1 for the number
827 //and set things accordingly, and we'll set the failure
828 //flag for the caller.
829 //
830 if (GMP_INTS_mpz_get_flags(num)
831 ||
832 GMP_INTS_mpz_get_flags(den)
833 ||
834 GMP_INTS_mpz_is_zero(den)
835 ||
836 GMP_INTS_mpz_is_neg(num)
837 ||
838 GMP_INTS_mpz_is_neg(den))
839 {
840 *failure = 1;
841 decomp->n = 1;
842
843 GMP_INTS_mpz_set_ui(&(decomp->num), 0);
844 GMP_INTS_mpz_set_ui(&(decomp->den), 1);
845
846 GMP_INTS_mpz_init(decomp->dividend);
847 GMP_INTS_mpz_set_ui(decomp->dividend, 0);
848
849 GMP_INTS_mpz_init(decomp->divisor);
850 GMP_INTS_mpz_set_ui(decomp->divisor, 1);
851
852 GMP_INTS_mpz_init(decomp->a);
853 GMP_INTS_mpz_set_ui(decomp->a, 0);
854
855 GMP_INTS_mpz_init(decomp->remainder);
856 GMP_INTS_mpz_set_ui(decomp->remainder, 0);
857
858 GMP_INTS_mpz_init(decomp->p);
859 GMP_INTS_mpz_set_ui(decomp->p, 0);
860
861 GMP_INTS_mpz_init(decomp->q);
862 GMP_INTS_mpz_set_ui(decomp->q, 1);
863
864 goto return_point;
865 }
866
867 //If we're here there are not any errors that we
868 //are willing to detect. We should be clear
869 //for a continued fraction decomposition.
870 loop_counter = 0;
871 do
872 {
873 //Increment the count of "rows", because we're
874 //about to add one.
875 decomp->n++;
876
877 //If we have used up all the space available
878 //for integers, we have to allocate more.
879 if (decomp->n > decomp->nallocd)
880 {
881 //We now have more allocated space.
882 decomp->nallocd += GMP_RALG_CF_ALLOC_INCREMENT;
883
884 //Be absolutely sure we have not made a greivous
885 //error.
886 assert(decomp->n <= decomp->nallocd);
887
888 //Space for dividends.
889 decomp->dividend =
890 #if defined(APP_TYPE_SIMPLE_DOS_CONSOLE)
891 CCMALLOC_realloc(
892 decomp->dividend,
893 sizeof(GMP_INTS_mpz_struct) * decomp->nallocd);
894 #elif defined(APP_TYPE_IJUSCRIPTER_IJUCONSOLE)
895 (GMP_INTS_mpz_struct *)
896 TclpRealloc((char *)decomp->dividend,
897 sizeof(GMP_INTS_mpz_struct) * decomp->nallocd);
898 #else
899 realloc(decomp->dividend, sizeof(GMP_INTS_mpz_struct) * decomp->nallocd);
900 #endif
901
902 //Space for divisors.
903 decomp->divisor =
904 #if defined(APP_TYPE_SIMPLE_DOS_CONSOLE)
905 CCMALLOC_realloc(
906 decomp->divisor,
907 sizeof(GMP_INTS_mpz_struct) * decomp->nallocd);
908 #elif defined(APP_TYPE_IJUSCRIPTER_IJUCONSOLE)
909 (GMP_INTS_mpz_struct *)
910 TclpRealloc((char *)decomp->divisor,
911 sizeof(GMP_INTS_mpz_struct) * decomp->nallocd);
912 #else
913 realloc(decomp->divisor, sizeof(GMP_INTS_mpz_struct) * decomp->nallocd);
914 #endif
915
916 //Space for partial quotients.
917 decomp->a =
918 #if defined(APP_TYPE_SIMPLE_DOS_CONSOLE)
919 CCMALLOC_realloc(
920 decomp->a,
921 sizeof(GMP_INTS_mpz_struct) * decomp->nallocd);
922 #elif defined(APP_TYPE_IJUSCRIPTER_IJUCONSOLE)
923 (GMP_INTS_mpz_struct *)
924 TclpRealloc((char *)decomp->a,
925 sizeof(GMP_INTS_mpz_struct) * decomp->nallocd);
926 #else
927 realloc(decomp->a, sizeof(GMP_INTS_mpz_struct) * decomp->nallocd);
928 #endif
929
930 //Space for remainders.
931 decomp->remainder =
932 #if defined(APP_TYPE_SIMPLE_DOS_CONSOLE)
933 CCMALLOC_realloc(
934 decomp->remainder,
935 sizeof(GMP_INTS_mpz_struct) * decomp->nallocd);
936 #elif defined(APP_TYPE_IJUSCRIPTER_IJUCONSOLE)
937 (GMP_INTS_mpz_struct *)
938 TclpRealloc((char *)decomp->remainder,
939 sizeof(GMP_INTS_mpz_struct) * decomp->nallocd);
940 #else
941 realloc(decomp->remainder, sizeof(GMP_INTS_mpz_struct) * decomp->nallocd);
942 #endif
943
944 //Space for partial quotient numerators.
945 decomp->p =
946 #if defined(APP_TYPE_SIMPLE_DOS_CONSOLE)
947 CCMALLOC_realloc(
948 decomp->p,
949 sizeof(GMP_INTS_mpz_struct) * decomp->nallocd);
950 #elif defined(APP_TYPE_IJUSCRIPTER_IJUCONSOLE)
951 (GMP_INTS_mpz_struct *)
952 TclpRealloc((char *)decomp->p,
953 sizeof(GMP_INTS_mpz_struct) * decomp->nallocd);
954 #else
955 realloc(decomp->p, sizeof(GMP_INTS_mpz_struct) * decomp->nallocd);
956 #endif
957
958 //Space for partial quotient denominators.
959 decomp->q =
960 #if defined(APP_TYPE_SIMPLE_DOS_CONSOLE)
961 CCMALLOC_realloc(
962 decomp->q,
963 sizeof(GMP_INTS_mpz_struct) * decomp->nallocd);
964 #elif defined(APP_TYPE_IJUSCRIPTER_IJUCONSOLE)
965 (GMP_INTS_mpz_struct *)
966 TclpRealloc((char *)decomp->q,
967 sizeof(GMP_INTS_mpz_struct) * decomp->nallocd);
968 #else
969 realloc(decomp->q, sizeof(GMP_INTS_mpz_struct) * decomp->nallocd);
970 #endif
971 }
972
973 //At this point, we have enough space to do the next round of operations.
974 //Set up an index variable.
975 i = decomp->n - 1;
976
977 //Initialize all of the integers at this round.
978 GMP_INTS_mpz_init(decomp->dividend + i);
979 GMP_INTS_mpz_init(decomp->divisor + i);
980 GMP_INTS_mpz_init(decomp->a + i);
981 GMP_INTS_mpz_init(decomp->remainder + i);
982 GMP_INTS_mpz_init(decomp->p + i);
983 GMP_INTS_mpz_init(decomp->q + i);
984
985 //Perform the next round of continued fraction decomposition. This
986 //is standard stuff.
987 if (i==0)
988 {
989 //In the 0th round, we essentially perform initial assignments.
990 GMP_INTS_mpz_copy(decomp->dividend, &(decomp->num));
991 GMP_INTS_mpz_copy(decomp->divisor, &(decomp->den));
992
993 //Make the division to get quotient and remainder.
994 GMP_INTS_mpz_tdiv_qr(decomp->a, decomp->remainder, decomp->dividend, decomp->divisor);
995
996 //The convergents in the first round are always the quotient over 1.
997 GMP_INTS_mpz_copy(decomp->p, decomp->a);
998 GMP_INTS_mpz_set_ui(decomp->q, 1);
999 }
1000 else if (i==1)
1001 {
1002 //In the 1st round, the only point of caution is that we have to
1003 //consider p(k-2)/q(k-2) carefully.
1004 GMP_INTS_mpz_copy(decomp->dividend + 1, decomp->divisor + 0);
1005 GMP_INTS_mpz_copy(decomp->divisor + 1, decomp->remainder + 0);
1006
1007 //Make the division to get quotient and remainder.
1008 GMP_INTS_mpz_tdiv_qr(decomp->a + 1,
1009 decomp->remainder + 1,
1010 decomp->dividend + 1,
1011 decomp->divisor + 1);
1012
1013 //Need to compute the numerator of the convergent. This will be:
1014 // a(1) p(0) + p(-1) = a(1)p(0) + 1.
1015 GMP_INTS_mpz_mul(decomp->p + 1, decomp->a + 1, decomp->p + 0);
1016 GMP_INTS_mpz_set_ui(&arb_temp1, 1);
1017 GMP_INTS_mpz_add(decomp->p + 1, decomp->p + 1, &arb_temp1);
1018
1019 //Need to compute the denominator of the convergent. This will
1020 //be a(1)q(0) + q(-1) = a(1) q(0) = a(1).
1021 GMP_INTS_mpz_copy(decomp->q + 1, decomp->a + 1);
1022 }
1023 else
1024 {
1025 //In the general case, it is a simple formula.
1026 //Rotate in the dividend and divisor from the previous round.
1027 GMP_INTS_mpz_copy(decomp->dividend + i, decomp->divisor + i - 1);
1028 GMP_INTS_mpz_copy(decomp->divisor + i, decomp->remainder + i - 1);
1029
1030 //Make the division to get quotient and remainder.
1031 GMP_INTS_mpz_tdiv_qr(decomp->a + i,
1032 decomp->remainder + i,
1033 decomp->dividend + i,
1034 decomp->divisor + i);
1035
1036 //Need to compute the numerator of the convergent. This will be:
1037 // p(i) = a(i)p(i-1) + p(i-2)
1038 GMP_INTS_mpz_mul(decomp->p + i, decomp->a + i, decomp->p + i - 1);
1039 GMP_INTS_mpz_add(decomp->p + i, decomp->p + i, decomp->p + i - 2);
1040
1041 //Need to compute the numerator of the convergent. This will be:
1042 // q(i) = q(i)q(i-1) + q(i-2)
1043 GMP_INTS_mpz_mul(decomp->q + i, decomp->a + i, decomp->q + i - 1);
1044 GMP_INTS_mpz_add(decomp->q + i, decomp->q + i, decomp->q + i - 2);
1045 }
1046
1047 loop_counter++;
1048 } while(!GMP_INTS_mpz_is_zero(decomp->remainder + decomp->n - 1) && loop_counter < 100000);
1049
1050 //In debug builds, be sure we did not terminate based on the loop counter.
1051 assert(loop_counter != 100000);
1052
1053 return_point:
1054
1055 //Deallocate space for temporary integers.
1056 GMP_INTS_mpz_clear(&arb_temp1);
1057 GMP_INTS_mpz_clear(&arb_temp2);
1058 }
1059
1060
1061 //08/16/01: Visual inspection OK.
1062 void GMP_RALG_cfdecomp_destroy(
1063 GMP_RALG_cf_app_struct *decomp
1064 )
1065 {
1066 int i;
1067
1068 //Eyeball the input parameters. Other eyeballing
1069 //will be done as integers are destroyed.
1070 assert(decomp != NULL);
1071
1072 //First, destroy the things that are bound directly
1073 //to the record.
1074 GMP_INTS_mpz_clear(&(decomp->num));
1075 GMP_INTS_mpz_clear(&(decomp->den));
1076
1077 //Now, destroy every integer which is allocated.
1078 for (i=0; i < decomp->n; i++)
1079 {
1080 GMP_INTS_mpz_clear(decomp->dividend + i);
1081 GMP_INTS_mpz_clear(decomp->divisor + i);
1082 GMP_INTS_mpz_clear(decomp->a + i);
1083 GMP_INTS_mpz_clear(decomp->remainder + i);
1084 GMP_INTS_mpz_clear(decomp->p + i);
1085 GMP_INTS_mpz_clear(decomp->q + i);
1086 }
1087
1088 //Now, destroy the arrays of integers.
1089 #if defined(APP_TYPE_SIMPLE_DOS_CONSOLE)
1090 CCMALLOC_free(decomp->dividend);
1091 #elif defined(APP_TYPE_IJUSCRIPTER_IJUCONSOLE)
1092 TclpFree((char *)decomp->dividend);
1093 #else
1094 free(decomp->dividend);
1095 #endif
1096 #if defined(APP_TYPE_SIMPLE_DOS_CONSOLE)
1097 CCMALLOC_free(decomp->divisor);
1098 #elif defined(APP_TYPE_IJUSCRIPTER_IJUCONSOLE)
1099 TclpFree((char *)decomp->divisor);
1100 #else
1101 free(decomp->divisor);
1102 #endif
1103 #if defined(APP_TYPE_SIMPLE_DOS_CONSOLE)
1104 CCMALLOC_free(decomp->a);
1105 #elif defined(APP_TYPE_IJUSCRIPTER_IJUCONSOLE)
1106 TclpFree((char *)decomp->a);
1107 #else
1108 free(decomp->a);
1109 #endif
1110 #if defined(APP_TYPE_SIMPLE_DOS_CONSOLE)
1111 CCMALLOC_free(decomp->remainder);
1112 #elif defined(APP_TYPE_IJUSCRIPTER_IJUCONSOLE)
1113 TclpFree((char *)decomp->remainder);
1114 #else
1115 free(decomp->remainder);
1116 #endif
1117 #if defined(APP_TYPE_SIMPLE_DOS_CONSOLE)
1118 CCMALLOC_free(decomp->p);
1119 #elif defined(APP_TYPE_IJUSCRIPTER_IJUCONSOLE)
1120 TclpFree((char *)decomp->p);
1121 #else
1122 free(decomp->p);
1123 #endif
1124 #if defined(APP_TYPE_SIMPLE_DOS_CONSOLE)
1125 CCMALLOC_free(decomp->q);
1126 #elif defined(APP_TYPE_IJUSCRIPTER_IJUCONSOLE)
1127 TclpFree((char *)decomp->q);
1128 #else
1129 free(decomp->q);
1130 #endif
1131 }
1132
1133
1134 /******************************************************************/
1135 /*** FORMATTED OUTPUT FUNCTIONS *********************************/
1136 /******************************************************************/
1137 //08/16/01: Visual inspection OK.
1138 void GMP_RALG_cfdecomp_emit(
1139 FILE *s,
1140 char *banner,
1141 GMP_RALG_cf_app_struct *decomp,
1142 int nf,
1143 int dap,
1144 const GMP_INTS_mpz_struct *dap_denominator)
1145 {
1146 int i;
1147
1148 GMP_INTS_mpz_struct arb_temp, arb_quotient, arb_remainder;
1149
1150 //Eyeball the input parameters. The banner is allowed to
1151 //be null, so can't check that.
1152 assert(s != NULL);
1153 assert(decomp != NULL);
1154
1155 //Allocate our temporary integers.
1156 GMP_INTS_mpz_init(&arb_temp);
1157 GMP_INTS_mpz_init(&arb_quotient);
1158 GMP_INTS_mpz_init(&arb_remainder);
1159
1160 //If banner requested and noformat option not used.
1161 if (banner && !nf)
1162 {
1163 FCMIOF_stream_bannerheading(s, banner, 1);
1164 }
1165
1166 //Dump the input numerator.
1167 if (!nf)
1168 {
1169 GMP_INTS_mpz_long_int_format_to_stream(s,
1170 &(decomp->num),
1171 "Input Numerator");
1172 }
1173 else
1174 {
1175 GMP_INTS_mpz_arb_int_raw_to_stream(s, &(decomp->num));
1176 fprintf(s, "\n");
1177 }
1178
1179 //Separator if not in unformatted mode.
1180 if (!nf)
1181 FCMIOF_stream_hline(s);
1182
1183 //Dump the input denominator.
1184 if (!nf)
1185 {
1186 GMP_INTS_mpz_long_int_format_to_stream(s,
1187 &(decomp->den),
1188 "Input Denominator");
1189 }
1190 else
1191 {
1192 GMP_INTS_mpz_arb_int_raw_to_stream(s, &(decomp->den));
1193 fprintf(s, "\n");
1194 }
1195
1196 //Separator if not in unformatted mode.
1197 if (!nf)
1198 FCMIOF_stream_hline(s);
1199
1200 for (i=0; i<decomp->n; i++)
1201 {
1202 char strbuf[100];
1203 //Buffer to prepare description.
1204
1205 //Print out the dividend at each round.
1206 if (!nf)
1207 {
1208 sprintf(strbuf, "dividend(%d)", i);
1209 GMP_INTS_mpz_long_int_format_to_stream(s,
1210 decomp->dividend + i,
1211 strbuf);
1212 }
1213 else
1214 {
1215 GMP_INTS_mpz_arb_int_raw_to_stream(s, decomp->dividend+i);
1216 fprintf(s, "\n");
1217 }
1218
1219 //Separator if not in unformatted mode.
1220 if (!nf)
1221 FCMIOF_stream_hline(s);
1222
1223 //Print out the divisor at each round.
1224 if (!nf)
1225 {
1226 sprintf(strbuf, "divisor(%d)", i);
1227 GMP_INTS_mpz_long_int_format_to_stream(s,
1228 decomp->divisor + i,
1229 strbuf);
1230 }
1231 else
1232 {
1233 GMP_INTS_mpz_arb_int_raw_to_stream(s, decomp->divisor+i);
1234 fprintf(s, "\n");
1235 }
1236
1237 //Separator if not in unformatted mode.
1238 if (!nf)
1239 FCMIOF_stream_hline(s);
1240
1241 //Print out partial quotient at each round.
1242 if (!nf)
1243 {
1244 sprintf(strbuf, "a(%d)", i);
1245 GMP_INTS_mpz_long_int_format_to_stream(s,
1246 decomp->a + i,
1247 strbuf);
1248 }
1249 else
1250 {
1251 GMP_INTS_mpz_arb_int_raw_to_stream(s, decomp->a+i);
1252 fprintf(s, "\n");
1253 }
1254
1255 //Separator if not in unformatted mode.
1256 if (!nf)
1257 FCMIOF_stream_hline(s);
1258
1259 //It doesn't make any sense to print out the
1260 //remainder, because this becomes the divisor
1261 //for the next round. It is just wasted output
1262 //lines.
1263
1264 //Print out the convergent numerator at
1265 //each round.
1266 if (!nf)
1267 {
1268 sprintf(strbuf, "p(%d)", i);
1269 GMP_INTS_mpz_long_int_format_to_stream(s,
1270 decomp->p + i,
1271 strbuf);
1272 }
1273 else
1274 {
1275 GMP_INTS_mpz_arb_int_raw_to_stream(s, decomp->p+i);
1276 fprintf(s, "\n");
1277 }
1278
1279 //Separator if not in unformatted mode.
1280 if (!nf)
1281 FCMIOF_stream_hline(s);
1282
1283 //Print out the convergent denominator at
1284 //each round.
1285 if (!nf)
1286 {
1287 sprintf(strbuf, "q(%d)", i);
1288 GMP_INTS_mpz_long_int_format_to_stream(s,
1289 decomp->q + i,
1290 strbuf);
1291 }
1292 else
1293 {
1294 GMP_INTS_mpz_arb_int_raw_to_stream(s, decomp->q+i);
1295 fprintf(s, "\n");
1296 }
1297
1298 //Separator if not in unformatted mode.
1299 if (!nf)
1300 FCMIOF_stream_hline(s);
1301
1302 if (dap)
1303 {
1304 //Calculate the DAP numerator
1305 GMP_INTS_mpz_mul(&arb_temp, dap_denominator, decomp->p + i);
1306 GMP_INTS_mpz_tdiv_qr(&arb_quotient, &arb_remainder,
1307 &arb_temp, decomp->q + i);
1308
1309 //Print DAP numerator.
1310 if (!nf)
1311 {
1312 sprintf(strbuf, "dap_h(%d)", i);
1313 GMP_INTS_mpz_long_int_format_to_stream(s,
1314 &arb_quotient,
1315 strbuf);
1316 }
1317 else
1318 {
1319 GMP_INTS_mpz_arb_int_raw_to_stream(s, &arb_quotient);
1320 fprintf(s, "\n");
1321 }
1322
1323 //Separator if not in unformatted mode.
1324 if (!nf)
1325 FCMIOF_stream_hline(s);
1326
1327 //Print DAP denominator.
1328 if (!nf)
1329 {
1330 sprintf(strbuf, "dap_k(%d)", i);
1331 GMP_INTS_mpz_long_int_format_to_stream(s,
1332 dap_denominator,
1333 strbuf);
1334 }
1335 else
1336 {
1337 GMP_INTS_mpz_arb_int_raw_to_stream(s, dap_denominator);
1338 fprintf(s, "\n");
1339 }
1340
1341 //Separator if not in unformatted mode.
1342 if (!nf)
1343 FCMIOF_stream_hline(s);
1344 }
1345 }
1346
1347 //Deallocate our temporary integers.
1348 GMP_INTS_mpz_clear(&arb_temp);
1349 GMP_INTS_mpz_clear(&arb_quotient);
1350 GMP_INTS_mpz_clear(&arb_remainder);
1351 }
1352
1353
1354 /******************************************************************/
1355 /*** FAREY SERIES PREDECESSOR AND SUCCESSOR FUNCTIONS ***********/
1356 /******************************************************************/
1357 //08/16/01: Visual inspection OK.
1358 void GMP_RALG_farey_predecessor(
1359 GMP_RATS_mpq_struct *result,
1360 const GMP_RATS_mpq_struct *plus_two,
1361 const GMP_RATS_mpq_struct *plus_one,
1362 const GMP_INTS_mpz_struct *N)
1363 {
1364 GMP_RATS_mpq_struct result_copy;
1365 //Used to hold return value in case the result
1366 //is the same as either of the input arguments.
1367 GMP_INTS_mpz_struct temp1, temp2, floor_func;
1368 //Temporary integers.
1369
1370 assert(result != NULL);
1371 assert(plus_two != NULL);
1372 assert(plus_one != NULL);
1373 assert(N != NULL);
1374
1375 //Initialize the variables used.
1376 GMP_RATS_mpq_init(&result_copy);
1377 GMP_INTS_mpz_init(&temp1);
1378 GMP_INTS_mpz_init(&temp2);
1379 GMP_INTS_mpz_init(&floor_func);
1380
1381 //Numerator of the term in the floor function.
1382 GMP_INTS_mpz_add(&temp1, &(plus_two->den), N);
1383
1384 //Term in the floor function. This is used to
1385 //calculate both numerator and denominator, so we save it.
1386 GMP_INTS_mpz_tdiv_qr(&floor_func, &temp2, &temp1, &(plus_one->den));
1387
1388 //Product of result of floor function and numerator--now
1389 //forming the numerator of the output.
1390 GMP_INTS_mpz_mul(&temp2, &floor_func, &(plus_one->num));
1391
1392 //Final result assigned to numerator.
1393 GMP_INTS_mpz_sub(&(result_copy.num), &temp2, &(plus_two->num));
1394
1395 //Product of result of floor function and denominator--now
1396 //forming the denominator of the output.
1397 GMP_INTS_mpz_mul(&temp2, &floor_func, &(plus_one->den));
1398
1399 //Final result assigned to denominator.
1400 GMP_INTS_mpz_sub(&(result_copy.den), &temp2, &(plus_two->den));
1401
1402 //Copy the result to the object owned by the caller.
1403 GMP_RATS_mpq_copy(result, &result_copy);
1404
1405 //Deallocate dynamic memory.
1406 GMP_RATS_mpq_clear(&result_copy);
1407 GMP_INTS_mpz_clear(&temp1);
1408 GMP_INTS_mpz_clear(&temp2);
1409 GMP_INTS_mpz_clear(&floor_func);
1410 }
1411
1412
1413 //08/16/01: Visual inspection OK.
1414 void GMP_RALG_farey_successor(
1415 GMP_RATS_mpq_struct *result,
1416 const GMP_RATS_mpq_struct *minus_two,
1417 const GMP_RATS_mpq_struct *minus_one,
1418 const GMP_INTS_mpz_struct *N)
1419 {
1420 GMP_RATS_mpq_struct result_copy;
1421 //Used to hold return value in case the result
1422 //is the same as either of the input arguments.
1423 GMP_INTS_mpz_struct temp1, temp2, floor_func;
1424 //Temporary integers.
1425
1426 assert(result != NULL);
1427 assert(minus_two != NULL);
1428 assert(minus_one != NULL);
1429 assert(N != NULL);
1430
1431 //Initialize the variables used.
1432 GMP_RATS_mpq_init(&result_copy);
1433 GMP_INTS_mpz_init(&temp1);
1434 GMP_INTS_mpz_init(&temp2);
1435 GMP_INTS_mpz_init(&floor_func);
1436
1437 //Numerator of the term in the floor function.
1438 GMP_INTS_mpz_add(&temp1, &(minus_two->den), N);
1439
1440 //Term in the floor function. This is used to
1441 //calculate both numerator and denominator, so we save it.
1442 GMP_INTS_mpz_tdiv_qr(&floor_func, &temp2, &temp1, &(minus_one->den));
1443
1444 //Product of result of floor function and numerator--now
1445 //forming the numerator of the output.
1446 GMP_INTS_mpz_mul(&temp2, &floor_func, &(minus_one->num));
1447
1448 //Final result assigned to numerator.
1449 GMP_INTS_mpz_sub(&(result_copy.num), &temp2, &(minus_two->num));
1450
1451 //Product of result of floor function and denominator--now
1452 //forming the denominator of the output.
1453 GMP_INTS_mpz_mul(&temp2, &floor_func, &(minus_one->den));
1454
1455 //Final result assigned to denominator.
1456 GMP_INTS_mpz_sub(&(result_copy.den), &temp2, &(minus_two->den));
1457
1458 //Copy the result to the object owned by the caller.
1459 GMP_RATS_mpq_copy(result, &result_copy);
1460
1461 //Deallocate dynamic memory.
1462 GMP_RATS_mpq_clear(&result_copy);
1463 GMP_INTS_mpz_clear(&temp1);
1464 GMP_INTS_mpz_clear(&temp2);
1465 GMP_INTS_mpz_clear(&floor_func);
1466 }
1467
1468
1469 //08/16/01: Visual inspection OK.
1470 void GMP_RALG_enclosing_farey_neighbors(
1471 const GMP_RATS_mpq_struct *rn_in,
1472 const GMP_INTS_mpz_struct *N,
1473 const GMP_RALG_cf_app_struct *cf_rep,
1474 int *equality,
1475 GMP_RATS_mpq_struct *left,
1476 GMP_RATS_mpq_struct *right)
1477 {
1478 GMP_RATS_mpq_struct rn_abs;
1479 //Absolute value of rational number supplied.
1480 GMP_RATS_mpq_struct previous_convergent;
1481 //Convergent before the one that has the denominator
1482 //not exceeding the order of the series. Need to fudge
1483 //a little bit because don't have -1-th order convergents
1484 //tabulated.
1485 GMP_RATS_mpq_struct other_neighbor;
1486 //The other neighbor besides the highest-order convergent
1487 //without denominator too large.
1488 GMP_INTS_mpz_struct temp1, temp2, temp3, temp4;
1489 //Temporary integers.
1490 int ho_conv;
1491 //Index of highest-ordered convergent that does not have
1492 //denominator too large.
1493
1494 //Eyeball the parameters.
1495 assert(rn_in != NULL);
1496 assert(N != NULL);
1497 assert(cf_rep != NULL);
1498 assert(equality != NULL);
1499 assert(left != NULL);
1500 assert(right != NULL);
1501
1502 //Allocate dynamic variables.
1503 GMP_RATS_mpq_init(&rn_abs);
1504 GMP_RATS_mpq_init(&previous_convergent);
1505 GMP_RATS_mpq_init(&other_neighbor);
1506 GMP_INTS_mpz_init(&temp1);
1507 GMP_INTS_mpz_init(&temp2);
1508 GMP_INTS_mpz_init(&temp3);
1509 GMP_INTS_mpz_init(&temp4);
1510
1511 //Zero is a troublesome case, because it requires us to
1512 //cross signs. Split this case out explicitly.
1513 if (GMP_INTS_mpz_is_zero(&(rn_in->num)))
1514 {
1515 *equality = 1; //0/1 a member of Farey series of any order.
1516 GMP_INTS_mpz_set_si(&(left->num), -1);
1517 GMP_INTS_mpz_copy(&(left->den), N);
1518 GMP_INTS_mpz_set_si(&(right->num), 1);
1519 GMP_INTS_mpz_copy(&(right->den), N);
1520 }
1521 else
1522 {
1523 //Make a copy of the rational number in. As a condition of
1524 //using this function, it must be normalized, but it still
1525 //may be negative. Our strategy is to treat the number as
1526 //positive, find the neighbors, then if it was negative
1527 //complement and re-order the neighbors. In other words,
1528 //find neighbors to a negative number by symmetry, not
1529 //by forming the CF representation of a negative number.
1530 //Also, we can't touch the input parameter.
1531 GMP_RATS_mpq_copy(&rn_abs, rn_in);
1532 GMP_INTS_mpz_abs(&(rn_abs.num));
1533
1534 //Find the index of the highest-ordered convergent
1535 //with a denominator not exceeding the denominator of
1536 //the rational number supplied. The zero'th order
1537 //convergent has a denominator of 1, so that one
1538 //at least is safe.
1539
1540 //Assign either the "left" or right
1541 //neighbor to be the highest-ordered
1542 //convergent with a denominator not exceeding the
1543 //denominator of the rational number input. I say
1544 //"either" because the properties of convergents let
1545 //us know based on the oddness or evenness of the order
1546 //which side it is on.
1547 ho_conv = 0;
1548 while (((ho_conv + 1) < cf_rep->n) && (GMP_INTS_mpz_cmp(cf_rep->q + ho_conv + 1, N) <= 0))
1549 {
1550 #if 0
1551 //Some questions about this loop--debugging output.
1552 printf("ho_conv : %d\n", ho_conv);
1553 GMP_INTS_mpz_long_int_format_to_stream(stdout,
1554 cf_rep->q + ho_conv + 1,
1555 "decomp_den");
1556 GMP_INTS_mpz_long_int_format_to_stream(stdout,
1557 &(rn_abs.den),
1558 "rn_in_den");
1559 printf("Compare result: %d\n\n", GMP_INTS_mpz_cmp(cf_rep->q + ho_conv + 1, &(rn_abs.den)));
1560 #endif
1561
1562 ho_conv++;
1563 }
1564
1565 if (INTFUNC_is_even(ho_conv))
1566 {
1567 GMP_INTS_mpz_copy(&(left->num), cf_rep->p + ho_conv);
1568 GMP_INTS_mpz_copy(&(left->den), cf_rep->q + ho_conv);
1569 }
1570 else
1571 {
1572 GMP_INTS_mpz_copy(&(right->num), cf_rep->p + ho_conv);
1573 GMP_INTS_mpz_copy(&(right->den), cf_rep->q + ho_conv);
1574 }
1575
1576 //Now, we need to calculate the other neighbor based
1577 //on the standard formula. This is a little tricky
1578 //because we don't have the -1-th order convergents
1579 //tabulated so we have to fudge a little bit.
1580 if (ho_conv == 0)
1581 {
1582 GMP_RATS_mpq_set_si(&previous_convergent, 1, 0);
1583 }
1584 else
1585 {
1586 GMP_INTS_mpz_copy(&(previous_convergent.num), cf_rep->p + ho_conv - 1);
1587 GMP_INTS_mpz_copy(&(previous_convergent.den), cf_rep->q + ho_conv - 1);
1588 }
1589
1590 //Calculate the other neighbor according to the standard
1591 //formula.
1592 GMP_INTS_mpz_sub(&temp1, N, &(previous_convergent.den));
1593 GMP_INTS_mpz_tdiv_qr(&temp2, &temp3, &temp1, cf_rep->q + ho_conv);
1594 //temp2 now contains term from floor() function in formula.
1595 GMP_INTS_mpz_mul(&temp1, &temp2, cf_rep->p + ho_conv);
1596 GMP_INTS_mpz_add(&(other_neighbor.num), &temp1, &(previous_convergent.num));
1597 GMP_INTS_mpz_mul(&temp1, &temp2, cf_rep->q + ho_conv);
1598 GMP_INTS_mpz_add(&(other_neighbor.den), &temp1, &(previous_convergent.den));
1599
1600 //Copy the other neighbor into the right slot.
1601 if (INTFUNC_is_even(ho_conv))
1602 {
1603 GMP_RATS_mpq_copy(right, &other_neighbor);
1604 }
1605 else
1606 {
1607 GMP_RATS_mpq_copy(left, &other_neighbor);
1608 }
1609
1610 //Set the equality flag. We have equality if and only
1611 //if the denominator of the rational number is less than
1612 //or equal to N.
1613 if (GMP_INTS_mpz_cmp(&(rn_abs.den), N) <= 0)
1614 {
1615 *equality = 1;
1616 }
1617 else
1618 {
1619 *equality = 0;
1620 }
1621
1622 //In the event of equality, we don't really have the true
1623 //neighbors. If the final convergent is even-ordered,
1624 //the left needs to be replaced. If the final convergent
1625 //is odd-ordered, the right needs to be replaced.
1626 if (*equality)
1627 {
1628 if (INTFUNC_is_even(ho_conv))
1629 {
1630 //Left needs to be replaced.
1631 GMP_RALG_farey_predecessor(
1632 left,
1633 right,
1634 &rn_abs,
1635 N);
1636 }
1637 else
1638 {
1639 //Right needs to be replaced.
1640 GMP_RALG_farey_successor(
1641 right,
1642 left,
1643 &rn_abs,
1644 N);
1645 }
1646 }
1647
1648 //OK, we should be all done. The final catch is that if
1649 //the number supplied was negative, we need to invert
1650 //and re-order the neighbors.
1651 if (GMP_INTS_mpz_is_neg(&(rn_in->num)))
1652 {
1653 GMP_RATS_mpq_swap(left, right);
1654 GMP_INTS_mpz_negate(&(left->num));
1655 GMP_INTS_mpz_negate(&(right->num));
1656 }
1657 } //End if (rn==0) else clause
1658
1659 //Deallocate dynamic variables.
1660 GMP_RATS_mpq_clear(&rn_abs);
1661 GMP_RATS_mpq_clear(&previous_convergent);
1662 GMP_RATS_mpq_clear(&other_neighbor);
1663 GMP_INTS_mpz_clear(&temp1);
1664 GMP_INTS_mpz_clear(&temp2);
1665 GMP_INTS_mpz_clear(&temp3);
1666 GMP_INTS_mpz_clear(&temp4);
1667 }
1668
1669
1670
1671 //08/16/01: Visual inspection OK. Did not fully inspect the
1672 //iterative part of this function. Unit testing will be
1673 //careful, expect that to catch any anomalies.
1674 void GMP_RALG_consecutive_fab_terms(
1675 const GMP_RATS_mpq_struct *rn_in,
1676 const GMP_INTS_mpz_struct *kmax,
1677 const GMP_INTS_mpz_struct *hmax,
1678 int n_left_in,
1679 int n_right_in,
1680 GMP_RALG_fab_neighbor_collection_struct *result
1681 )
1682 {
1683 int error_flag, equality_flag;
1684 char *estring_kmax_neg = "KMAX is zero, negative, or NAN.";
1685 char *estring_hmax_neg = "HMAX is negative or NAN.";
1686 char *estring_general = "Unspecified general error in GMP_RALG_consecutive_fab_terms().";
1687
1688 GMP_RATS_mpq_struct q_temp1, q_temp2, q_temp3, q_temp4,
1689 left_neighbor, right_neighbor,
1690 left_neighbor_abs, right_neighbor_abs,
1691 hmax_over_one_neg, corner_point_neg,
1692 abs_norm_recip_rn;
1693
1694 //Eyeball input parameters.
1695 assert(rn_in != NULL);
1696 assert(kmax != NULL);
1697 assert(n_left_in >= 0);
1698 assert(n_left_in <= 0x00FFFFFF);
1699 assert(n_right_in >= 0);
1700 assert(n_right_in <= 0x00FFFFFF);
1701 assert(result != NULL);
1702
1703 //Allocate all of the dynamic memory we'll need for this function. It will be
1704 //released at the end.
1705 GMP_RATS_mpq_init(&q_temp1);
1706 GMP_RATS_mpq_init(&q_temp2);
1707 GMP_RATS_mpq_init(&q_temp3);
1708 GMP_RATS_mpq_init(&q_temp4);
1709 GMP_RATS_mpq_init(&left_neighbor);
1710 GMP_RATS_mpq_init(&right_neighbor);
1711 GMP_RATS_mpq_init(&left_neighbor_abs);
1712 GMP_RATS_mpq_init(&right_neighbor_abs);
1713 GMP_RATS_mpq_init(&hmax_over_one_neg);
1714 GMP_RATS_mpq_init(&corner_point_neg);
1715 GMP_RATS_mpq_init(&abs_norm_recip_rn);
1716
1717 //Zero out the result block. This is the easiest way to give many variables
1718 //default values of 0, FALSE, and NULL.
1719 memset(result, 0, sizeof(GMP_RALG_fab_neighbor_collection_struct));
1720
1721 //Allocate all integer and rational number structures in the result block.
1722 GMP_RATS_mpq_init(&(result->rn_in));
1723 GMP_INTS_mpz_init(&(result->kmax_in));
1724 GMP_INTS_mpz_init(&(result->hmax_in));
1725 GMP_RATS_mpq_init(&(result->hmax_over_one));
1726 GMP_RATS_mpq_init(&(result->corner_point));
1727 GMP_RATS_mpq_init(&(result->corner_point_minus_one));
1728 GMP_RATS_mpq_init(&(result->corner_point_plus_one));
1729 GMP_RATS_mpq_init(&(result->norm_rn));
1730 GMP_RATS_mpq_init(&(result->abs_norm_rn));
1731
1732 //Fill in the rational number, exactly as passed.
1733 GMP_RATS_mpq_copy(&(result->rn_in), rn_in);
1734
1735 //Fill in the number of left and right neighbors that the caller wants.
1736 //However, let's of course say nothing less than zero and nothing more
1737 //than 10000 neighbors on either side.
1738 result->n_left_in = INTFUNC_min(INTFUNC_max(0, n_left_in), 10000);
1739 result->n_right_in = INTFUNC_min(INTFUNC_max(0, n_right_in), 10000);
1740
1741 //Fill in the value of KMAX, exactly as passed. If it is not at least
1742 //the value of 1 or if error flags, croak.
1743 GMP_INTS_mpz_copy(&(result->kmax_in), kmax);
1744 if (GMP_INTS_mpz_get_flags(kmax) || GMP_INTS_mpz_is_zero(kmax) || GMP_INTS_mpz_is_neg(kmax))
1745 {
1746 result->error =
1747 #if defined(APP_TYPE_SIMPLE_DOS_CONSOLE)
1748 CCMALLOC_malloc(sizeof(char) * (strlen(estring_kmax_neg) + 1));
1749 #elif defined(APP_TYPE_IJUSCRIPTER_IJUCONSOLE)
1750 TclpAlloc(sizeof(char) * (strlen(estring_kmax_neg) + 1));
1751 #else
1752 malloc(sizeof(char) * (strlen(estring_kmax_neg) + 1));
1753 #endif
1754 strcpy(result->error, estring_kmax_neg);
1755 goto return_point;
1756 }
1757
1758 //Decide whether the caller intends to use HMAX. Neg is error, but zero
1759 //is a signal that don't intend to use.
1760 if (hmax)
1761 {
1762 GMP_INTS_mpz_copy(&(result->hmax_in), hmax);
1763 if (GMP_INTS_mpz_get_flags(hmax) || GMP_INTS_mpz_is_neg(hmax))
1764 {
1765 result->error =
1766 #if defined(APP_TYPE_SIMPLE_DOS_CONSOLE)
1767 CCMALLOC_malloc(sizeof(char) * (strlen(estring_hmax_neg) + 1));
1768 #elif defined(APP_TYPE_IJUSCRIPTER_IJUCONSOLE)
1769 TclpAlloc(sizeof(char) * (strlen(estring_hmax_neg) + 1));
1770 #else
1771 malloc(sizeof(char) * (strlen(estring_hmax_neg) + 1));
1772 #endif
1773 strcpy(result->error, estring_hmax_neg);
1774 goto return_point;
1775 }
1776 else if (GMP_INTS_mpz_is_pos(hmax))
1777 {
1778 result->hmax_supplied = 1;
1779 }
1780 }
1781
1782 //If HMAX has been supplied, assign and normalize the
1783 //corner point.
1784 if (result->hmax_supplied)
1785 {
1786 GMP_INTS_mpz_copy(&(result->corner_point.num), &(result->hmax_in));
1787 GMP_INTS_mpz_copy(&(result->corner_point.den), &(result->kmax_in));
1788 GMP_RATS_mpq_normalize(&(result->corner_point));
1789 }
1790
1791 //If HMAX has been supplied, we want to get the continued
1792 //fraction representation of both the corner point and its
1793 //reciprocal. This is because we're going to need to
1794 //find its adjacent points so we can easily crawl
1795 //around a rectangular region of the integer lattice.
1796 if (result->hmax_supplied)
1797 {
1798 //CF representation of corner point.
1799 GMP_RALG_cfdecomp_init(&(result->corner_point_cf_rep),
1800 &error_flag,
1801 &(result->corner_point.num),
1802 &(result->corner_point.den));
1803 result->corner_point_cf_rep_formed = 1;
1804
1805 //If there was an error forming the CF representation
1806 //of the corner point, bail out.
1807 if (error_flag)
1808 {
1809 result->error =
1810 #if defined(APP_TYPE_SIMPLE_DOS_CONSOLE)
1811 CCMALLOC_malloc(sizeof(char) * (strlen(estring_general) + 1));
1812 #elif defined(APP_TYPE_IJUSCRIPTER_IJUCONSOLE)
1813 TclpAlloc(sizeof(char) * (strlen(estring_general) + 1));
1814 #else
1815 malloc(sizeof(char) * (strlen(estring_general) + 1));
1816 #endif
1817 strcpy(result->error, estring_general);
1818 goto return_point;
1819 }
1820
1821 //CF representation of reciprocal of corner point.
1822 GMP_RALG_cfdecomp_init(&(result->corner_point_recip_cf_rep),
1823 &error_flag,
1824 &(result->corner_point.den),
1825 &(result->corner_point.num));
1826 result->corner_point_recip_cf_rep_formed = 1;
1827
1828 //If there was an error forming the CF representation
1829 //of the reciprocal of the corner point, bail out.
1830 if (error_flag)
1831 {
1832 result->error =
1833 #if defined(APP_TYPE_SIMPLE_DOS_CONSOLE)
1834 CCMALLOC_malloc(sizeof(char) * (strlen(estring_general) + 1));
1835 #elif defined(APP_TYPE_IJUSCRIPTER_IJUCONSOLE)
1836 TclpAlloc(sizeof(char) * (strlen(estring_general) + 1));
1837 #else
1838 malloc(sizeof(char) * (strlen(estring_general) + 1));
1839 #endif
1840 strcpy(result->error, estring_general);
1841 goto return_point;
1842 }
1843 }
1844
1845 //Normalize the rational number supplied.
1846 GMP_RATS_mpq_copy(&(result->norm_rn), rn_in);
1847 GMP_RATS_mpq_normalize(&(result->norm_rn));
1848
1849 //Form the absolute value of the normalized
1850 //version, and set the neg flag.
1851 GMP_RATS_mpq_copy(&(result->abs_norm_rn),&(result->norm_rn));
1852 if (GMP_INTS_mpz_is_neg(&(result->abs_norm_rn.num)))
1853 {
1854 GMP_INTS_mpz_negate(&(result->abs_norm_rn.num));
1855 result->rn_is_neg = 1;
1856 }
1857
1858 //Form the continued fraction representation of the
1859 //absolute value of the rational number supplied.
1860 //This is always required, because we cannot get any
1861 //neighbors without it.
1862 GMP_RALG_cfdecomp_init(&(result->rn_abs_cf_rep),
1863 &error_flag,
1864 &(result->abs_norm_rn.num),
1865 &(result->abs_norm_rn.den));
1866 result->rn_abs_cf_rep_formed = 1;
1867
1868 //If there was an error forming the CF representation
1869 //of the absolute value of rational number supplied, bail out.
1870 if (error_flag)
1871 {
1872 result->error =
1873 #if defined(APP_TYPE_SIMPLE_DOS_CONSOLE)
1874 CCMALLOC_malloc(sizeof(char) * (strlen(estring_general) + 1));
1875 #elif defined(APP_TYPE_IJUSCRIPTER_IJUCONSOLE)
1876 TclpAlloc(sizeof(char) * (strlen(estring_general) + 1));
1877 #else
1878 malloc(sizeof(char) * (strlen(estring_general) + 1));
1879 #endif
1880 strcpy(result->error, estring_general);
1881 goto return_point;
1882 }
1883
1884 //Set the equality flag. The rational number supplied is
1885 //in the series of interest if and only if, in its normalized
1886 //form, K <= KMAX, and if HMAX was supplied, H <= HMAX.
1887 if (GMP_INTS_mpz_cmp(&(result->abs_norm_rn.den), kmax) <= 0)
1888 {
1889 if (result->hmax_supplied)
1890 {
1891 if (GMP_INTS_mpz_cmp(&(result->abs_norm_rn.num), hmax) <= 0)
1892 {
1893 result->equality = 1;
1894 }
1895 else
1896 {
1897 result->equality = 0;
1898 }
1899 }
1900 else
1901 {
1902 result->equality = 1;
1903 }
1904 }
1905 else
1906 {
1907 result->equality = 0;
1908 }
1909
1910 //The final cause of error is if the rational number
1911 //supplied is outside the interval [-HMAX/1, HMAX/1].
1912 //In such cases, simply refuse to calculate
1913 //any approximations. This error can only occur
1914 //if HMAX is specified. If only KMAX is specified,
1915 //this error cannot occur.
1916 if (result->hmax_supplied)
1917 {
1918 //Form the rational number HMAX/1. We will use it for
1919 //a comparison.
1920 GMP_INTS_mpz_copy(&(result->hmax_over_one.num), hmax);
1921 GMP_INTS_mpz_set_ui(&(result->hmax_over_one.den), 1);
1922
1923 //If the comparison shows that the absolute value of
1924 //the rational number in is larger than HMAX over 1,
1925 //then declare an error.
1926 if (GMP_RATS_mpq_cmp(&(result->abs_norm_rn),&(result->hmax_over_one),NULL) > 0)
1927 {
1928 result->error =
1929 #if defined(APP_TYPE_SIMPLE_DOS_CONSOLE)
1930 CCMALLOC_malloc(sizeof(char) * (strlen(estring_general) + 1));
1931 #elif defined(APP_TYPE_IJUSCRIPTER_IJUCONSOLE)
1932 TclpAlloc(sizeof(char) * (strlen(estring_general) + 1));
1933 #else
1934 malloc(sizeof(char) * (strlen(estring_general) + 1));
1935 #endif
1936 strcpy(result->error, estring_general);
1937 goto return_point;
1938 }
1939 }
1940
1941 //If we're here, we're very much clean. The only thing
1942 //that could go wrong is an overflow.
1943
1944 //Allocate space for the left and right arrays of
1945 //neighbors.
1946 if (result->n_left_in)
1947 {
1948 result->lefts =
1949 #if defined(APP_TYPE_SIMPLE_DOS_CONSOLE)
1950 CCMALLOC_malloc(sizeof(GMP_RALG_fab_neighbor_struct) * result->n_left_in);
1951 #elif defined(APP_TYPE_IJUSCRIPTER_IJUCONSOLE)
1952 (GMP_RALG_fab_neighbor_struct *)
1953 TclpAlloc(sizeof(GMP_RALG_fab_neighbor_struct) * result->n_left_in);
1954 #else
1955 malloc(sizeof(GMP_RALG_fab_neighbor_struct) * result->n_left_in);
1956 #endif
1957 }
1958
1959 if (result->n_right_in)
1960 {
1961 result->rights =
1962 #if defined(APP_TYPE_SIMPLE_DOS_CONSOLE)
1963 CCMALLOC_malloc(sizeof(GMP_RALG_fab_neighbor_struct) * result->n_right_in);
1964 #elif defined(APP_TYPE_IJUSCRIPTER_IJUCONSOLE)
1965 (GMP_RALG_fab_neighbor_struct *)
1966 TclpAlloc(sizeof(GMP_RALG_fab_neighbor_struct) * result->n_right_in);
1967 #else
1968 malloc(sizeof(GMP_RALG_fab_neighbor_struct) * result->n_right_in);
1969 #endif
1970 }
1971
1972 //If the rational number supplied is above the corner
1973 //point, we want to form the continued fraction representation
1974 //of its reciprocal.
1975 if (result->hmax_supplied)
1976 {
1977 if (GMP_RATS_mpq_cmp(&(result->abs_norm_rn),&(result->corner_point),NULL) > 0)
1978 {
1979 GMP_RALG_cfdecomp_init(&(result->rn_abs_recip_cf_rep),
1980 &error_flag,
1981 &(result->abs_norm_rn.den),
1982 &(result->abs_norm_rn.num));
1983 result->rn_abs_recip_cf_rep_formed = 1;
1984 }
1985 }
1986
1987 //If HMAX has been supplied, we want to calculate the points just below and above
1988 //the corner point. The reason we want to do this is because we need to gracefully
1989 //"round the corner" in either direction.
1990 //
1991 //Calculate the point just to the left of the corner point.
1992 if (result->hmax_supplied)
1993 {
1994 GMP_RALG_enclosing_farey_neighbors(
1995 &(result->corner_point),
1996 &(result->kmax_in),
1997 &(result->corner_point_cf_rep),
1998 &equality_flag,
1999 &(result->corner_point_minus_one),
2000 &(q_temp1)
2001 );
2002 }
2003
2004 //Calculate the point just to the right of the corner point. This is
2005 //where HMAX is the dominant constraint. We need to find the left
2006 //Farey neighbor to the reciprocal of the corner point in the Farey
2007 //series of order HMAX, then take its reciprocal. There is the possibility
2008 //if KMAX=1 that this point will have a denominator of zero, but we
2009 //will accept that as a number here, since we should never hit it,
2010 //as it will be beyond HMAX/1.
2011 if (result->hmax_supplied)
2012 {
2013 GMP_RATS_mpq_copy(&q_temp1, &(result->corner_point));
2014 GMP_INTS_mpz_swap(&(q_temp1.num), &(q_temp1.den));
2015 GMP_RALG_enclosing_farey_neighbors(
2016 &q_temp1,
2017 &(result->hmax_in),
2018 &(result->corner_point_recip_cf_rep),
2019 &equality_flag,
2020 &(result->corner_point_plus_one),
2021 &(q_temp2)
2022 );
2023 GMP_INTS_mpz_swap(&(result->corner_point_plus_one.num), &(result->corner_point_plus_one.den));
2024 }
2025
2026 //Calculate the complement of HMAX/1. Nothing that we generate can go beyond
2027 //this to the south.
2028 if (result->hmax_supplied)
2029 {
2030 GMP_RATS_mpq_copy(&(hmax_over_one_neg), &(result->hmax_over_one));
2031 GMP_INTS_mpz_negate(&(hmax_over_one_neg.num));
2032 }
2033
2034 //Also calculate the complement of HMAX/KMAX.
2035 if (result->hmax_supplied)
2036 {
2037 GMP_RATS_mpq_copy(&(corner_point_neg), &(result->corner_point));
2038 GMP_INTS_mpz_negate(&(corner_point_neg.num));
2039 }
2040
2041 //Form the reciprocal of the absolute value of the normalized value of
2042 //the rational number in.
2043 GMP_RATS_mpq_copy(&abs_norm_recip_rn, &(result->abs_norm_rn));
2044 GMP_RATS_mpq_swap_components(&abs_norm_recip_rn);
2045
2046 //OK, now we get down to brass tacks. Iterate first to get the
2047 //left neighbors. The ordinary complexity of this is also compounded
2048 //by the fact that we must handle negative numbers as well--everything
2049 //from -HMAX/1 to HMAX/1.
2050 //
2051 //PSEUDO-CODE:
2052 // a)If the rational number to approximate is <= -HMAX/1 or there are no
2053 // left neighbors requested, terminate with no neighbors on the left.
2054 //
2055 // b)Find the right neighbor of the rational number supplied.
2056 //
2057 // c)Find the left neighbor of the rational number supplied.
2058 //
2059 // d)While (queued_count < count)
2060 //
2061 // e)Queue the left neighbor, queued_count++
2062 //
2063 // f)If (queued_count >= count), break.
2064 //
2065 // g)If (left_neighbor <= -HMAX/1), break
2066 //
2067 // h)Advance the frame one to the left.
2068 //
2069 //**************************************************************************
2070 // a)If the rational number to approximate is <= -HMAX/1 or there are no
2071 // left neighbors requested, terminate with no neighbors on the left.
2072 //**************************************************************************
2073 if ((result->hmax_supplied && GMP_RATS_mpq_cmp(&(result->norm_rn), &hmax_over_one_neg, NULL) <= 0)
2074 || (n_left_in <= 0))
2075 goto done_with_left_neighbors;
2076
2077 //**************************************************************************
2078 // b)Find the right neighbor of the rational number supplied.
2079 //**************************************************************************
2080 // c)Find the left neighbor of the rational number supplied.
2081 //**************************************************************************
2082 if (!result->hmax_supplied)
2083 {
2084 //In this case, the notion of corner point is meaningless, because
2085 //there is no constraint on H. We can just go on our merry way. Get
2086 //the two neighbors.
2087 GMP_RALG_enclosing_farey_neighbors(
2088 &(result->norm_rn),
2089 &(result->kmax_in),
2090 &(result->rn_abs_cf_rep),
2091 &equality_flag,
2092 &left_neighbor,
2093 &right_neighbor
2094 );
2095 //The enclosing Farey neighbor function is prohibited from identifying the
2096 //rational number itself as a Farey term. If the number is in the Farey
2097 //series, we must replace the right neighbor, otherwise we cannot apply
2098 //the standard recursive formulas.
2099 if (equality_flag)
2100 {
2101 GMP_RATS_mpq_copy(&right_neighbor, &(result->norm_rn));
2102 }
2103 }
2104 else if (GMP_RATS_mpq_cmp(&(result->norm_rn), &corner_point_neg, NULL) < 0)
2105 {
2106 //The rational number specified is negative and below the negative corner point.
2107 //This means that HMAX is the dominant constraint. We need to find the
2108 //neighbors in the Farey series of order HMAX, then reorder and invert, etc.
2109 GMP_RALG_enclosing_farey_neighbors(
2110 &abs_norm_recip_rn,
2111 &(result->hmax_in),
2112 &(result->rn_abs_recip_cf_rep),
2113 &equality_flag,
2114 &left_neighbor,
2115 &right_neighbor
2116 );
2117
2118 //Again, if the number specified was already in the series of interest,
2119 //we need to swap in the right neighbor.
2120 if (equality_flag)
2121 {
2122 GMP_RATS_mpq_copy(&right_neighbor, &abs_norm_recip_rn);
2123 }
2124
2125 //Take the reciprocal of both neighbors, which will put them out of order,
2126 //then negate them, which will put them back in order.
2127 GMP_RATS_mpq_swap_components(&left_neighbor);
2128 GMP_INTS_mpz_negate(&(left_neighbor.num));
2129 GMP_RATS_mpq_swap_components(&right_neighbor);
2130 GMP_INTS_mpz_negate(&(right_neighbor.num));
2131 }
2132 else if (GMP_RATS_mpq_cmp(&(result->norm_rn), &corner_point_neg, NULL) == 0)
2133 {
2134 //The rational number specified is the negative corner point. In this case
2135 //Because we can never return the corner point itself as a left neighbor,
2136 //we need to set the left value to be the negative of one past, and the right
2137 //to be the negative of the corner point.
2138 GMP_RATS_mpq_copy(&left_neighbor, &(result->corner_point_plus_one));
2139 GMP_INTS_mpz_negate(&(left_neighbor.num));
2140 GMP_RATS_mpq_copy(&right_neighbor, &(result->corner_point));
2141 GMP_INTS_mpz_negate(&(right_neighbor.num));
2142 }
2143 else if ((GMP_RATS_mpq_cmp(&(result->norm_rn), &corner_point_neg, NULL) > 0)
2144 &&
2145 (GMP_RATS_mpq_cmp(&(result->norm_rn), &(result->corner_point), NULL) < 0))
2146 {
2147 //The rational number specified is in the area dominated by the KMAX constraint
2148 //between -HMAX/KMAX and HMAX/KMAX. The ordinary Farey neighbor function will
2149 //handle this correctly. Again, we need to adjust the output if the number
2150 //is already formable, because the Farey neighbor function is prohibited from
2151 //returning the number itself as a neighbor.
2152 GMP_RALG_enclosing_farey_neighbors(
2153 &(result->norm_rn),
2154 &(result->kmax_in),
2155 &(result->rn_abs_cf_rep),
2156 &equality_flag,
2157 &left_neighbor,
2158 &right_neighbor
2159 );
2160 //The enclosing Farey neighbor function is prohibited from identifying the
2161 //rational number itself as a Farey term. If the number is in the Farey
2162 //series, we must replace the right neighbor, otherwise we cannot apply
2163 //the standard recursive formulas.
2164 if (equality_flag)
2165 {
2166 GMP_RATS_mpq_copy(&right_neighbor, &(result->norm_rn));
2167 }
2168 }
2169 else if (GMP_RATS_mpq_cmp(&(result->norm_rn), &(result->corner_point), NULL) == 0)
2170 {
2171 //The rational number specified is the corner point. In this case
2172 //because we can never return the corner point itself as a left neighbor,
2173 //we need to set the left value to be one before, and the right
2174 //to be the corner point.
2175 GMP_RATS_mpq_copy(&left_neighbor, &(result->corner_point_minus_one));
2176 GMP_RATS_mpq_copy(&right_neighbor, &(result->corner_point));
2177 }
2178 else
2179 {
2180 //The only possibility left is that the number is positive and above the
2181 //corner point where HMAX is the dominant constraint.
2182 GMP_RALG_enclosing_farey_neighbors(
2183 &abs_norm_recip_rn,
2184 &(result->hmax_in),
2185 &(result->rn_abs_recip_cf_rep),
2186 &equality_flag,
2187 &left_neighbor,
2188 &right_neighbor
2189 );
2190
2191 //Again, if the number specified was already in the series of interest,
2192 //we need to swap in the neighbor. This time, however, it must be the
2193 //left neighbor because taking the reciprocals will reverse the order.
2194 if (equality_flag)
2195 {
2196 GMP_RATS_mpq_copy(&left_neighbor, &abs_norm_recip_rn);
2197 }
2198
2199 //Take the reciprocal of both neighbors, which will put them out of order,
2200 //then swap them, which will put them back in order.
2201 GMP_RATS_mpq_swap_components(&left_neighbor);
2202 GMP_RATS_mpq_swap_components(&right_neighbor);
2203 GMP_RATS_mpq_swap(&left_neighbor, &right_neighbor);
2204 }
2205
2206 #if 0
2207 //Print out the left neighbor and right neighbor determined, for debugging.
2208 GMP_INTS_mpz_long_int_format_to_stream(stdout,
2209 &(left_neighbor.num),
2210 "left_neigh_num");
2211 GMP_INTS_mpz_long_int_format_to_stream(stdout,
2212 &(left_neighbor.den),
2213 "left_neigh_den");
2214 GMP_INTS_mpz_long_int_format_to_stream(stdout,
2215 &(right_neighbor.num),
2216 "right_neigh_num");
2217 GMP_INTS_mpz_long_int_format_to_stream(stdout,
2218 &(right_neighbor.den),
2219 "right_neigh_den");
2220 #endif
2221
2222
2223 //**************************************************************************
2224 // d)While (queued_count < count)
2225 //**************************************************************************
2226 while (result->n_left_out < result->n_left_in)
2227 {
2228 //**************************************************************************
2229 // e)Queue the left neighbor, queued_count++
2230 //**************************************************************************
2231 (result->lefts + result->n_left_out)->index = -(result->n_left_out + 1);
2232 GMP_RATS_mpq_init(&((result->lefts + result->n_left_out)->neighbor));
2233 GMP_RATS_mpq_copy(&((result->lefts + result->n_left_out)->neighbor), &left_neighbor);
2234 (result->n_left_out)++;
2235
2236 //**************************************************************************
2237 // f)If (queued_count >= count), break.
2238 //**************************************************************************
2239 //By the way, this step is to save unnecessary contortions once we've met
2240 //the quota.
2241 if (result->n_left_out >= result->n_left_in)
2242 break;
2243
2244 //**************************************************************************
2245 // g)If (left_neighbor <= -HMAX/1), break
2246 //**************************************************************************
2247 //This breaks us when we've queued the most negative number we can--can't go
2248 //further. This only applies for cases where KMAX is also specified.
2249 if (result->hmax_supplied
2250 &&
2251 GMP_RATS_mpq_cmp(&left_neighbor, &hmax_over_one_neg, NULL) <= 0)
2252 break;
2253
2254 //**************************************************************************
2255 // h)Advance the frame one to the left.
2256 //**************************************************************************
2257 //Advancing one frame to the left is a complicated affair, requiring several
2258 //subcases. We break it up into regions which are best visualized using
2259 //a graph of the integer lattice with dots for each rational number.
2260 if (!(result->hmax_supplied))
2261 {
2262 //This is the case where we're are looking only in the
2263 //Farey series.
2264 if (GMP_INTS_mpz_is_pos(&left_neighbor.num))
2265 {
2266 //In this case, the left neighbor and right neighbor
2267 //are both positive, and we can apply the standard
2268 //formulas.
2269 GMP_RALG_farey_predecessor(&q_temp1,
2270 &right_neighbor,
2271 &left_neighbor,
2272 &(result->kmax_in));
2273 GMP_RATS_mpq_copy(&right_neighbor, &left_neighbor);
2274 GMP_RATS_mpq_copy(&left_neighbor, &q_temp1);
2275 }
2276 else if (GMP_INTS_mpz_is_zero(&left_neighbor.num))
2277 {
2278 //In this case, we are making the transition from positive
2279 //to negative.
2280 GMP_INTS_mpz_set_si(&(left_neighbor.num), -1);
2281 GMP_INTS_mpz_copy(&(left_neighbor.den), &(result->kmax_in));
2282 GMP_RATS_mpq_set_si(&right_neighbor, 0, 1);
2283 }
2284 else
2285 {
2286 //Here, we are purely negative and decreasing. Need to negate
2287 //the numbers, find successor, then negate.
2288 GMP_RATS_mpq_copy(&q_temp1, &left_neighbor);
2289 GMP_RATS_mpq_copy(&q_temp2, &right_neighbor);
2290 GMP_INTS_mpz_abs(&(q_temp1.num));
2291 GMP_INTS_mpz_abs(&(q_temp2.num));
2292 GMP_RALG_farey_successor(&q_temp3,
2293 &q_temp2,
2294 &q_temp1,
2295 &(result->kmax_in));
2296 GMP_RATS_mpq_copy(&right_neighbor, &left_neighbor);
2297 GMP_RATS_mpq_copy(&left_neighbor, &q_temp3);
2298 GMP_INTS_mpz_negate(&(left_neighbor.num));
2299 }
2300 }
2301 else if (GMP_RATS_mpq_cmp(&left_neighbor, &(result->corner_point), NULL) > 0)
2302 {
2303 //We are above the top corner point. In this case HMAX is the dominant
2304 //constraint, and we find our food by taking reciprocals and applying
2305 //the standard relationships in the Farey series of order HMAX.
2306 GMP_RATS_mpq_copy(&q_temp1, &left_neighbor);
2307 GMP_RATS_mpq_copy(&q_temp2, &right_neighbor);
2308 GMP_RATS_mpq_swap_components(&q_temp1);
2309 GMP_RATS_mpq_swap_components(&q_temp2);
2310 GMP_RALG_farey_successor(&q_temp3,
2311 &q_temp2,
2312 &q_temp1,
2313 &(result->hmax_in));
2314 GMP_RATS_mpq_swap_components(&q_temp3);
2315 GMP_RATS_mpq_copy(&right_neighbor, &left_neighbor);
2316 GMP_RATS_mpq_copy(&left_neighbor, &q_temp3);
2317 }
2318 else if (GMP_RATS_mpq_cmp(&left_neighbor, &(result->corner_point), NULL) == 0)
2319 {
2320 //We are precisely at the corner point. This is where we round the corner.
2321 GMP_RATS_mpq_copy(&right_neighbor, &left_neighbor);
2322 GMP_RATS_mpq_copy(&left_neighbor, &(result->corner_point_minus_one));
2323 }
2324 else if (GMP_INTS_mpz_is_pos(&left_neighbor.num))
2325 {
2326 //In this region we are going straight down the Farey series.
2327 GMP_RALG_farey_predecessor(&q_temp1,
2328 &right_neighbor,
2329 &left_neighbor,
2330 &(result->kmax_in));
2331 GMP_RATS_mpq_copy(&right_neighbor, &left_neighbor);
2332 GMP_RATS_mpq_copy(&left_neighbor, &q_temp1);
2333 }
2334 else if (GMP_INTS_mpz_is_zero(&left_neighbor.num))
2335 {
2336 //In this case, we are making the transition from positive
2337 //to negative.
2338 GMP_INTS_mpz_set_si(&(left_neighbor.num), -1);
2339 GMP_INTS_mpz_copy(&(left_neighbor.den), &(result->kmax_in));
2340 GMP_RATS_mpq_set_si(&right_neighbor, 0, 1);
2341 }
2342 else if (GMP_RATS_mpq_cmp(&left_neighbor, &corner_point_neg, NULL) > 0)
2343 {
2344 //Here, we are purely negative and decreasing. Need to negate
2345 //the numbers, find successor, then negate.
2346 GMP_RATS_mpq_copy(&q_temp1, &left_neighbor);
2347 GMP_RATS_mpq_copy(&q_temp2, &right_neighbor);
2348 GMP_INTS_mpz_abs(&(q_temp1.num));
2349 GMP_INTS_mpz_abs(&(q_temp2.num));
2350 GMP_RALG_farey_successor(&q_temp3,
2351 &q_temp2,
2352 &q_temp1,
2353 &(result->kmax_in));
2354 GMP_RATS_mpq_copy(&right_neighbor, &left_neighbor);
2355 GMP_RATS_mpq_copy(&left_neighbor, &q_temp3);
2356 GMP_INTS_mpz_negate(&(left_neighbor.num));
2357 }
2358 else if (GMP_RATS_mpq_cmp(&left_neighbor, &corner_point_neg, NULL) == 0)
2359 {
2360 //This is where we are rounding the negative corner.
2361 GMP_RATS_mpq_copy(&right_neighbor, &left_neighbor);
2362 GMP_RATS_mpq_copy(&left_neighbor, &(result->corner_point_plus_one));
2363 GMP_INTS_mpz_negate(&(left_neighbor.num));
2364 }
2365 else
2366 {
2367 //Here we're going in the negative direction along the "bottom" of the
2368 //rectangle.
2369 GMP_RATS_mpq_copy(&q_temp1, &left_neighbor);
2370 GMP_RATS_mpq_copy(&q_temp2, &right_neighbor);
2371 GMP_INTS_mpz_abs(&(q_temp1.num));
2372 GMP_INTS_mpz_abs(&(q_temp2.num));
2373 GMP_RATS_mpq_swap_components(&q_temp1);
2374 GMP_RATS_mpq_swap_components(&q_temp2);
2375 GMP_RALG_farey_predecessor(&q_temp3,
2376 &q_temp2,
2377 &q_temp1,
2378 &(result->hmax_in));
2379 GMP_RATS_mpq_swap_components(&q_temp3);
2380 GMP_INTS_mpz_negate(&(q_temp3.num));
2381 GMP_RATS_mpq_copy(&right_neighbor, &left_neighbor);
2382 GMP_RATS_mpq_copy(&left_neighbor, &q_temp3);
2383 }
2384 }
2385
2386
2387 done_with_left_neighbors: ;
2388
2389 //**************************************************************************
2390 // a)If the rational number to approximate is >= HMAX/1 or there are no
2391 // right neighbors requested, terminate with no neighbors on the right.
2392 //**************************************************************************
2393 if ((result->hmax_supplied && GMP_RATS_mpq_cmp(&(result->norm_rn), &(result->hmax_over_one), NULL) >= 0)
2394 || (n_right_in <= 0))
2395 goto done_with_right_neighbors;
2396
2397 //**************************************************************************
2398 // b)Find the right neighbor of the rational number supplied.
2399 //**************************************************************************
2400 // c)Find the left neighbor of the rational number supplied.
2401 //**************************************************************************
2402 if (!result->hmax_supplied)
2403 {
2404 //In this case, the notion of corner point is meaningless, because
2405 //there is no constraint on H. We can just go on our merry way. Get
2406 //the two neighbors.
2407 GMP_RALG_enclosing_farey_neighbors(
2408 &(result->norm_rn),
2409 &(result->kmax_in),
2410 &(result->rn_abs_cf_rep),
2411 &equality_flag,
2412 &left_neighbor,
2413 &right_neighbor
2414 );
2415 //The enclosing Farey neighbor function is prohibited from identifying the
2416 //rational number itself as a Farey term. If the number is in the Farey
2417 //series, we must replace the left neighbor, otherwise we cannot apply
2418 //the standard recursive formulas.
2419 if (equality_flag)
2420 {
2421 GMP_RATS_mpq_copy(&left_neighbor, &(result->norm_rn));
2422 }
2423 }
2424 else if (GMP_RATS_mpq_cmp(&(result->norm_rn), &corner_point_neg, NULL) < 0)
2425 {
2426 //The rational number specified is negative and below the negative corner point.
2427 //This means that HMAX is the dominant constraint. We need to find the
2428 //neighbors in the Farey series of order HMAX, then reorder and invert, etc.
2429 GMP_RALG_enclosing_farey_neighbors(
2430 &abs_norm_recip_rn,
2431 &(result->hmax_in),
2432 &(result->rn_abs_recip_cf_rep),
2433 &equality_flag,
2434 &left_neighbor,
2435 &right_neighbor
2436 );
2437
2438 //Again, if the number specified was already in the series of interest,
2439 //we need to swap in the left neighbor.
2440 if (equality_flag)
2441 {
2442 GMP_RATS_mpq_copy(&left_neighbor, &abs_norm_recip_rn);
2443 }
2444
2445 //Take the reciprocal of both neighbors, which will put them out of order,
2446 //then negate them, which will put them back in order.
2447 GMP_RATS_mpq_swap_components(&left_neighbor);
2448 GMP_INTS_mpz_negate(&(left_neighbor.num));
2449 GMP_RATS_mpq_swap_components(&right_neighbor);
2450 GMP_INTS_mpz_negate(&(right_neighbor.num));
2451 }
2452 else if (GMP_RATS_mpq_cmp(&(result->norm_rn), &corner_point_neg, NULL) == 0)
2453 {
2454 //The rational number specified is the negative corner point. In this case
2455 //Because we can never return the corner point itself as a left neighbor,
2456 //we need to set the right value to be the negative of one before, and the left
2457 //to be the negative of the corner point.
2458 GMP_RATS_mpq_copy(&left_neighbor, &(result->corner_point));
2459 GMP_INTS_mpz_negate(&(left_neighbor.num));
2460 GMP_RATS_mpq_copy(&right_neighbor, &(result->corner_point_minus_one));
2461 GMP_INTS_mpz_negate(&(right_neighbor.num));
2462 }
2463 else if ((GMP_RATS_mpq_cmp(&(result->norm_rn), &corner_point_neg, NULL) > 0)
2464 &&
2465 (GMP_RATS_mpq_cmp(&(result->norm_rn), &(result->corner_point), NULL) < 0))
2466 {
2467 //The rational number specified is in the area dominated by the KMAX constraint
2468 //between -HMAX/KMAX and HMAX/KMAX. The ordinary Farey neighbor function will
2469 //handle this correctly. Again, we need to adjust the output if the number
2470 //is already formable, because the Farey neighbor function is prohibited from
2471 //returning the number itself as a neighbor.
2472 GMP_RALG_enclosing_farey_neighbors(
2473 &(result->norm_rn),
2474 &(result->kmax_in),
2475 &(result->rn_abs_cf_rep),
2476 &equality_flag,
2477 &left_neighbor,
2478 &right_neighbor
2479 );
2480 //The enclosing Farey neighbor function is prohibited from identifying the
2481 //rational number itself as a Farey term. If the number is in the Farey
2482 //series, we must replace the left neighbor, otherwise we cannot apply
2483 //the standard recursive formulas.
2484 if (equality_flag)
2485 {
2486 GMP_RATS_mpq_copy(&left_neighbor, &(result->norm_rn));
2487 }
2488 }
2489 else if (GMP_RATS_mpq_cmp(&(result->norm_rn), &(result->corner_point), NULL) == 0)
2490 {
2491 //The rational number specified is the positive corner point. In this case.
2492 //because we can never return the corner point itself as a right neighbor,
2493 //we need to set the right value to be one after, and the left
2494 //to be the corner point.
2495 GMP_RATS_mpq_copy(&left_neighbor, &(result->corner_point));
2496 GMP_RATS_mpq_copy(&right_neighbor, &(result->corner_point_plus_one));
2497 }
2498 else
2499 {
2500 //The only possibility left is that the number is positive and at or above the
2501 //corner point where HMAX is the dominant constraint.
2502 GMP_RALG_enclosing_farey_neighbors(
2503 &abs_norm_recip_rn,
2504 &(result->hmax_in),
2505 &(result->rn_abs_recip_cf_rep),
2506 &equality_flag,
2507 &left_neighbor,
2508 &right_neighbor
2509 );
2510
2511 //Again, if the number specified was already in the series of interest,
2512 //we need to swap in the neighbor. This time, however, it must be the
2513 //right neighbor because taking the reciprocals will reverse the order.
2514 if (equality_flag)
2515 {
2516 GMP_RATS_mpq_copy(&right_neighbor, &abs_norm_recip_rn);
2517 }
2518
2519 //Take the reciprocal of both neighbors, which will put them out of order,
2520 //then swap them, which will put them back in order.
2521 GMP_RATS_mpq_swap_components(&left_neighbor);
2522 GMP_RATS_mpq_swap_components(&right_neighbor);
2523 GMP_RATS_mpq_swap(&left_neighbor, &right_neighbor);
2524 }
2525
2526 #if 0
2527 //Print out the left neighbor and right neighbor determined, for debugging.
2528 GMP_INTS_mpz_long_int_format_to_stream(stdout,
2529 &(left_neighbor.num),
2530 "left_neigh_num");
2531 GMP_INTS_mpz_long_int_format_to_stream(stdout,
2532 &(left_neighbor.den),
2533 "left_neigh_den");
2534 GMP_INTS_mpz_long_int_format_to_stream(stdout,
2535 &(right_neighbor.num),
2536 "right_neigh_num");
2537 GMP_INTS_mpz_long_int_format_to_stream(stdout,
2538 &(right_neighbor.den),
2539 "right_neigh_den");
2540 #endif
2541
2542
2543 //**************************************************************************
2544 // d)While (queued_count < count)
2545 //**************************************************************************
2546 while (result->n_right_out < result->n_right_in)
2547 {
2548 //**************************************************************************
2549 // e)Queue the right neighbor, queued_count++
2550 //**************************************************************************
2551 (result->rights + result->n_right_out)->index = (result->n_right_out + 1);
2552 GMP_RATS_mpq_init(&((result->rights + result->n_right_out)->neighbor));
2553 GMP_RATS_mpq_copy(&((result->rights + result->n_right_out)->neighbor), &right_neighbor);
2554 (result->n_right_out)++;
2555
2556 //**************************************************************************
2557 // f)If (queued_count >= count), break.
2558 //**************************************************************************
2559 //By the way, this step is to save unnecessary contortions once we've met
2560 //the quota.
2561 if (result->n_right_out >= result->n_right_in)
2562 break;
2563
2564 //**************************************************************************
2565 // g)If (right_neighbor >= HMAX/1), break
2566 //**************************************************************************
2567 //This breaks us when we've queued the most positive number we can--can't go
2568 //further. This only applies for cases where KMAX is also specified.
2569 if (result->hmax_supplied
2570 &&
2571 GMP_RATS_mpq_cmp(&right_neighbor, &(result->hmax_over_one), NULL) >= 0)
2572 break;
2573
2574 //**************************************************************************
2575 // h)Advance the frame one to the right.
2576 //**************************************************************************
2577 //Advancing one frame to the right is a complicated affair, requiring several
2578 //subcases. We break it up into regions which are best visualized using
2579 //a graph of the integer lattice with dots for each rational number.
2580 if (!(result->hmax_supplied))
2581 {
2582 //This is the case where we're are looking only in the
2583 //Farey series.
2584 if (GMP_INTS_mpz_is_neg(&right_neighbor.num))
2585 {
2586 //Neg and increasing towards zero. Can handle by symmetry.
2587 GMP_RATS_mpq_copy(&q_temp1, &left_neighbor);
2588 GMP_RATS_mpq_copy(&q_temp2, &right_neighbor);
2589 GMP_INTS_mpz_abs(&(q_temp1.num));
2590 GMP_INTS_mpz_abs(&(q_temp2.num));
2591 GMP_RALG_farey_predecessor(&q_temp3,
2592 &q_temp1,
2593 &q_temp2,
2594 &(result->kmax_in));
2595 GMP_RATS_mpq_copy(&left_neighbor, &right_neighbor);
2596 GMP_RATS_mpq_copy(&right_neighbor, &q_temp3);
2597 GMP_INTS_mpz_negate(&(right_neighbor.num));
2598 }
2599 else if (GMP_INTS_mpz_is_zero(&right_neighbor.num))
2600 {
2601 //Right term just hit zero and are increasing.
2602 //Left will become 0/1, right becomes 1/KMAX.
2603 GMP_RATS_mpq_set_si(&left_neighbor, 0, 1);
2604 GMP_INTS_mpz_set_si(&(right_neighbor.num), 1);
2605 GMP_INTS_mpz_copy(&(right_neighbor.den), &(result->kmax_in));
2606 }
2607 else
2608 {
2609 //Are above zero and increasing. Can use standard Farey
2610 //successor formula.
2611 GMP_RALG_farey_successor(&q_temp1,
2612 &left_neighbor,
2613 &right_neighbor,
2614 &(result->kmax_in));
2615 GMP_RATS_mpq_copy(&left_neighbor, &right_neighbor);
2616 GMP_RATS_mpq_copy(&right_neighbor, &q_temp1);
2617 }
2618 }
2619 else if (GMP_RATS_mpq_cmp(&right_neighbor, &corner_point_neg, NULL) < 0)
2620 {
2621 //We are below the negative corner point and moving towards
2622 //zero, with HMAX the dominant constraint. We can proceed by
2623 //symmetry, producing a Farey successor and negating and inverting.
2624 GMP_RATS_mpq_copy(&q_temp1, &left_neighbor);
2625 GMP_RATS_mpq_copy(&q_temp2, &right_neighbor);
2626 GMP_INTS_mpz_abs(&(q_temp1.num));
2627 GMP_INTS_mpz_abs(&(q_temp2.num));
2628 GMP_RATS_mpq_swap_components(&q_temp1);
2629 GMP_RATS_mpq_swap_components(&q_temp2);
2630 GMP_RALG_farey_successor(&q_temp3,
2631 &q_temp1,
2632 &q_temp2,
2633 &(result->hmax_in));
2634 GMP_RATS_mpq_swap_components(&q_temp3);
2635 GMP_INTS_mpz_negate(&(q_temp3.num));
2636 GMP_RATS_mpq_copy(&left_neighbor, &right_neighbor);
2637 GMP_RATS_mpq_copy(&right_neighbor, &q_temp3);
2638 }
2639 else if (GMP_RATS_mpq_cmp(&right_neighbor, &corner_point_neg, NULL) == 0)
2640 {
2641 //We are at the bottom negative corner point and need to "round the corner".
2642 GMP_RATS_mpq_copy(&left_neighbor, &right_neighbor);
2643 GMP_RATS_mpq_copy(&right_neighbor, &(result->corner_point_minus_one));
2644 GMP_INTS_mpz_negate(&(right_neighbor.num));
2645 }
2646 else if (GMP_INTS_mpz_is_neg(&right_neighbor.num))
2647 {
2648 //In this region we are going straight up the Farey series approaching
2649 //zero. Need to negate to use standard relationships.
2650 GMP_RATS_mpq_copy(&q_temp1, &left_neighbor);
2651 GMP_RATS_mpq_copy(&q_temp2, &right_neighbor);
2652 GMP_INTS_mpz_abs(&(q_temp1.num));
2653 GMP_INTS_mpz_abs(&(q_temp2.num));
2654 GMP_RALG_farey_predecessor(&q_temp3,
2655 &q_temp1,
2656 &q_temp2,
2657 &(result->kmax_in));
2658 GMP_RATS_mpq_copy(&left_neighbor, &right_neighbor);
2659 GMP_RATS_mpq_copy(&right_neighbor, &q_temp3);
2660 GMP_INTS_mpz_negate(&(right_neighbor.num));
2661 }
2662 else if (GMP_INTS_mpz_is_zero(&right_neighbor.num))
2663 {
2664 //Zero crossover.
2665 GMP_RATS_mpq_set_si(&left_neighbor, 0, 1);
2666 GMP_INTS_mpz_set_si(&(right_neighbor.num), 1);
2667 GMP_INTS_mpz_copy(&(right_neighbor.den), &(result->kmax_in));
2668 }
2669 else if (GMP_RATS_mpq_cmp(&right_neighbor, &(result->corner_point), NULL) < 0)
2670 {
2671 //Below corner point. Standard relationship applies.
2672 GMP_RALG_farey_successor(&q_temp1,
2673 &left_neighbor,
2674 &right_neighbor,
2675 &(result->kmax_in));
2676 GMP_RATS_mpq_copy(&left_neighbor, &right_neighbor);
2677 GMP_RATS_mpq_copy(&right_neighbor, &q_temp1);
2678 }
2679 else if (GMP_RATS_mpq_cmp(&right_neighbor, &(result->corner_point), NULL) == 0)
2680 {
2681 //At the positive corner point.
2682 GMP_RATS_mpq_copy(&left_neighbor, &right_neighbor);
2683 GMP_RATS_mpq_copy(&right_neighbor, &(result->corner_point_plus_one));
2684 }
2685 else
2686 {
2687 //Above the positive corner point and heading for HMAX/1.
2688 GMP_RATS_mpq_copy(&q_temp1, &left_neighbor);
2689 GMP_RATS_mpq_copy(&q_temp2, &right_neighbor);
2690 GMP_RATS_mpq_swap_components(&q_temp1);
2691 GMP_RATS_mpq_swap_components(&q_temp2);
2692 GMP_RALG_farey_predecessor(&q_temp3,
2693 &q_temp1,
2694 &q_temp2,
2695 &(result->hmax_in));
2696 GMP_RATS_mpq_swap_components(&q_temp3);
2697 GMP_RATS_mpq_copy(&left_neighbor, &right_neighbor);
2698 GMP_RATS_mpq_copy(&right_neighbor, &q_temp3);
2699 }
2700 }
2701
2702 done_with_right_neighbors: ;
2703
2704 //This is a single return point so we catch all the dynamic memory
2705 //deallocation.
2706 return_point:
2707 GMP_RATS_mpq_clear(&q_temp1);
2708 GMP_RATS_mpq_clear(&q_temp2);
2709 GMP_RATS_mpq_clear(&q_temp3);
2710 GMP_RATS_mpq_clear(&q_temp4);
2711 GMP_RATS_mpq_clear(&left_neighbor);
2712 GMP_RATS_mpq_clear(&right_neighbor);
2713 GMP_RATS_mpq_clear(&left_neighbor_abs);
2714 GMP_RATS_mpq_clear(&right_neighbor_abs);
2715 GMP_RATS_mpq_clear(&hmax_over_one_neg);
2716 GMP_RATS_mpq_clear(&corner_point_neg);
2717 GMP_RATS_mpq_clear(&abs_norm_recip_rn);
2718 }
2719
2720
2721 //08/16/01: Visual inspection OK.
2722 void GMP_RALG_consecutive_fab_terms_result_free(
2723 GMP_RALG_fab_neighbor_collection_struct *arg
2724 )
2725 {
2726 int i;
2727
2728 //Eyeball the input.
2729 assert(arg != NULL);
2730
2731 //Deallocate all rational numbers and integers that MUST be allocated, i.e. they are
2732 //never conditional.
2733 GMP_RATS_mpq_clear(&(arg->rn_in));
2734 GMP_INTS_mpz_clear(&(arg->kmax_in));
2735 GMP_INTS_mpz_clear(&(arg->hmax_in));
2736 GMP_RATS_mpq_clear(&(arg->hmax_over_one));
2737 GMP_RATS_mpq_clear(&(arg->corner_point));
2738 GMP_RATS_mpq_clear(&(arg->corner_point_minus_one));
2739 GMP_RATS_mpq_clear(&(arg->corner_point_plus_one));
2740 GMP_RATS_mpq_clear(&(arg->norm_rn));
2741 GMP_RATS_mpq_clear(&(arg->abs_norm_rn));
2742
2743 //Destroy any continued fraction representations that were
2744 //formed.
2745 if (arg->rn_abs_cf_rep_formed)
2746 {
2747 GMP_RALG_cfdecomp_destroy(&(arg->rn_abs_cf_rep));
2748 }
2749 if (arg->rn_abs_recip_cf_rep_formed)
2750 {
2751 GMP_RALG_cfdecomp_destroy(&(arg->rn_abs_recip_cf_rep));
2752 }
2753 if(arg->corner_point_cf_rep_formed)
2754 {
2755 GMP_RALG_cfdecomp_destroy(&(arg->corner_point_cf_rep));
2756 }
2757 if(arg->corner_point_recip_cf_rep_formed)
2758 {
2759 GMP_RALG_cfdecomp_destroy(&(arg->corner_point_recip_cf_rep));
2760 }
2761
2762 //Walk through the lefts, freeing up any allocated rational numbers.
2763 for (i=0; i < arg->n_left_out; i++)
2764 {
2765 GMP_RATS_mpq_clear(&(arg->lefts[i].neighbor));
2766 }
2767
2768 //Walk through the rights, freeing up any allocated rational numbers.
2769 for (i=0; i < arg->n_right_out; i++)
2770 {
2771 GMP_RATS_mpq_clear(&(arg->rights[i].neighbor));
2772 }
2773
2774 //Deallocate any area assigned for lefts.
2775 if (arg->lefts)
2776 {
2777 #if defined(APP_TYPE_SIMPLE_DOS_CONSOLE)
2778 CCMALLOC_free(arg->lefts);
2779 #elif defined(APP_TYPE_IJUSCRIPTER_IJUCONSOLE)
2780 TclpFree((char *)arg->lefts);
2781 #else
2782 free(arg->lefts);
2783 #endif
2784
2785 arg->lefts = NULL;
2786 }
2787
2788 //Deallocate any area assigned for rights.
2789 if (arg->rights)
2790 {
2791 #if defined(APP_TYPE_SIMPLE_DOS_CONSOLE)
2792 CCMALLOC_free(arg->rights);
2793 #elif defined(APP_TYPE_IJUSCRIPTER_IJUCONSOLE)
2794 TclpFree((char *)arg->rights);
2795 #else
2796 free(arg->rights);
2797 #endif
2798
2799 arg->rights = NULL;
2800 }
2801 }
2802
2803
2804 //08/16/01: Visual inspection OK.
2805 void GMP_RALG_consecutive_fab_terms_result_dump(
2806 FILE *s,
2807 GMP_RALG_fab_neighbor_collection_struct *arg
2808 )
2809 {
2810 int i;
2811 char buf[250];
2812
2813 //Eyeball the input parameters.
2814 assert(s != NULL);
2815 assert(arg != NULL);
2816
2817 //Announce intent.
2818 FCMIOF_stream_bannerheading(s,
2819 "Emitting Neighbor Decomp For Analysis",
2820 1);
2821
2822 //Dump the fields, in order.
2823 GMP_INTS_mpz_long_int_format_to_stream(s,
2824 &(arg->rn_in.num),
2825 "rn_in_num");
2826 GMP_INTS_mpz_long_int_format_to_stream(s,
2827 &(arg->rn_in.den),
2828 "rn_in_den");
2829 GMP_INTS_mpz_long_int_format_to_stream(s,
2830 &(arg->kmax_in),
2831 "kmax_in");
2832 fprintf(s, " hmax_supplied: %12d\n", arg->hmax_supplied);
2833 GMP_INTS_mpz_long_int_format_to_stream(s,
2834 &(arg->hmax_in),
2835 "hmax_in");
2836 if (arg->error)
2837 {
2838 fprintf(s, " error: %s\n", arg->error);
2839 }
2840 else
2841 {
2842 fprintf(s, " error: NULL\n");
2843 }
2844
2845 GMP_INTS_mpz_long_int_format_to_stream(s,
2846 &(arg->corner_point.num),
2847 "corner_point_num");
2848 GMP_INTS_mpz_long_int_format_to_stream(s,
2849 &(arg->corner_point.den),
2850 "corner_point_den");
2851
2852 GMP_INTS_mpz_long_int_format_to_stream(s,
2853 &(arg->corner_point_minus_one.num),
2854 "cor_pt_minus_one_num");
2855 GMP_INTS_mpz_long_int_format_to_stream(s,
2856 &(arg->corner_point_minus_one.den),
2857 "cor_pt_minus_one_den");
2858
2859 GMP_INTS_mpz_long_int_format_to_stream(s,
2860 &(arg->corner_point_plus_one.num),
2861 "cor_pt_plus_one_num");
2862 GMP_INTS_mpz_long_int_format_to_stream(s,
2863 &(arg->corner_point_plus_one.den),
2864 "cor_pt_plus_one_den");
2865
2866 GMP_INTS_mpz_long_int_format_to_stream(s,
2867 &(arg->hmax_over_one.num),
2868 "hmax/1_num");
2869 GMP_INTS_mpz_long_int_format_to_stream(s,
2870 &(arg->hmax_over_one.den),
2871 "hmax/1_den");
2872
2873 GMP_INTS_mpz_long_int_format_to_stream(s,
2874 &(arg->norm_rn.num),
2875 "norm_rn_num");
2876 GMP_INTS_mpz_long_int_format_to_stream(s,
2877 &(arg->norm_rn.den),
2878 "norm_rn_den");
2879
2880 GMP_INTS_mpz_long_int_format_to_stream(s,
2881 &(arg->abs_norm_rn.num),
2882 "abs_norm_rn_num");
2883 GMP_INTS_mpz_long_int_format_to_stream(s,
2884 &(arg->abs_norm_rn.den),
2885 "abs_norm_rn_den");
2886
2887 fprintf(s, " rn_is_neg: %12d\n", arg->rn_is_neg);
2888
2889 fprintf(s, " n_left_in: %12d\n", arg->n_left_in);
2890
2891 fprintf(s, " n_right_in: %12d\n", arg->n_right_in);
2892
2893 fprintf(s, "rn_abs_cf_rep_formed: %12d\n", arg->rn_abs_cf_rep_formed);
2894
2895 if (arg->rn_abs_cf_rep_formed)
2896 {
2897 GMP_RALG_cfdecomp_emit(s, "Abs Of RN In CF Decomp", &(arg->rn_abs_cf_rep), 0, 0, NULL);
2898 }
2899
2900 fprintf(s, "rn_abs_recip_cf_rep_formed: %12d\n", arg->rn_abs_recip_cf_rep_formed);
2901
2902 if (arg->rn_abs_recip_cf_rep_formed)
2903 {
2904 GMP_RALG_cfdecomp_emit(s, "Abs Of Recip Of RN In CF Decomp", &(arg->rn_abs_recip_cf_rep), 0, 0, NULL);
2905 }
2906
2907 fprintf(s, "corner_point_cf_rep_formed: %12d\n", arg->corner_point_cf_rep_formed);
2908
2909 if (arg->corner_point_cf_rep_formed)
2910 {
2911 GMP_RALG_cfdecomp_emit(s, "Corner Point CF Decomp", &(arg->corner_point_cf_rep), 0, 0, NULL);
2912 }
2913
2914 fprintf(s, "cor_pt_recip_cf_rep_formed: %12d\n", arg->corner_point_recip_cf_rep_formed);
2915
2916 if (arg->corner_point_recip_cf_rep_formed)
2917 {
2918 GMP_RALG_cfdecomp_emit(s, "Corner Point Recip CF Decomp", &(arg->corner_point_recip_cf_rep), 0, 0, NULL);
2919 }
2920
2921 fprintf(s, " equality: %12d\n", arg->equality);
2922
2923 fprintf(s, " n_left_out: %12d\n", arg->n_left_out);
2924
2925 fprintf(s, " n_right_out: %12d\n", arg->n_right_out);
2926
2927 for (i=0; i < arg->n_left_out; i++)
2928 {
2929 sprintf(buf, "Contents Of Left Neighbor Array [%d]", i);
2930 FCMIOF_stream_bannerheading(s,
2931 buf,
2932 0);
2933 fprintf(s, " index: %12d\n", arg->lefts[i].index);
2934 GMP_INTS_mpz_long_int_format_to_stream(s,
2935 &(arg->lefts[i].neighbor.num),
2936 "neighbor_num");
2937 GMP_INTS_mpz_long_int_format_to_stream(s,
2938 &(arg->lefts[i].neighbor.den),
2939 "neighbor_den");
2940 }
2941
2942 for (i=0; i < arg->n_right_out; i++)
2943 {
2944 sprintf(buf, "Contents Of Right Neighbor Array [%d]", i);
2945 FCMIOF_stream_bannerheading(s,
2946 buf,
2947 0);
2948 fprintf(s, " index: %12d\n", arg->rights[i].index);
2949 GMP_INTS_mpz_long_int_format_to_stream(s,
2950 &(arg->rights[i].neighbor.num),
2951 "neighbor_num");
2952 GMP_INTS_mpz_long_int_format_to_stream(s,
2953 &(arg->rights[i].neighbor.den),
2954 "neighbor_den");
2955 }
2956
2957 FCMIOF_stream_hline(s);
2958 }
2959
2960
2961 /******************************************************************/
2962 /*** VERSION CONTROL REPORTING FUNCTIONS ************************/
2963 /******************************************************************/
2964
2965 //08/16/01: Visual inspection OK.
2966 const char *GMP_RALG_cvcinfo(void)
2967 {
2968 return("$Header: /cvsroot/esrg/sfesrg/esrgpcpj/shared/c_datd/gmp_ralg.c,v 1.10 2002/01/27 17:58:15 dtashley Exp $");
2969 }
2970
2971
2972 //08/16/01: Visual inspection OK.
2973 const char *GMP_RALG_hvcinfo(void)
2974 {
2975 return(GMP_RALG_H_VERSION);
2976 }
2977
2978
2979 //**************************************************************************
2980 // $Log: gmp_ralg.c,v $
2981 // Revision 1.10 2002/01/27 17:58:15 dtashley
2982 // CRC32, other programs modified to work under new directory structure.
2983 //
2984 // Revision 1.9 2001/08/18 18:33:13 dtashley
2985 // Preparing for release of v1.05.
2986 //
2987 // Revision 1.8 2001/08/16 19:49:40 dtashley
2988 // Beginning to prepare for v1.05 release.
2989 //
2990 // Revision 1.7 2001/08/15 06:56:05 dtashley
2991 // Substantial progress. Safety check-in.
2992 //
2993 // Revision 1.6 2001/08/12 10:20:58 dtashley
2994 // Safety check-in. Substantial progress.
2995 //
2996 // Revision 1.5 2001/08/07 10:42:48 dtashley
2997 // Completion of CFRATNUM extensions and DOS command-line utility.
2998 //
2999 // Revision 1.4 2001/07/13 21:02:20 dtashley
3000 // Version control reporting changes.
3001 //
3002 // Revision 1.3 2001/07/13 20:44:42 dtashley
3003 // Changes, CVS keyword expansion test.
3004 //
3005 // Revision 1.2 2001/07/13 00:57:08 dtashley
3006 // Safety check-in. Substantial progress on port.
3007 //
3008 // Revision 1.1 2001/07/12 05:42:06 dtashley
3009 // Initial checkin.
3010 //
3011 //**************************************************************************
3012 // End of GMP_RALG.C.

dashley@gmail.com
ViewVC Help
Powered by ViewVC 1.1.25