polylog
general polylogarithm function
Calling Sequence
Parameters
Description
Examples
References
polylog(a, z)
a
-
expression
z
The polylogarithm of index a at the point z is defined by
polylog⁡a,z=∑n=1∞znna
if z<1 and by analytic continuation otherwise. The index a can be any complex number. If ℜ⁡a≤1, the point z=1 is a singularity.
For all indices a, the point z=1 is a branch point for all branches, and in Maple, the branch cut is taken to be the interval (1,∞). For the branches other than the principal branch (which is given on the unit disk by the series above, and hence is analytic at 0), the point z=0 is also a branch point, and the branch cut is taken to be the negative real axis. The formula for a particular branch can be determined with the following rules:
Each time the branch cut (1,∞) is crossed in the counterclockwise direction, subtract 2⁢I⁢π⁢ln⁡za−1Γ⁡a. Add this quantity if the branch cut is crossed in the clockwise direction.
Each time the branch cut (−∞,0) is crossed in the counterclockwise direction, add 2⁢I⁢π to each ln⁡z term in the current formula. Subtract this quantity if the branch cut is crossed in the clockwise direction.
For example, if one traverses a path which starts at z=12, goes clockwise around z=1, then counterclockwise around z=0, then clockwise around z=1 again to return at z=12, the formula for the branch of polylog thus obtained would be
polylog⁡a,z+2⁢I⁢π⁢ln⁡za−1+ln⁡z+2⁢I⁢πa−1Γ⁡a
where polylog(a, z) indicates the principal branch and ln⁡z means the principal branch of the logarithm.
Maple only evaluates the principal branch.
Maple's dilog function is related to polylog by the relation dilog⁡z=polylog⁡2,1−z.
polylog⁡a,0
0
polylog⁡2,1
π26
polylog⁡3,1
ζ⁡3
polylog⁡2,I
−π248+I⁢Catalan
diff⁡polylog⁡a,x,x
polylog⁡a−1,xx
combine⁡polylog⁡a,x+polylog⁡a,−x,polylog
21−a⁢polylog⁡a,x2
polylog⁡4,x+polylog⁡4,1x
combine⁡,polylogassuming1<x
−ln⁡−x2⁢π212−7⁢π4360−ln⁡−x424
combine⁡,polylogassumingx::RealRange⁡−1,1
−ln⁡−1x2⁢π212−7⁢π4360−ln⁡−1x424
polylog⁡a,z5
expand⁡
5a⁢polylog⁡a,−125⁢z5+5a⁢polylog⁡a,−145⁢z5+5a⁢polylog⁡a,−−115⁢z5+5a⁢polylog⁡a,−−135⁢z5+5a⁢polylog⁡a,z5
x≔x:
polylog⁡1,x
−ln⁡1−x
polylog⁡2,13
evalf⁡
0.3662132299
polylog⁡−3.7+2.2⁢I,1.5+2.7⁢I
−188.9091729+104.0046999⁢I
Lewin, L. Polylogarithms and Associated Functions. Amsterdam: North Holland, 1981.
See Also
assume
combine/polylog
diff
dilog
evalf
expand
GeneralizedPolylog
initialfunctions
MultiPolylog
RealRange
Download Help Document