Maple Professional
Maple Academic
Maple Student Edition
Maple Personal Edition
Maple Player
Maple Player for iPad
MapleSim Professional
MapleSim Academic
Maple T.A. - Testing & Assessment
Maple T.A. MAA Placement Test Suite
Möbius - Online Courseware
Machine Design / Industrial Automation
Aerospace
Vehicle Engineering
Robotics
Power Industries
System Simulation and Analysis
Model development for HIL
Plant Modeling for Control Design
Robotics/Motion Control/Mechatronics
Other Application Areas
Mathematics Education
Engineering Education
High Schools & Two-Year Colleges
Testing & Assessment
Students
Financial Modeling
Operations Research
High Performance Computing
Physics
Live Webinars
Recorded Webinars
Upcoming Events
MaplePrimes
Maplesoft Blog
Maplesoft Membership
Maple Ambassador Program
MapleCloud
Technical Whitepapers
E-Mail Newsletters
Maple Books
Math Matters
Application Center
MapleSim Model Gallery
User Case Studies
Exploring Engineering Fundamentals
Teaching Concepts with Maple
Maplesoft Welcome Center
Teacher Resource Center
Student Help Center
convert/fullparfrac - convert a rational expression to full partial fraction form
Calling Sequence
convert(f, fullparfrac)
convert(f, fullparfrac, x)
convert(f, fullparfrac, methext)
convert(f, fullparfrac, x, methext)
convert(f, fullparfrac, ratflag)
convert(f, fullparfrac, x, ratflag)
convert(f, fullparfrac, methext, ratflag)
convert(f, fullparfrac, x, methext, ratflag)
Parameters
f
-
rational function in x
x
main variable name
methext
(optional); method (normal, sqrfree, or factor) or an extension
ratflag
(optional); flag that alters the form of the output
Description
Convert to fullparfrac performs a partial fraction decomposition of the rational function f in the variable x after completely factoring the denominator into linear factors over its splitting field.
If no x is provided, parfrac attempts to determine a suitable x, and proceeds if the operation is not ambiguous. For example, an expression that is a rational polynomial in both and requires that the variable be specified.
Optionally, the methext parameter can be one of 'normal', 'sqrfree', 'factor' (the default) or a field extension. In the first three cases, the associated function is applied to the denominator(s), and in the last case, factoring over that field extension is applied. The 'normal' and 'sqrfree' options are very efficient, although the answer often contains reducible RootOfs. Factoring eliminates this problem but at a high computational cost, and also at the cost of not always producing the simplest output form.
Optionally, the ratflag parameter is a boolean flag indicating if rational expressions in terms of the roots of the irreducible RootOfs should be rationalized to polynomial functions. By default, this rationalization is performed when the denominator of f contains only x. If additional unknowns are present in the denominator, then this rationalization is not performed.
The default can be overridden by using the environment variable . If set to true, rationalization is performed by default, and if set to false it will not. This is most useful when fullparfrac is being called from another routine over which you have no control (see the final example below).
Warning: If the coefficients of the function f contain parameters, then there will be values for those parameters for which the decomposition is erroneous, as a symbolic splitting field is valid only for generic values of the parameter. This is known as the specialization problem.
Examples
In the following example, 'x' and 'a' appear in the denominator, so x must be specified.
Not specifying x results in an error:
Error, (in `convert/fullparfrac`) the variable name (for conversion to partial fractions) must be provided
You can request rationalization via:
In the following example, 'x' is the only variable in the denominator, so rationalization is performed.
To disable rationalization, use the false option.
or
As a final example, you can control the behavior of fullparfrac when used in other functions.
See Also
convert, convert[parfrac]
Download Help Document